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


---

# SVGToPDFConversionAPI - 범위, 전역

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

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

SVGToPDFConversionAPI는 PDF에 SVG를 추가하고 SVG를 PDF로 변환할 수 있는 메서드를 제공합니다.

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

[PDFGenerationAPI](https://servicenow-prod.fluidtopics.net/uUKKYMRd6X6Fz~BcOQJQYw#PDFGenerationAPIBothAPI "PDFGenerationAPI는 PDF 변환 및 PDF 필드 처리를 지원합니다.")도 참조하십시오.

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

새 SVGToPDFConversionAPI 객체를 인스턴스화합니다.
{#SV-SVGToPDFConversionAPI__table_twm_hjk_34b__entry__3}

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

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

    var v = new sn_pdfgeneratorutils.SVGToPDFConversionAPI();

## SVGToPDFConversionAPI - addSVGToPDF(문자열 svg, 문자열 inputPdfSysId, 문자열 targetTable, 문자열 targetSysId, 문자열 nameForPdf, 번호 pageNo, 숫자 x, 숫자 y, 숫자 svgImgWidth, 숫자 svgImgHeight) {#ariaid-title3}

이미지 크기와 위치 좌표가 있는 지정된 페이지의 PDF에 SVG 이미지를 추가합니다.
{#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__table_gms_ycm_j4b__entry__3}{#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__api_pdfgen_parm_fill_tableN_desc}

| 이름 | 유형 | 설명 |
|-|-|-|
| SVG | 문자열 | PDF 문서로 변환할 SVG. |
| inputPdfSysId | 문자열 | SVG로 복사본을 만들 대상 PDF의 Sys_id입니다. 대상 PDF가 첨부 파일 \[sys_attachment\] 테이블에 있습니다. |
| targetTable | 문자열 | PDF가 첨부되는 기록이 들어 있는 테이블의 이름입니다. 이 값은 첨부 파일 \[sys_attachment\] 테이블에 나열된 첨부 파일과 동일한 행에서 찾을 수 있습니다. |
| targetTableSysId | 문자열 | PDF가 첨부되는 기록의 Sys_id입니다. 이 값은 첨부 파일 \[sys_attachment\] 테이블에 나열된 첨부 파일과 동일한 행에서 찾을 수 있습니다. |
| targetTable | 문자열 | 변환된 PDF를 첨부할 테이블의 이름입니다. |
| targetTableSysId | 문자열 | 변환된 PDF를 첨부할 기록의 Sys_id입니다. |
| pdfName | 문자열 | PDF에 지정할 이름입니다. 기본값: 첨부 파일 \[sys_attachment\] 테이블에 있는 PDF의 Sys_id입니다. |
| pageNo | 번호 | 첨부된 PDF에서 SVG를 배치할 페이지 번호입니다. |
| x | 번호 | 페이지에서 SVG의 수평 위치입니다. 값은 포인트입니다. |
| y | 번호 | 페이지에서 SVG의 세로 위치입니다. 값은 포인트입니다. |
| svgImgWidth | 번호 | SVG 이미지의 너비(픽셀)입니다. |
| svgImg높이 | 번호 | SVG 이미지의 높이(픽셀)입니다. |
[표 2. 매개변수]

{#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__table_gms_ycm_j4b} {#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__table_hms_ycm_j4b__entry__2}{#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__row_svg2PDF-return-svg_attach}

| 유형 | 설명 |
|-|-|
| 객체 | SVG가 삽입된 새 PDF 첨부 파일 sys_id 포함하는 객체로, 성공하지 않으면 오류 메시지가 나타납니다. { "attachment_id": "String", "message": "String", "status": "String" } |
| \<Object\>.​attachment_id | SVG 변환에 성공하면 첨부된 PDF를 sys_id. 파일이 첨부 파일 \[sys_attachment\] 테이블에 나열됩니다. 데이터 유형: 문자열 |
| \<Object\>.메시지 | 성공 또는 오류를 확인하는 메시지입니다. 가능한 값: * PDF에 SVG 컨텐츠를 추가하지 못했습니다. * PDF에 SVG를 추가하고 새 PDF를 만드는 데 성공했습니다. * 지정된 대상 기록 \[\<tableName\> - \<targetTableSysId\>\]이(가) 없습니다. - 대상 테이블 sys_id이 제공된 테이블에 없습니다. 기록에 올바른 테이블 이름을 포함해야 합니다. * SVG 컨텐츠를 추가할 입력 PDF 첨부 파일 시스템 ID가 null입니다. * 입력 SVG 컨텐츠가 비어 있거나 null입니다. * PdfReader가 소유자 암호로 열리지 않았습니다. * 수정된 PDF를 첨부할 대상 테이블 이름인 \<targetTable\>이 비어 있거나 null입니다. * 수정된 PDF를 첨부할 대상 테이블 이름인 \<targetTable\>이(가) 잘못되었습니다. {#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__ul_zv2_wq3_k4b} 데이터 유형: 문자열 |
| \<Object\>.status | 운영의 성공 여부를 나타내는 상태입니다. 가능한 값: * 성공 - 작업이 성공했습니다. * 실패 -- 운영에 실패했습니다. 에서는 message 상세 정보를 제공합니다. {#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__ul_rlv_5cv_j4b} 데이터 유형: 문자열 |
[표 3. 반환]

{#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__table_hms_ycm_j4b}  
다음 예는 인시던트 기록의 설명 필드에서 SVG를 가져와 PDF 첨부 파일의 5페이지에 추가하는 방법을 보여줍니다. SVG가 포함된 새 PDF는 첨부 파일 \[sys_attachment\] 테이블에 있습니다.

    var gr = new GlideRecord("incident");

    var svg;

    if (gr.get("<tableSysId>")) {
     svg = gr.description.toString();
    }

    var result = new sn_pdfgeneratorutils.SVGToPDFConversionAPI().addSVGToPDF(svg, "<inputPdfSysId>", "incident", "<tableSysId>", "AddSVGToPDF", 5, 30, 30, 300, 100);
    gs.info(JSON.stringify(result));

출력:

    {"attachment_id":"<sys_id>","message":"Adding SVG to PDF and creating new PDF is successful.","status":"success"}

## SVGToPDFConversionAPI - convertSVGToPDF(문자열 svg, 문자열 pdfName, 문자열 targetTable, 문자열 targetTableSysId) {#ariaid-title4}

문자열로 제공된 SVG를 PDF로 변환합니다.
{#SV-convertSVGToPDF_S_S_S_S__table_gms_ycm_j4b__entry__3}{#SV-convertSVGToPDF_S_S_S_S__api_pdfgen_parm_fill_tableN_desc}

| 이름 | 유형 | 설명 |
|-|-|-|
| SVG | 문자열 | PDF 문서로 변환할 SVG. |
| pdfName | 문자열 | PDF에 지정할 이름입니다. 기본값: 첨부 파일 \[sys_attachment\] 테이블에 있는 PDF의 Sys_id입니다. |
| targetTable | 문자열 | 변환된 PDF를 첨부할 테이블의 이름입니다. |
| targetTableSysId | 문자열 | 변환된 PDF를 첨부할 기록의 Sys_id입니다. |
[표 4. 매개변수]

{#SV-convertSVGToPDF_S_S_S_S__table_gms_ycm_j4b} {#SV-convertSVGToPDF_S_S_S_S__table_hms_ycm_j4b__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 성공한 경우 SVG에서 변환된 PDF 첨부 파일 sys_id를 포함하는 객체, 그렇지 않으면 오류 메시지입니다. { "attachment_id": "String", "message": "String", "status": "String" } |
| \<Object\>.​attachment_id | SVG 변환에 성공하면 첨부된 PDF를 sys_id. 파일이 첨부 파일 \[sys_attachment\] 테이블에 나열됩니다. 데이터 유형: 문자열 |
| \<Object\>.메시지 | 성공 또는 오류를 확인하는 메시지입니다. 가능한 값: * SVG 이미지를 PDF 문서로 변환하지 못했습니다. * 소스 문서 컨텐츠를 읽는 동안 예외가 발생했습니다. * 지정된 대상 기록 \[\<tableName\> - \<targetTableSysId\>\]이(가) 없습니다. - 대상 테이블 sys_id이 제공된 테이블에 없습니다. 기록에 올바른 테이블 이름을 포함해야 합니다. * SVG에서 PDF로의 변환에 성공했습니다. * 변환된 SVG를 첨부할 대상 테이블 이름인 \<tableName\>이 잘못되었습니다. * 변환된 SVG를 첨부할 대상 테이블 이름인 \<tableName\>이 비어 있거나 null입니다. {#SV-convertSVGToPDF_S_S_S_S__ul_zv2_wq3_k4b} 데이터 유형: 문자열 |
| \<Object\>.status | 운영의 성공 여부를 나타내는 상태입니다. 가능한 값: * 성공 - 작업이 성공했습니다. * 실패 -- 운영에 실패했습니다. 에서는 message 상세 정보를 제공합니다. {#SV-convertSVGToPDF_S_S_S_S__ul_rlv_5cv_j4b} 데이터 유형: 문자열 |
[표 5. 반환]

{#SV-convertSVGToPDF_S_S_S_S__table_hms_ycm_j4b}  
다음 예는 인시던트 기록의 설명 필드에서 SVG를 가져와 SVG를 PDF로 변환하고 기록에 첨부하는 방법을 보여줍니다.

    var gr = new GlideRecord("incident");

    var svg;

    if (gr.get("<tableSysId>")) {
     svg = gr.description.toString();
    }

    var v = new sn_pdfgeneratorutils.SVGToPDFConversionAPI();

    var result = v.convertSVGToPDF(svg, "ConvertSVGToPDF", "incident", "<targetTableSysId>");
    gs.info(JSON.stringify(result));

출력:

    {"attachment_id":"<pdf_attachment_sys_id>","message":"SVG to PDF conversion is successful.","status":"success"}

## SVGToPDFConversionAPI - convertSVGToPDFWithSize(문자열 svg, 문자열 nameForPDF, 문자열 targetTable, 문자열 targetTableSysId, 숫자 svgImgWidth, 숫자 svgImgHeight) {#ariaid-title5}

문자열로 제공된 SVG를 이미지 너비 및 높이 값이 있는 PDF로 변환합니다.
{#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__table_nqj_1dm_j4b__entry__3}{#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__api_pdfgen_parm_fill_tableN_desc}

| 이름 | 유형 | 설명 |
|-|-|-|
| SVG | 문자열 | PDF 문서로 변환할 SVG. |
| pdfName | 문자열 | PDF에 지정할 이름입니다. 기본값: 첨부 파일 \[sys_attachment\] 테이블에 있는 PDF의 Sys_id입니다. |
| targetTable | 문자열 | 변환된 PDF를 첨부할 테이블의 이름입니다. |
| targetTableSysId | 문자열 | 변환된 PDF를 첨부할 기록의 Sys_id입니다. |
| svgImgWidth | 번호 | SVG 이미지의 너비(픽셀)입니다. |
| svgImg높이 | 번호 | SVG 이미지의 높이(픽셀)입니다. |
[표 6. 매개변수]

{#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__table_nqj_1dm_j4b} {#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__table_hms_ycm_j4b__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 성공한 경우 SVG에서 변환된 PDF 첨부 파일 sys_id를 포함하는 객체, 그렇지 않으면 오류 메시지입니다. { "attachment_id": "String", "message": "String", "status": "String" } |
| \<Object\>.​attachment_id | SVG 변환에 성공하면 첨부된 PDF를 sys_id. 파일이 첨부 파일 \[sys_attachment\] 테이블에 나열됩니다. 데이터 유형: 문자열 |
| \<Object\>.메시지 | 성공 또는 오류를 확인하는 메시지입니다. 가능한 값: * SVG 이미지를 PDF 문서로 변환하지 못했습니다. * 소스 문서 컨텐츠를 읽는 동안 예외가 발생했습니다. * 지정된 대상 기록 \[\<tableName\> - \<targetTableSysId\>\]이(가) 없습니다. - 대상 테이블 sys_id이 제공된 테이블에 없습니다. 기록에 올바른 테이블 이름을 포함해야 합니다. * 변환된 SVG를 첨부할 대상 테이블 이름인 \<tableName\>이 잘못되었습니다. * 변환된 SVG를 첨부할 대상 테이블 이름인 \<tableName\>이 비어 있거나 null입니다. * SVG에서 PDF로의 변환에 성공했습니다. {#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__ul_zv2_wq3_k4b} 데이터 유형: 문자열 |
| \<Object\>.status | 운영의 성공 여부를 나타내는 상태입니다. 가능한 값: * 성공 - 작업이 성공했습니다. * 실패 -- 운영에 실패했습니다. 에서는 message 상세 정보를 제공합니다. {#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__ul_rlv_5cv_j4b} 데이터 유형: 문자열 |
[표 7. 반환]

{#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__table_hms_ycm_j4b}  
다음 예는 인시던트 기록의 설명 필드에서 SVG를 가져와 SVG를 PDF로 변환하고 기록에 첨부하는 방법을 보여줍니다.

    var gr = new GlideRecord("incident");

    var svg;

    if (gr.get("<tableSysId>")) {
     svg = gr.description.toString();
    }

    var v = new sn_pdfgeneratorutils.SVGToPDFConversionAPI();

    var result = v.convertSVGToPDFWithSize(svg, "ConvertSVGToPDF", "incident", "<targetTableSysId>", 600, 150);
    gs.info(JSON.stringify(result));

출력:

    {"attachment_id":"<pdf_attachment_sys_id>","message":"SVG to PDF conversion is successful.","status":"success"}