PdfMergeSignRequestor - 범위 지정, 전역

PdfMergeSignRequestor API는 PDF 문서에 서명을 나타내는 이미지를 추가합니다.

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

이 메서드는 PDFGenerationAPI를 사용하여 PDF에서 구현할 수 있는 서명 개체를 만듭니다.

PdfMergeSignRequestor - PdfMergeSignRequestor()

새 PdfMergeSignRequestor 개체를 인스턴스화합니다.

표 1. 매개변수

이름	유형	설명
없음

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

var v = new sn_pdfgeneratorutils.PdfMergeSignRequestor;

PdfMergeSignRequestor - addSignatureMapping(숫자 pageNumber, 숫자 leftMargin, 숫자 topMargin, 숫자 boxWidth, 숫자 boxHeight, 문자열 sysId)

PDF에서 서명 크기 및 위치 요구 사항을 지정합니다.

표 2. 매개변수

이름	유형	설명
pageNumber	번호	서명을 삽입할 페이지의 번호입니다.
왼쪽 여백	번호	서명을 삽입할 페이지의 왼쪽 여백 영역을 나타내는 포인트 값입니다.
topMargin (상단 마진)	번호	서명 이미지를 삽입할 페이지의 상단 여백 영역을 나타내는 포인트 값입니다.
박스너비	번호	서명을 포함할 상자의 너비를 나타내는 포인트 값입니다.
boxHeight	번호	서명 이미지를 포함할 상자의 높이를 나타내는 포인트의 값입니다.
sysId	문자열	첨부 파일 [sys_attachment] 테이블의 서명 이미지 Sys_id.

표 3. 반환

유형	설명
없음

다음 예제에서는 서명 매핑을 추가하는 방법을 보여 줍니다. 전체 예제를 보려면 processRequest()를 참조하십시오.

var requestor = new sn_pdfgeneratorutils.PdfMergeSignRequestor;

// For the purpose of this example, set signature sizes and page number for signature placement
var page = 2;
var leftMargin = 48;
var topMargin = 60;
var signatureWidth = 96;
var signatureHeight = 36; 

requestor.addSignatureMapping(page, leftMargin, topMargin, signatureWidth, signatureHeight, "<signatureSysId>");

PdfMergeSignRequestor - createRequest(문자열 targetSysId, 문자열 targetTable, 문자열 tableSysId, 문자열 targetFileName)

소스 및 대상 입력을 사용하여 서명 요청을 작성합니다.

표 4. 매개변수

이름	유형	설명
targetSysId	문자열	첨부 파일 [sys_attachment] 테이블의 PDF Sys_id. 이 값을 서명을 추가할 대상 PDF로 사용합니다.
targetTable	문자열	PDF가 첨부되는 기록이 들어 있는 테이블의 이름입니다. 첨부 파일 [sys_attachment] 테이블에 나열된 첨부 파일과 동일한 행에서 이 값을 찾을 수 있습니다.
tableSysId	문자열	PDF가 첨부된 기록의 Sys_id입니다. 첨부 파일 [sys_attachment] 테이블에 나열된 첨부 파일과 동일한 행에서 이 값을 찾을 수 있습니다.
targetFileName(대상파일이름)	문자열	확장명이 없는 대상 PDF의 이름입니다.

표 5. 반환

유형	설명
없음

다음 예제에서는 서명 요청을 만드는 방법을 보여 줍니다. 전체 예제를 보려면 processRequest()를 참조하십시오.

var requestor = new sn_pdfgeneratorutils.PdfMergeSignRequestor;

requestor.createRequest("<sys_id>", "tableName", "<tableSysId>", "pdfFileName");

PdfMergeSignRequestor -processRequest()

요청을 처리하고 서명을 추가합니다.

표 6. 매개변수

이름	유형	설명
없음

표 7. 반환

유형	설명
객체	성공할 경우 각 페이지의 크기를 포함하는 객체이고, 그렇지 않으면 오류 메시지입니다. { "attachment_id": "String", "message": "String", "status": "String" }
<Object>.attachment_id	요청이 성공하면 서명 및 첨부된 PDF를 sys_id. 파일이 첨부 파일 [sys_attachment] 테이블에 나열됩니다. 데이터 유형: 문자열
<Object>.메시지	가능한 값: sys_id [{0}]의 첨부 파일이 보안 검사를 통과하지 못해 요청을 진행할 수 없습니다. PDF가 바이러스 백신 검사를 통과하지 못했습니다. 서명 매핑이 지정되지 않았습니다. 이 요청을 처리할 수 없음 – addSignatureMapping() 메서드를 사용하여 서명 매핑을 제공하십시오. 요청이 성공적으로 완료되었습니다. 요청 실패입니다. 문서에 서명을 추가하는 동안 예외가 발생했습니다. 다시 확인하시기 바랍니다. 요청한 페이지가 없으므로 이 요청을 완료할 수 없습니다. 페이지 번호: &lt;페이지 번호> 데이터 유형: 문자열
<Object>.상태	작업의 성공 여부를 나타내는 상태입니다. 가능한 값: success - 작업이 성공했습니다. failure – 작업이 성공하지 못했습니다. 에서 message 상세 정보를 제공합니다. 데이터 유형: 문자열

다음 예제에서는 서명 요청을 처리하는 방법을 보여 줍니다.

var requestor = new sn_pdfgeneratorutils.PdfMergeSignRequestor;

requestor.createRequest("<sys_id>", "tableName", "<tableSysId>", pdfFileName);

// For the purpose of this example, set signature sizes and page number for signature placement
var page = 6;
var leftMargin = 40;
var topMargin = 50;
var signatureWidth = 188;
var signatureHeight = 44; 

requestor.addSignatureMapping(page, leftMargin, topMargin, signatureWidth, signatureHeight, "<signatureSysId>");

var result = requestor.processRequest();
gs.info(JSON.stringify(result));