SVGToPDFConversionAPI - escopo, global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 6 min. de leitura

    • . SVGToPDFConversionAPI Fornece métodos que permitem adicionar um SVG a um PDF e converter um SVG em PDF.

    Esta API faz parte do ServiceNow Plug-in Utilitários de geração de PDF (com.snc.apppdfgenerator) e é fornecido em sn_pdfgeneratorutils namespace. O plug-in é ativado por padrão.

    Consulte também PDFGenerationAPI .

    SVGToPDFConversionAPI - SVGToPDFConversionAPI()

    Instancia um novo SVGToPDFConversionAPI objeto.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum(a)

    Os exemplos a seguir mostram como criar um SVGToPDFConversionAPI objeto.

    var v = new sn_pdfgeneratorutils.SVGToPDFConversionAPI();

    SVGToPDFConversionAPI - addSVGToPDF(cadeia de caracteres svg, cadeia de caracteres inputPdfSysId, cadeia de caracteres targetTable, cadeia de caracteres targetSysId, cadeia de caracteres nameForPdf, Número da página, número x, número y, número svgImgWidth, número svgImgHeight)

    Adiciona uma imagem SVG a um PDF em uma página especificada com tamanho da imagem e coordenadas de local.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    svg Cadeia de caracteres SVG para converter em um documento PDF.
    InputPdfSysId Cadeia de caracteres Sys_id do PDF de destino no qual criar uma cópia de com um SVG. O PDF de destino está na tabela Anexos [sys_attachment].
    targetTable Cadeia de caracteres Nome da tabela que contém o registro ao qual o PDF está anexado. Você pode encontrar este valor na mesma linha do anexo listado na tabela Anexos [sys_attachment].
    TargetTableSysId Cadeia de caracteres Sys_id do registro ao qual o PDF está anexado. Você pode encontrar este valor na mesma linha do anexo listado na tabela Anexos [sys_attachment].
    targetTable Cadeia de caracteres Nome da tabela na qual anexar o PDF convertido .
    TargetTableSysId Cadeia de caracteres Sys_id do registro ao qual anexar o PDF convertido.
    PdfName Cadeia de caracteres Nome para fornecer o PDF.

    Padrão: Sys_id do PDF na tabela Anexos [sys_attachment].
    pageNo Número Número da página no PDF anexado na qual colocar o SVG.
    x Número Posição horizontal do SVG na página. O valor está em pontos.
    u Número Posição vertical do SVG na página. O valor está em pontos.
    SvgImgWidth Número Largura da imagem SVG em pixels.
    SvgImgHeight Número Altura da imagem SVG em pixels.
    Tabela 3. Retornos
    Tipo Descrição
    Objeto Objeto que contém sys_id de um novo anexo PDF com SVG inserido, se bem-sucedido, mensagem de erro caso contrário.
    {
  "attachment_id": "String",
  "message": "String",
  "status": "String"
}
    <Object>. ​attachment_id Se a conversão SVG for bem-sucedida, sys_id do PDF anexado. O arquivo está listado na tabela Anexos [sys_attachment].

    Tipo de dados: Cadeia de caracteres
    <Object>.message Mensagem confirmando sucesso ou erro.
    Valores possíveis:
    • Falha ao adicionar conteúdo SVG ao PDF.
    • A adição de SVG ao PDF e a criação de um novo PDF foram bem-sucedidas.
    • O registro de destino fornecido [<tableName> - <targetTableSysId>] não existe. A tabela de destino sys_id não está na tabela fornecida. Certifique-se de incluir o nome da tabela correto para o registro.
    • O sys ID do anexo PDF de entrada para adicionar o conteúdo SVG é nulo
    • O conteúdo SVG de entrada está vazio ou é nulo
    • PdfReader não foi aberto com a senha do proprietário
    • O nome da tabela de destino para anexar o PDF modificado: O <targetTable> está vazio ou é nulo
    • O nome da tabela de destino para anexar o PDF modificado: O <targetTable> não é válido

    Tipo de dados: Cadeia de caracteres
    <Object>.status Status que indica se a operação foi bem-sucedida.
    Valores possíveis:
    • Sucesso - A operação foi bem-sucedida.
    • Falha - A operação não foi bem-sucedida. . messagefornece detalhes.

    Tipo de dados: Cadeia de caracteres

    O exemplo a seguir mostra como obter SVG do campo de descrição de um registro de incidente e adicioná-lo à página 5 de um anexo em PDF. O novo PDF com SVG está localizado na tabela Anexos [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));

    Saída:

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

    SVGToPDFConversionAPI - convertSVGToPDF(cadeia de caracteres svg, cadeia de caracteres PDFName, cadeia de caracteres targetTable, cadeia de caracteres targetTableSysId)

    Converte um SVG fornecido como cadeia de caracteres em PDF.

    Tabela 4. Parâmetros
    Nome Tipo Descrição
    svg Cadeia de caracteres SVG para converter em um documento PDF.
    PdfName Cadeia de caracteres Nome para fornecer o PDF.

    Padrão: Sys_id do PDF na tabela Anexos [sys_attachment].
    targetTable Cadeia de caracteres Nome da tabela na qual anexar o PDF convertido .
    TargetTableSysId Cadeia de caracteres Sys_id do registro ao qual anexar o PDF convertido.
    Tabela 5. Retornos
    Tipo Descrição
    Objeto Objeto que contém sys_id do anexo PDF convertido de SVG se bem-sucedido, caso contrário, mensagem de erro.
    {
  "attachment_id": "String",
  "message": "String",
  "status": "String"
}
    <Object>. ​attachment_id Se a conversão SVG for bem-sucedida, sys_id do PDF anexado. O arquivo está listado na tabela Anexos [sys_attachment].

    Tipo de dados: Cadeia de caracteres
    <Object>.message Mensagem confirmando sucesso ou erro.
    Valores possíveis:
    • Falha ao converter imagem SVG em documento PDF.
    • Exceção ao ler o conteúdo do documento de origem.
    • O registro de destino fornecido [<tableName> - <targetTableSysId>] não existe. A tabela de destino sys_id não está na tabela fornecida. Certifique-se de incluir o nome da tabela correto para o registro.
    • A conversão SVG para PDF foi bem-sucedida.
    • O nome da tabela de destino - <tableName> para anexar o SVG convertido não é válido
    • O nome da tabela de destino - <tableName> para anexar o SVG convertido está vazio ou nulo

    Tipo de dados: Cadeia de caracteres
    <Object>.status Status que indica se a operação foi bem-sucedida.
    Valores possíveis:
    • Sucesso - A operação foi bem-sucedida.
    • Falha - A operação não foi bem-sucedida. . messagefornece detalhes.

    Tipo de dados: Cadeia de caracteres

    O exemplo a seguir mostra como obter SVG do campo de descrição de um registro de incidente para converter o SVG em PDF e anexá-lo a um registro.

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

    Saída:

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

    SVGToPDFConversionAPI - convertSVGToPDFWithSize(Cadeia de caracteres svg, Cadeia de caracteres nameForPDF, Cadeia de caracteres targetTable, Cadeia de caracteres targetTableSysId, Número svgImgWidth, número svgImgHeight)

    Converte um SVG fornecido como cadeia de caracteres em PDF com valores de largura e altura da imagem.

    Tabela 6. Parâmetros
    Nome Tipo Descrição
    svg Cadeia de caracteres SVG para converter em um documento PDF.
    PdfName Cadeia de caracteres Nome para fornecer o PDF.

    Padrão: Sys_id do PDF na tabela Anexos [sys_attachment].
    targetTable Cadeia de caracteres Nome da tabela na qual anexar o PDF convertido .
    TargetTableSysId Cadeia de caracteres Sys_id do registro ao qual anexar o PDF convertido.
    SvgImgWidth Número Largura da imagem SVG em pixels.
    SvgImgHeight Número Altura da imagem SVG em pixels.
    Tabela 7. Retornos
    Tipo Descrição
    Objeto Objeto que contém sys_id do anexo PDF convertido de SVG se bem-sucedido, caso contrário, mensagem de erro.
    {
  "attachment_id": "String",
  "message": "String",
  "status": "String"
}
    <Object>. ​attachment_id Se a conversão SVG for bem-sucedida, sys_id do PDF anexado. O arquivo está listado na tabela Anexos [sys_attachment].

    Tipo de dados: Cadeia de caracteres
    <Object>.message Mensagem confirmando sucesso ou erro.
    Valores possíveis:
    • Falha ao converter imagem SVG em documento PDF.
    • Exceção ao ler o conteúdo do documento de origem.
    • O registro de destino fornecido [<tableName> - <targetTableSysId>] não existe. A tabela de destino sys_id não está na tabela fornecida. Certifique-se de incluir o nome da tabela correto para o registro.
    • O nome da tabela de destino - <tableName> para anexar o SVG convertido não é válido
    • O nome da tabela de destino - <tableName> para anexar o SVG convertido está vazio ou nulo
    • A conversão SVG para PDF foi bem-sucedida.

    Tipo de dados: Cadeia de caracteres
    <Object>.status Status que indica se a operação foi bem-sucedida.
    Valores possíveis:
    • Sucesso - A operação foi bem-sucedida.
    • Falha - A operação não foi bem-sucedida. . messagefornece detalhes.

    Tipo de dados: Cadeia de caracteres

    O exemplo a seguir mostra como obter SVG do campo de descrição de um registro de incidente para converter o SVG em PDF e anexá-lo a um registro.

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

    Saída:

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