SVGToPDFConversionAPI - 범위, 전역

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 10분

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

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

    PDFGenerationAPI도 참조하십시오.

    SVGToPDFConversionAPI - SVGToPDFConversionAPI()

    새 SVGToPDFConversionAPI 객체를 인스턴스화합니다.

    표 1. 매개변수
    이름 유형 설명
    없음

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

    var v = new sn_pdfgeneratorutils.SVGToPDFConversionAPI();

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

    이미지 크기와 위치 좌표가 있는 지정된 페이지의 PDF에 SVG 이미지를 추가합니다.

    표 2. 매개변수
    이름 유형 설명
    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 이미지의 높이(픽셀)입니다.
    표 3. 반환
    유형 설명
    객체 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>이(가) 잘못되었습니다.

    데이터 유형: 문자열
    <Object>.status 운영의 성공 여부를 나타내는 상태입니다.
    가능한 값:
    • 성공 - 작업이 성공했습니다.
    • 실패 – 운영에 실패했습니다. 에서는 message 상세 정보를 제공합니다.

    데이터 유형: 문자열

    다음 예는 인시던트 기록의 설명 필드에서 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)

    문자열로 제공된 SVG를 PDF로 변환합니다.

    표 4. 매개변수
    이름 유형 설명
    SVG 문자열 PDF 문서로 변환할 SVG.
    pdfName 문자열 PDF에 지정할 이름입니다.

    기본값: 첨부 파일 [sys_attachment] 테이블에 있는 PDF의 Sys_id입니다.
    targetTable 문자열 변환된 PDF를 첨부할 테이블의 이름입니다.
    targetTableSysId 문자열 변환된 PDF를 첨부할 기록의 Sys_id입니다.
    표 5. 반환
    유형 설명
    객체 성공한 경우 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입니다.

    데이터 유형: 문자열
    <Object>.status 운영의 성공 여부를 나타내는 상태입니다.
    가능한 값:
    • 성공 - 작업이 성공했습니다.
    • 실패 – 운영에 실패했습니다. 에서는 message 상세 정보를 제공합니다.

    데이터 유형: 문자열

    다음 예는 인시던트 기록의 설명 필드에서 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)

    문자열로 제공된 SVG를 이미지 너비 및 높이 값이 있는 PDF로 변환합니다.

    표 6. 매개변수
    이름 유형 설명
    SVG 문자열 PDF 문서로 변환할 SVG.
    pdfName 문자열 PDF에 지정할 이름입니다.

    기본값: 첨부 파일 [sys_attachment] 테이블에 있는 PDF의 Sys_id입니다.
    targetTable 문자열 변환된 PDF를 첨부할 테이블의 이름입니다.
    targetTableSysId 문자열 변환된 PDF를 첨부할 기록의 Sys_id입니다.
    svgImgWidth 번호 SVG 이미지의 너비(픽셀)입니다.
    svgImg높이 번호 SVG 이미지의 높이(픽셀)입니다.
    표 7. 반환
    유형 설명
    객체 성공한 경우 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로의 변환에 성공했습니다.

    데이터 유형: 문자열
    <Object>.status 운영의 성공 여부를 나타내는 상태입니다.
    가능한 값:
    • 성공 - 작업이 성공했습니다.
    • 실패 – 운영에 실패했습니다. 에서는 message 상세 정보를 제공합니다.

    데이터 유형: 문자열

    다음 예는 인시던트 기록의 설명 필드에서 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"}