---
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


---

# PdfMergeSignRequestor - 범위, 전역

# PdfMergeSignRequestor - 범위, 전역 {#ariaid-title1}

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

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

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

이 API는 [PDFGenerationAPI](https://servicenow-prod.fluidtopics.net/uUKKYMRd6X6Fz~BcOQJQYw#PDFGenerationAPIBothAPI "PDFGenerationAPI는 PDF 변환 및 PDF 필드 처리를 지원합니다.")를 사용하여 PDF에서 구현할 수 있는 서명 객체를 작성합니다.

## PdfMergeSignRequestor - PdfMergeSignRequestor() {#ariaid-title2}

새 PdfMergeSignRequestor 객체를 인스턴스화합니다.
{#PM-PdfMergeSignRequestor__table_twm_hjk_34b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 1. 매개변수]

{#PM-PdfMergeSignRequestor__table_twm_hjk_34b}  
다음 예제에서는 PdfMergeSignRequestor 개체를 만드는 방법을 보여 줍니다.

    var v = new sn_pdfgeneratorutils.PdfMergeSignRequestor;

## PdfMergeSignRequestor - addSignatureMapping(숫자 pageNumber, 숫자 leftMargin, 숫자 topMargin, 숫자 boxWidth, 숫자 boxHeight, 문자열 sysId) {#ariaid-title3}

PDF에서 서명 크기 및 위치 요구 사항을 할당합니다.
{#PM-addSignatureMapping_N_N_N_N_N_S__table_zvh_hkl_j4b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| pageNumber | 번호 | 서명을 삽입할 페이지의 번호입니다. |
| 왼쪽 여백 | 번호 | 서명을 삽입할 페이지의 왼쪽 여백 영역을 나타내는 포인트 값입니다. |
| topMargin | 번호 | 서명 이미지를 삽입할 페이지의 상단 여백 영역을 나타내는 포인트 값입니다. |
| 상자 너비 | 번호 | 서명을 포함할 상자의 너비를 나타내는 포인트 값입니다. |
| 상자 높이 | 번호 | 서명 이미지를 포함할 상자의 높이를 나타내는 포인트 값입니다. |
| sysId | 문자열 | 첨부 파일 \[sys_attachment\] 테이블에 있는 서명 이미지의 Sys_id입니다. |
[표 2. 매개변수]

{#PM-addSignatureMapping_N_N_N_N_N_S__table_zvh_hkl_j4b} {#PM-addSignatureMapping_N_N_N_N_N_S__table_awh_hkl_j4b__entry__2}

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

{#PM-addSignatureMapping_N_N_N_N_N_S__table_awh_hkl_j4b}  
다음 예시에서는 서명 매핑을 추가하는 방법을 보여줍니다. 전체 예제는 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) {#ariaid-title4}

소스 및 대상 입력으로 서명 요청을 생성합니다.
{#PM-createRequest_S_S_S_S__table_ulk_gkl_j4b__entry__3}

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

{#PM-createRequest_S_S_S_S__table_ulk_gkl_j4b} {#PM-createRequest_S_S_S_S__table_vlk_gkl_j4b__entry__2}

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

{#PM-createRequest_S_S_S_S__table_vlk_gkl_j4b}  
다음 예시에서는 서명 요청을 생성하는 방법을 보여줍니다. 전체 예제는 processRequest()를 참조하십시오.

    var requestor = new sn_pdfgeneratorutils.PdfMergeSignRequestor;

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

## PdfMergeSignRequestor - processRequest() {#ariaid-title5}

요청을 처리하고 서명을 추가합니다.
{#PM-processRequest__table_gyz_3kl_j4b__entry__3}

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

{#PM-processRequest__table_gyz_3kl_j4b} {#PM-processRequest__table_erx_h3k_34b__entry__2}{#PM-processRequest__row_pdfgen_ret_attID}

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

{#PM-processRequest__table_erx_h3k_34b}  
다음 예시에서는 서명 요청을 처리하는 방법을 보여줍니다.

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