---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# SVGToPDFConversionAPI - com escopo, global

# SVGToPDFConversionAPI - com escopo, global {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 min. de leitura

A API SVGToPDFConversion fornece métodos que permitem adicionar um SVG a um PDF e converter um SVG em PDF.

Esta API faz parte do plug-in ServiceNow PDF Generator Utilities (com.snc.apppdfgenerator) e é fornecida no namespace `sn_pdfgeneratorutils`. O plug-in é ativado por padrão.

Consulte também [PDFGenerationAPI](https://servicenow-prod.fluidtopics.net/RfCHRBA0t7Pz~tldc01UmA#PDFGenerationAPIBothAPI "A PDFGenerationAPI fornece suporte para conversão de PDF e manipulação de campos de PDF.").

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

Instancia um novo objeto SVGToPDFConversionAPI.
{#SV-SVGToPDFConversionAPI__table_twm_hjk_34b__entry__3}

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

{#SV-SVGToPDFConversionAPI__table_twm_hjk_34b}  
Os exemplos a seguir mostram como criar um objeto SVGToPDFConversionAPI.

    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 pageNo, número x, número y, número svgImgWidth, número svgImgHeight) {#ariaid-title3}

Adiciona uma imagem SVG a um PDF em uma página especificada com tamanho de imagem e coordenadas de local.
{#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}

| Nome | Tipo | Descrição |
|-|-|-|
| SVG | Cadeia de caracteres | SVG a ser convertido em um documento PDF. |
| inputPdfSysId | Cadeia de caracteres | Sys_id do PDF de destino no qual uma cópia será criada 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 à qual o PDF convertido será anexado. |
| targetTableSysId | Cadeia de caracteres | Sys_id do registro ao qual o PDF convertido será anexado. |
| NomeDopdf | Cadeia de caracteres | Nome para fornecer ao PDF. Padrão: Sys_id do PDF na tabela Anexos \[sys_attachment\]. |
| pageNo | Número | Número da página no PDF anexado no qual o SVG será colocado. |
| 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. |
| svgImgAltura | Número | Altura da imagem SVG em pixels. |
[Tabela 2. Parâmetros]

{#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}

| Tipo | Descrição |
|-|-|
| Objeto | Objeto que contém o sys_id de um novo anexo em PDF com o SVG inserido se for bem-sucedido, caso contrário, uma mensagem de erro. { "attachment_id": "String", "message": "String", "status": "String" } |
| \<Object\>.​attachment_id | Se a conversão de 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\>.mensagem | 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. * 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 em PDF de entrada para adicionar o conteúdo SVG é nulo * O conteúdo SVG de entrada está vazio ou é nulo * PdfReader não é aberto com a senha do proprietário * O nome da tabela de destino para anexar o PDF modificado :\<targetTable\> está vazio ou é nulo * O nome da tabela de destino para anexar o PDF modificado :\<targetTable\> não é válido {#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__ul_zv2_wq3_k4b} 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. O message fornece detalhes. {#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__ul_rlv_5cv_j4b} Tipo de dados: cadeia de caracteres |
[Tabela 3. Retorna]

{#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__table_hms_ycm_j4b}  
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) {#ariaid-title4}

Converte um SVG fornecido como cadeia de caracteres em 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}

| Nome | Tipo | Descrição |
|-|-|-|
| SVG | Cadeia de caracteres | SVG a ser convertido em um documento PDF. |
| NomeDopdf | Cadeia de caracteres | Nome para fornecer ao PDF. Padrão: Sys_id do PDF na tabela Anexos \[sys_attachment\]. |
| targetTable | Cadeia de caracteres | Nome da tabela à qual o PDF convertido será anexado. |
| targetTableSysId | Cadeia de caracteres | Sys_id do registro ao qual o PDF convertido será anexado. |
[Tabela 4. Parâmetros]

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

| Tipo | Descrição |
|-|-|
| Objeto | Objeto que contém sys_id do anexo em PDF convertido de SVG se for bem-sucedido, caso contrário, mensagem de erro. { "attachment_id": "String", "message": "String", "status": "String" } |
| \<Object\>.​attachment_id | Se a conversão de 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\>.mensagem | 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. * 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 de SVG para PDF foi bem-sucedida. * O nome da tabela de destino -\<tableName\> anexar o SVG convertido não é válido * O nome da tabela de destino -\<tableName\> para anexar o SVG convertido está vazio ou é nulo {#SV-convertSVGToPDF_S_S_S_S__ul_zv2_wq3_k4b} 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. O message fornece detalhes. {#SV-convertSVGToPDF_S_S_S_S__ul_rlv_5cv_j4b} Tipo de dados: cadeia de caracteres |
[Tabela 5. Retorna]

{#SV-convertSVGToPDF_S_S_S_S__table_hms_ycm_j4b}  
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) {#ariaid-title5}

Converte um SVG fornecido como cadeia de caracteres em PDF com valores de largura e altura da imagem.
{#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}

| Nome | Tipo | Descrição |
|-|-|-|
| SVG | Cadeia de caracteres | SVG a ser convertido em um documento PDF. |
| NomeDopdf | Cadeia de caracteres | Nome para fornecer ao PDF. Padrão: Sys_id do PDF na tabela Anexos \[sys_attachment\]. |
| targetTable | Cadeia de caracteres | Nome da tabela à qual o PDF convertido será anexado. |
| targetTableSysId | Cadeia de caracteres | Sys_id do registro ao qual o PDF convertido será anexado. |
| svgImgWidth | Número | Largura da imagem SVG em pixels. |
| svgImgAltura | Número | Altura da imagem SVG em pixels. |
[Tabela 6. Parâmetros]

{#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}

| Tipo | Descrição |
|-|-|
| Objeto | Objeto que contém sys_id do anexo em PDF convertido de SVG se for bem-sucedido, caso contrário, mensagem de erro. { "attachment_id": "String", "message": "String", "status": "String" } |
| \<Object\>.​attachment_id | Se a conversão de 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\>.mensagem | 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. * 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\> 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 de SVG para PDF foi bem-sucedida. {#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__ul_zv2_wq3_k4b} 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. O message fornece detalhes. {#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__ul_rlv_5cv_j4b} Tipo de dados: cadeia de caracteres |
[Tabela 7. Retorna]

{#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__table_hms_ycm_j4b}  
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"}