이미지 - 범위 지정, 전역

PDF에 이미지와 해당 레이아웃 삽입을 나타내는 Image 객체를 만듭니다. 규모, 정렬 및 테두리 색상과 같은 속성을 정의할 수 있습니다.

이 API는 PDF 생성 유틸리티 플러그인(com.snc.apppdfgenerator)의 ServiceNow 일부이며 sn_pdfgeneratorutils 네임스페이스 내에서 제공됩니다. 플러그인은 기본적으로 활성화됩니다.

이 API는 PDF를 생성하기 위해 문서 API 와 함께 사용되는 구성요소입니다.

다음 방법 중 하나를 사용하여 PDF에 이미지를 추가할 수 있습니다.

• 셀 – addImage(이미지 이미지) – 테이블 셀에 이미지를 추가합니다.
• 테이블 – addImageCell(이미지 이미지) – 이미지가 포함된 셀을 테이블에 추가합니다.
• 문서 – addImage(이미지 이미지) - 페이지에 이미지를 추가합니다.

이미지 - Image(String attachmentSysId)

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

표 1. 매개변수

이름	유형	설명
attachmentSysId	문자열	첨부 파일 [sys_attachment] 테이블에 있는 이미지의 Sys_id.

다음 예제에서는 Image 개체를 만드는 방법을 보여 줍니다.

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

이미지 – scaleAbsolute(숫자, 너비, 숫자, 높이)

절대 너비 및 높이 크기로 이미지 크기를 조정합니다. 이 설정은 이미지의 너비-높이 비율을 유지하지 않으며 설정이 정확하지 않은 경우 원치 않는 스트레치가 발생할 수 있습니다.

이미지의 폭-높이 비율을 유지하는 절대 크기로 크기를 조절하려면 scaleToFit() 메서드를 사용합니다.

표 2. 매개변수

이름	유형	설명
width	번호	이미지 너비(포인트)입니다.
height	번호	이미지 높이(포인트)입니다.

표 3. 반환

유형	설명
없음

다음 예제에서는 절대 너비 및 높이 설정을 사용하여 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(숫자 너비, 숫자 높이)

너비-높이 비율을 유지하면서 이미지를 절대 크기로 조정합니다.

결과 출력은 이미지 종횡비에 따라 다릅니다. width 및 height 매개 변수 값이 이미지 종횡비와 일치하지 않으면 한 값이 지정된 값보다 작게 출력됩니다.

표 4. 매개변수

이름	유형	설명
width	번호	최대 이미지 너비(포인트)입니다.
height	번호	최대 이미지 높이(포인트)입니다.

표 5. 반환

유형	설명
없음

다음 예제에서는 Cell – addImage() 메서드를 사용하여 크기에 맞게 크기가 조정된 이미지를 삽입하는 방법을 보여 줍니다.

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(부울 값)

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

표 6. 매개변수

이름	유형	설명
값	부울	이미지 배율을 자동으로 조정할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. true: 이미지 배율을 자동으로 조정합니다. false: 이미지 크기가 조정되지 않음 기본값: false

표 7. 반환

유형	설명
없음

다음 예제에서는 자동 크기 조정을 사용하여 PDF에 이미지를 추가하는 방법을 보여 줍니다. 이미지는 Table – addImageCell() 메서드를 사용하여 추가됩니다.

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)

PDF에 지정된 색으로 테두리를 설정합니다.

표 8. 매개변수

이름	유형	설명
색상	색상	이미지 테두리 색상입니다.
width	번호	테두리의 너비(포인트)입니다.

표 9. 반환

유형	설명
없음

다음 예제에서는 이미지에 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(String alignment)

이미지의 가로 맞춤을 설정합니다.

표 10. 매개변수

이름	유형	설명
정렬	문자열	페이지 또는 블록 요소에 이미지 정렬을 배치합니다. 유효한 값은 다음과 같습니다. 센터 왼쪽 오른쪽 기본값: 왼쪽

표 11. 반환

유형	설명
없음

다음 예제에서는 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()

테두리가 없도록 이미지를 설정합니다.

표 12. 매개변수

이름	유형	설명
없음

표 13. 반환

유형	설명
없음

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

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");