---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 이미지 - 범위, 전역

# 이미지 - 범위, 전역 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 9분

PDF에서 이미지와 레이아웃 삽입을 나타내는 이미지 객체를 작성합니다. 배율, 정렬 및 테두리 색상과 같은 속성을 정의할 수 있습니다.

이 API는 PDF Generation Utilities 플러그인(com.snc.apppdfgenerator)의 ServiceNow 일부이며 `sn_pdfgeneratorutils` 네임스페이스 내에서 제공됩니다. 플러그인은 기본적으로 활성화되어 있습니다.

이 API는 PDF를 생성하기 위해 [문서 API](https://servicenow-prod.fluidtopics.net/1el8mFgzJVRLSfvarlrRdw#DocumentBothAPI "문서 API는 PDF를 초기화하고, 콘텐츠를 추가하고, PDF를 닫는 메서드를 제공합니다. 컨텐츠를 추가한 후에는 문서를 대상 기록에 첨부할 수 있습니다.") 와 함께 사용되는 구성요소입니다.  
다음 방법 중 하나를 사용하여 PDF에 이미지를 추가할 수 있습니다.

* [셀 -- addImage(이미지 이미지)](https://servicenow-prod.fluidtopics.net/6cLukbj~mXV_FiPZ2sRCvA#Cell-addImage_O "테이블 셀에 이미지를 추가합니다.") -- 테이블 셀에 이미지를 추가합니다.
* [테이블 -- addImageCell(이미지 이미지)](https://servicenow-prod.fluidtopics.net/ksNKv2UsdGhdPznY7o8gpw#Table-addImageCell_O "테이블에 이미지가 포함된 셀을 추가합니다.") -- 이미지가 포함된 셀을 테이블에 추가합니다.
* [문서 -- addImage(이미지 이미지)](https://servicenow-prod.fluidtopics.net/1el8mFgzJVRLSfvarlrRdw#Document-addImage_O "문서에 이미지를 추가합니다.") - 페이지에 이미지 추가
{#ImageBothAPI__ul_jkh_55q_s4b}

## 이미지 - 이미지(문자열 attachmentSysId) {#ariaid-title2}

새 이미지 객체를 인스턴스화합니다. 이미지 첨부 파일이 있고 수정할 수 있는지 확인하는 데 사용됩니다.
{#Image-Image_S__table_twm_hjk_34b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| attachmentSysId | 문자열 | 첨부 파일 \[sys_attachment\] 테이블에 있는 이미지의 Sys_id입니다. |
[표 1. 매개변수]

{#Image-Image_S__table_twm_hjk_34b}  
다음 예제에서는 Image 객체를 만드는 방법을 보여줍니다.

    var image = new sn_pdfgeneratorutils.Image("<sys_id>");

## 이미지 -- scaleAbsolute(숫자 너비, 숫자 높이) {#ariaid-title3}

이미지를 절대 너비 및 높이 크기로 비율을 조정합니다. 이 설정은 이미지의 너비-높이 비율을 유지하지 않으며 설정이 정확하지 않은 경우 원치 않는 스트레칭이 발생할 수 있습니다.
이미지의 너비-높이 비율을 유지하는 절대 크기로 크기를 조정하려면 [scaleToFit()](https://servicenow-prod.fluidtopics.net/Mq5A82_OMG9CC0XA1pyf1A#Image-scaleToFit_N_N "너비-높이 비율을 유지하면서 이미지를 절대 크기로 축소합니다.") 메서드를 사용합니다.
{#Image-scaleAbsolute_N_N__table_vv5_52h_44b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| width | 번호 | 이미지 너비(포인트)입니다. |
| height | 번호 | 이미지 높이(포인트)입니다. |
[표 2. 매개변수]

{#Image-scaleAbsolute_N_N__table_vv5_52h_44b} {#Image-scaleAbsolute_N_N__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 3. 반환]

{#Image-scaleAbsolute_N_N__table_wv5_52h_44b}  
다음 예는 절대 너비 및 높이 설정으로 PDF에 이미지를 추가하는 방법을 보여줍니다.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
    var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

    var scaleAbsPic = new sn_pdfgeneratorutils.Image("<img_sys_id>");
    scaleAbsPic.scaleAbsolute(25,50);

    document.addImage(scaleAbsPic);

    document.saveAsAttachment("incident", "<record_sys_id>", "docWithImg.pdf");

## 이미지 -- scaleToFit(Number width, Number height) {#ariaid-title4}

너비-높이 비율을 유지하면서 이미지를 절대 크기로 축소합니다.
결과 출력은 이미지 종횡비에 따라 다릅니다. 너비 및 높이 매개변수 값이 이미지 종횡비와 일치하지 않으면 하나의 값이 출력에서 지정된 값보다 작게 렌더링됩니다.
{#Image-scaleToFit_N_N__table_vv5_52h_44b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| width | 번호 | 최대 이미지 너비(포인트)입니다. |
| height | 번호 | 최대 이미지 높이(포인트)입니다. |
[표 4. 매개변수]

{#Image-scaleToFit_N_N__table_vv5_52h_44b} {#Image-scaleToFit_N_N__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 5. 반환]

{#Image-scaleToFit_N_N__table_wv5_52h_44b}  
다음 예제는 [Cell -- addImage()](https://servicenow-prod.fluidtopics.net/6cLukbj~mXV_FiPZ2sRCvA#Cell-addImage_O "테이블 셀에 이미지를 추가합니다.") 메서드를 사용하여 크기가 조정된 이미지를 삽입하는 방법을 보여줍니다.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
    var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
     
    // add a table
    var table = new sn_pdfgeneratorutils.Table([1,3],false);

    // text for the left column
    var text = "sample image";

    // add a table cell for the image in the right column
    var imgCell = new sn_pdfgeneratorutils.Cell(1, 1);

    // add an image and set it scale-to-fit
    var scaleToFitPic = new sn_pdfgeneratorutils.Image("<img_sys_id>");
    scaleToFitPic.scaleToFit(90,175);

    // add the image to the cell
    imgCell.addImage(scaleToFitPic);
     
    table.addTextCell(text);
    table.addCell(imgCell);

    // Here's a paragraph
    var para = new sn_pdfgeneratorutils.Paragraph("The following table image uses scale to fit.");

    document.addParagraph(para);
    document.addTable(table);

    document.saveAsAttachment("incident", "<record_sys_id>", "imgScaleToFit.pdf");

## 이미지 -- setAutoScale(부울 값) {#ariaid-title5}

크기를 유지하면서 페이지 또는 셀의 너비와 높이를 조정할 수 있습니다.
{#Image-setAutoScale_B__table_vv5_52h_44b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 값 | 부울 | 이미지 크기를 자동으로 조정할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 이미지 비율을 자동으로 조정합니다. * false: 이미지의 크기가 조정되지 않음 {#Image-setAutoScale_B__ul_drr_bbr_s4b} 기본값: false |
[표 6. 매개변수]

{#Image-setAutoScale_B__table_vv5_52h_44b} {#Image-setAutoScale_B__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 7. 반환]

{#Image-setAutoScale_B__table_wv5_52h_44b}  
다음 예에서는 자동 크기 조정을 사용하여 PDF에 이미지를 추가하는 방법을 보여줍니다. 이미지는 [테이블 -- addImageCell()](https://servicenow-prod.fluidtopics.net/ksNKv2UsdGhdPznY7o8gpw#Table-addImageCell_O "테이블에 이미지가 포함된 셀을 추가합니다.") 메서드를 사용하여 추가됩니다.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
    var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

    // Add a table
    var table = new sn_pdfgeneratorutils.Table([1,2],false);

    // Text in left column
    var text = "sample image";

    // Image in right column
    var autoScaledPic = new sn_pdfgeneratorutils.Image("<image_sys_id>");
    autoScaledPic.setAutoScale(true);

    table.addTextCell(text);
    table.addImageCell(autoScaledPic);

    document.addTable(table);
    document.saveAsAttachment("incident", "<record_sys_id>", "imgAutoScale.pdf");

## 이미지 -- setColoredBorder(Color color, Number width) {#ariaid-title6}

PDF에 테두리를 지정된 색상으로 설정합니다.
{#Image-setColoredBorder_O_N__table_vv5_52h_44b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 색상 | [색상](https://servicenow-prod.fluidtopics.net/HRSuYOLQ1G9IYZI~cOs__w#ColorBothAPI "PDF의 요소에 적용할 수 있는 색상 속성을 정의하는 데 사용되는 색상 객체를 만듭니다. 셀, 테이블, 줄 등이 있습니다.") | 이미지 테두리 색상입니다. |
| width | 번호 | 테두리의 너비(포인트)입니다. |
[표 8. 매개변수]

{#Image-setColoredBorder_O_N__table_vv5_52h_44b} {#Image-setColoredBorder_O_N__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 9. 반환]

{#Image-setColoredBorder_O_N__table_wv5_52h_44b}  
다음 예제에서는 이미지에 5점 빨간색 테두리를 설정하는 방법을 보여 줍니다.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
    var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

    var borderColor = new sn_pdfgeneratorutils.Color([1.0,0.0,0.0]);
     
    // declare image using sys attachment
    var image = new sn_pdfgeneratorutils.Image("<imgAttachment_sys_id>");

    image.setColoredBorder(borderColor, 5);

    document.addImage(image);
    document.saveAsAttachment("incident", "<record_sys_id>", "docWithBorderedImage.pdf");

## 이미지 -- setHorizontalAlignment(문자열 정렬) {#ariaid-title7}

이미지의 가로 맞춤을 설정합니다.
{#Image-setHorizontalAlignment_S__table_vv5_52h_44b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 정렬 | 문자열 | 페이지 또는 블록 요소에 이미지 정렬을 배치합니다. 유효한 값은 다음과 같습니다. * 중앙 * 왼쪽 * 오른쪽 {#Image-setHorizontalAlignment_S__ul_rn3_wvq_s4b} 기본값: 왼쪽 |
[표 10. 매개변수]

{#Image-setHorizontalAlignment_S__table_vv5_52h_44b} {#Image-setHorizontalAlignment_S__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 11. 반환]

{#Image-setHorizontalAlignment_S__table_wv5_52h_44b}  
다음 예는 PDF 페이지에 가운데에 있는 이미지를 추가하는 방법을 보여줍니다.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
    var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
     
    // declare image using sys attachment
    var image = new sn_pdfgeneratorutils.Image("<imgAttachment_sys_id>");

    String alignment = "Center";
    image.setHorizontalAlignment(alignment);

    document.addImage(image);
    // save pdf as attachment to target record in the Incident table
    document.saveAsAttachment("incident", "<sys_id>", "docWithImageCentered.pdf");

## 이미지 -- setNoBorder() {#ariaid-title8}

테두리가 없도록 이미지를 설정합니다.
{#Image-setNoBorder__table_vv5_52h_44b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 12. 매개변수]

{#Image-setNoBorder__table_vv5_52h_44b} {#Image-setNoBorder__table_wv5_52h_44b__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 13. 반환]

{#Image-setNoBorder__table_wv5_52h_44b}  
다음 예제에서는 테두리 없이 문서에 이미지를 추가하는 방법을 보여줍니다.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
    var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
     
    // declare image using sys attachment
    var image = new sn_pdfgeneratorutils.Image("<imgAttachment_sys_id>");

    image.setNoBorder();

    document.addImage(image);
    document.saveAsAttachment("incident", "<sys_id>", "docWithImgNoBorder.pdf");