SVGToPDFConversionAPI - 범위가 지정됨, 전역

  • 릴리스 버전: Zurich
  • 업데이트 날짜 2025년 07월 31일
  • 소요 시간: 10분

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

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

    PDFGenerationAPI를 참조하십시오.

    SVGToPDFConversionAPI - SVGToPDFConversionAPI()

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

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

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

    var v = new sn_pdfgeneratorutils.SVGToPDFConversionAPI();

    SVGToPDFConversionAPI - addSVGToPDF(String svg, String inputPdfSysId, String targetTable, String targetSysId, String nameForPdf, Number pageNo, Number x, Number y, Number svgImgWidth, Number svgImgHeight)

    이미지 크기 및 위치 좌표를 사용하여 지정된 페이지의 PDF에 SVG 이미지를 추가합니다.

    표 2. 매개변수
    이름 유형 설명
    svg 문자열 PDF 문서로 변환할 SVG입니다.
    입력 PdfSysId 문자열 SVG를 사용하여 사본을 만들 대상 PDF의 Sys_id입니다. 대상 PDF는 첨부 파일 [sys_attachment] 테이블에 있습니다.
    targetTable 문자열 PDF가 첨부된 기록이 포함된 테이블의 이름입니다. 첨부 파일 [sys_attachment] 테이블에 나열된 첨부 파일과 같은 행에서 이 값을 찾을 수 있습니다.
    targetTableSysId 문자열 PDF가 첨부된 기록의 Sys_id입니다. 첨부 파일 [sys_attachment] 테이블에 나열된 첨부 파일과 같은 행에서 이 값을 찾을 수 있습니다.
    targetTable 문자열 변환된 PDF를 첨부할 테이블의 이름입니다.
    targetTableSysId 문자열 변환된 PDF를 첨부할 기록의 Sys_id.
    pdf이름 문자열 PDF를 지정할 이름입니다.

    기본값: 첨부 파일 [sys_attachment] 테이블에 있는 PDF의 Sys_id.
    pageNo 번호 SVG를 배치할 첨부된 PDF의 페이지 번호입니다.
    x 번호 페이지에서 SVG의 수평 위치입니다. 값은 포인트 단위입니다.
    y 번호 페이지에서 SVG의 세로 위치입니다. 값은 포인트 단위입니다.
    svgImgWidth 번호 SVG 이미지의 너비(픽셀)입니다.
    svgImgHeight 번호 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>.상태 작업이 성공했는지 여부를 나타내는 상태입니다.
    가능한 값:
    • 성공 - 운영이 성공했습니다.
    • failure – 작업이 성공하지 못했습니다. 세부 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(String svg, String pdfName, String targetTable, String targetTableSysId)

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

    표 4. 매개변수
    이름 유형 설명
    svg 문자열 PDF 문서로 변환할 SVG입니다.
    pdf이름 문자열 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>.상태 작업이 성공했는지 여부를 나타내는 상태입니다.
    가능한 값:
    • 성공 - 운영이 성공했습니다.
    • failure – 작업이 성공하지 못했습니다. 세부 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(String svg, String nameForPDF, String targetTable, String targetTableSysId, Number svgImgWidth, Number svgImgHeight)

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

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

    기본값: 첨부 파일 [sys_attachment] 테이블에 있는 PDF의 Sys_id.
    targetTable 문자열 변환된 PDF를 첨부할 테이블의 이름입니다.
    targetTableSysId 문자열 변환된 PDF를 첨부할 기록의 Sys_id.
    svgImgWidth 번호 SVG 이미지의 너비(픽셀)입니다.
    svgImgHeight 번호 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>.상태 작업이 성공했는지 여부를 나타내는 상태입니다.
    가능한 값:
    • 성공 - 운영이 성공했습니다.
    • failure – 작업이 성공하지 못했습니다. 세부 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"}