SVGToPDFConversionAPI - 범위 지정, 전역

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기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 문자열 SVG를 사용하여 PDF 문서로 변환할 수 있습니다.
    입력PDF시ID 문자열 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.
    페이지번호 번호 SVG를 배치할 첨부된 PDF의 페이지 번호입니다.
    x 번호 페이지에서 SVG의 가로 위치입니다. 값은 포인트 단위입니다.
    y 번호 페이지에서 SVG의 세로 위치입니다. 값은 포인트 단위입니다.
    svgImg너비 번호 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>.메시지 성공 또는 오류를 확인하는 메시지입니다.
    가능한 값:
    • SVG 내용을 PDF에 추가하지 못했습니다.
    • PDF에 SVG를 추가하고 새 PDF를 만드는 데 성공했습니다.
    • 지정된 대상 기록 [&lt;tableName> - &lt;targetTableSysId>]이(가) 존재하지 않습니다. – 대상 테이블 sys_id가 제공된 테이블에 없습니다. 기록에 올바른 테이블 이름을 포함해야 합니다.
    • SVG 컨텐츠를 추가할 PDF 첨부 파일 시스템 ID를 입력하십시오. null입니다.
    • 입력 SVG 컨텐츠가 비어 있거나 null입니다
    • PdfReader가 소유자 암호로 열리지 않습니다.
    • 수정된 PDF를 첨부할 대상 테이블 이름: &lt;targetTable>이 비어 있거나 null임
    • 수정된 PDF를 첨부할 대상 테이블 이름: &lt;targetTable>이 잘못되었습니다.

    데이터 유형: 문자열
    <Object>.상태 작업의 성공 여부를 나타내는 상태입니다.
    가능한 값:
    • success - 작업이 성공했습니다.
    • 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(svg 문자열, pdf Name 문자열, targetTable 문자열, targetTableSysId 문자열)

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

    표 4. 매개변수
    이름 유형 설명
    SVG 문자열 SVG를 사용하여 PDF 문서로 변환할 수 있습니다.
    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 문서로 변환하지 못했습니다.
    • 소스 문서 컨텐츠를 읽는 동안 예외가 발생했습니다.
    • 지정된 대상 기록 [&lt;tableName> - &lt;targetTableSysId>]이(가) 존재하지 않습니다. – 대상 테이블 sys_id가 제공된 테이블에 없습니다. 기록에 올바른 테이블 이름을 포함해야 합니다.
    • SVG를 PDF로 변환하는 데 성공했습니다.
    • 변환된 SVG를 첨부할 대상 테이블 이름인 &lt;tableName>이(가) 유효하지 않습니다.
    • 변환된 SVG를 첨부할 대상 테이블 이름인 &lt;tableName>이 비어 있거나 null입니다.

    데이터 유형: 문자열
    <Object>.상태 작업의 성공 여부를 나타내는 상태입니다.
    가능한 값:
    • success - 작업이 성공했습니다.
    • 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(svg 문자열, nameForPDF 문자열, targetTable 문자열, targetTableSysId 문자열, svgImgWidth, svgImgHeight 숫자)

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

    표 6. 매개변수
    이름 유형 설명
    SVG 문자열 SVG를 사용하여 PDF 문서로 변환할 수 있습니다.
    PDF이름 문자열 PDF를 제공할 이름입니다.

    기본값: 첨부 파일 [sys_attachment] 테이블에 있는 PDF의 Sys_id.
    targetTable 문자열 변환된 PDF를 첨부할 테이블의 이름입니다.
    targetTableSysId 문자열 변환된 PDF를 첨부할 기록의 Sys_id입니다.
    svgImg너비 번호 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 문서로 변환하지 못했습니다.
    • 소스 문서 컨텐츠를 읽는 동안 예외가 발생했습니다.
    • 지정된 대상 기록 [&lt;tableName> - &lt;targetTableSysId>]이(가) 존재하지 않습니다. – 대상 테이블 sys_id가 제공된 테이블에 없습니다. 기록에 올바른 테이블 이름을 포함해야 합니다.
    • 변환된 SVG를 첨부할 대상 테이블 이름인 &lt;tableName>이(가) 유효하지 않습니다.
    • 변환된 SVG를 첨부할 대상 테이블 이름인 &lt;tableName>이 비어 있거나 null입니다.
    • SVG를 PDF로 변환하는 데 성공했습니다.

    데이터 유형: 문자열
    <Object>.상태 작업의 성공 여부를 나타내는 상태입니다.
    가능한 값:
    • success - 작업이 성공했습니다.
    • 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"}