PDFGenerationAPI - escopo, global
. PDFGenerationAPI Fornece suporte para conversão de PDF e manipulação de campos de 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.
Use glide.pdf.url.whitelistPropriedade para adicionar uma camada extra de validação para garantir se qualquer URL externa introduzida deve ser incluída no PDF gerado. Se a propriedade do sistema glide.pdf.url.whitelisting.enabled estiver definida como verdadeira, o PDF não processará o conteúdo da URL, a menos que esteja listado no campo Valor da propriedade do sistema com.snc.pdf.whitelisted_urls. Essas propriedades são listadas na tabela Propriedades do sistema [sys_properties]. Para obter mais informações, consulte Available system properties.
- Gere dinamicamente um PDF a partir de uma cadeia de caracteres HTML e anexe-o a um registro
- Tamanho A4 sem cabeçalhos ou rodapés – PDFGenerationAPI – convertToPDF(cadeia de caracteres html, cadeia de caracteres targetTable, cadeia de caracteres targetTableSysId, cadeia de caracteres pdfName, cadeia de caracteres fontFamilySysId, documentConfiguration do objeto)
- Tamanho de página personalizável com opções para cabeçalho e rodapé – PDFGenerationAPI – convertToPDFWithHeaderFooter(cadeia de caracteres html, cadeia de caracteres targetTable, cadeia de caracteres targetTableSysId, cadeia de caracteres pdfName, objeto headerFoeterInfo, cadeia de caracteres fontFamilySysId, Object documentConfiguration)
- Enfileirar um PDF a ser gerado a partir de uma cadeia de caracteres HTML e anexado a um registro
- Tamanho A4 sem cabeçalhos ou rodapés – PDFGenerationAPI – convertToPDFSync(cadeia de caracteres html, cadeia de caracteres targetTable, cadeia de caracteres targetTableSysId, cadeia de caracteres pdfName, cadeia de caracteres fontFamilySysId, documentConfiguration do objeto)
- Tamanho de página personalizável com opções para cabeçalho e rodapé – PDFGenerationAPI – convertToPDFWithHeaderFoeterAsync(cadeia de caracteres html, cadeia de caracteres targetTable, cadeia de caracteres targetTableSysId, cadeia de caracteres pdfName, objeto headerFooterInfo, cadeia de caracteres fontFamilySysId, Object documentConfiguration)
- Preencha os campos em um PDF
- PDFGenerationAPI – fillDocumentFieldsAndFlatten(Object fieldsMap, cadeia de caracteres SYSID, cadeia de caracteres tablename, cadeia de caracteres tablename, cadeia de caracteres tableSysId, cadeia de caracteres pdfName, achatar objeto)
- PDFGenerationAPI – fillDocumentFields(Object fieldsMap, cadeia de caracteres SYSID, cadeia de caracteres tablename, cadeia de caracteres tablSysId, cadeia de caracteres pdfName)
- PDFGenerationAPI – isDocumentFillable(cadeia de caracteres SYSID)
- Assine um PDF
- PDFGenerationAPI – fillFieldsAndMergeSignature(Object fieldsMap, cadeia de caracteres SYSID, cadeia de caracteres tablename, cadeia de caracteres tablename, cadeia de caracteres tableSysId, cadeia de caracteres pdfName, Solicitante de PdfMergeSignSolicitante, nivelar objeto)
- PDFGenerationAPI – getFilledDocumentWithSignatureAsBase64(Object fieldsMap, cadeia de caracteres SYSID, PdfMergeSignSolicitante, objeto planificado)
- Restringir a edição de campos preenchidos como nivelados ou parcialmente nivelados – PDFGenerationAPI – fillDocumentFieldsAndFlatten(Object fieldsMap, cadeia de caracteres SYSID, cadeia de caracteres tablename, cadeia de caracteres tablename, cadeia de caracteres tableSysId, cadeia de caracteres pdfName, achatar objeto)
- Recupere o tamanho da página PDF e os dados do campo
- Editar informações em um PDF – PDFGenerationAPI – Reeditar(Object inputJson)
PDFGenerationAPI – PDFGenerationAPI()
Instancia um novo PDFGenerationAPI objeto.
| Nome | Tipo | Descrição |
|---|---|---|
| Nenhum(a) |
O exemplo a seguir mostra como criar um PDFGenerationAPI objeto.
var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
PDFGenerationAPI – convertToPDF(cadeia de caracteres html, cadeia de caracteres targetTable, cadeia de caracteres targetTableSysId, cadeia de caracteres pdfName, cadeia de caracteres fontFamilySysId, documentConfiguration do objeto)
Converte uma cadeia de caracteres HTML em um documento PDF.
Este método cria um PDF usando o tamanho de página A4 – 595 x 842 pontos. O conteúdo será truncado se exceder esse tamanho.
Para gerar um PDF com configurações adicionais, como tamanho da página, orientação e números de página, use ConvertToPDFWithCabeçadoRodaFooter() .
| Nome | Tipo | Descrição |
|---|---|---|
| html | Cadeia de caracteres | HTML para converter em um documento PDF. |
| 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]. |
| FontFamilySysId | Cadeia de caracteres | Opcional. Sys_id da família de fontes a ser usada para o PDF. Este sys_id é da tabela Família de fontes de geração de PDF [sys_pdf_generation_font_family]. Padrão: Nenhum |
| DocumentConfiguration | Objeto | Opcional. Objeto que contém uma configuração de sumário e uma configuração de número de página. |
| DocumentConfiguration.acessibilityHabilitado | Booliano | Opcional. Sinalizador que indica se o PDF gerado deve ser formatado para oferecer suporte à acessibilidade. Quando este recurso estiver habilitado, os marcadores de acessibilidade estarão disponíveis na árvore de marcadores de PDF para ajudar os usuários que dependem de leitores de tela a navegar, entender e interagir com os documentos PDF gerados. Valores válidos:
Padrão: Falso |
| DocumentConfiguration.toc_config | Cadeia de caracteres | Opcional. Sys_id da configuração do sumário a ser usada para o PDF. Este sys_id é da tabela Configuração do sumário [doc_toc_config]. Padrão: Nenhum |
| DocumentConfiguration.page_number_config | Cadeia de caracteres | Opcional. Sys_id da configuração de número de página a ser usada para o PDF. Este sys_id é da tabela Configuração do número da página [doc_page_number_config]. Padrão: Nenhum |
| Tipo | Descrição |
|---|---|
| Objeto | Objeto que contém sys_id do anexo PDF se a conversão for bem-sucedida, caso contrário, mensagem de erro. |
| <Object>. attachment_id | Se a conversão HTML for bem-sucedida, sys_id do PDF convertido e 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:
Tipo de dados: Cadeia de caracteres |
| <Object>.request_id | Sys_id do registro de solicitação do produtor de mudança . Tipo de dados: Cadeia de caracteres |
| <Object>.status | Status que indica se a operação foi bem-sucedida. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
O exemplo a seguir mostra como converter HTML em PDF e anexá-lo a um registro na tabela Incidente [incidente].
var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
// (Option) get HTML from the description field of an incident record
var gr = new GlideRecord("incident");
var html;
if (gr.get("<tableSysId>")) {
html = gr.description.toString();
}
var result = v.convertToPDF(html, "incident", "<target_sys_id>", "myPDF");
gs.info(JSON.stringify(result));
Saída:
{"attachment_id":"<sys_id>","message":"Conversion is successful.","request_id":"<change_sys_id>","status":"success"}
PDFGenerationAPI – convertToPDFSync(cadeia de caracteres html, cadeia de caracteres targetTable, cadeia de caracteres targetTableSysId, cadeia de caracteres pdfName, cadeia de caracteres fontFamilySysId, documentConfiguration do objeto)
Prepara um trabalho que converte uma cadeia de caracteres HTML em um documento PDF de forma assíncrona. O processamento assíncrono permite que você trabalhe na instância enquanto a conversão do PDF está em andamento. Isso é especialmente útil para exportações de PDF maiores.
Esta API cria um PDF usando o tamanho de página A4 – 595 x 842 pontos. O conteúdo será truncado se exceder esse tamanho.
Para gerar um PDF com configurações adicionais, como tamanho da página, orientação e números de página, use ConvertToPDFWithCabeçadoFopoParoAsync() .
| Nome | Tipo | Descrição |
|---|---|---|
| html | Cadeia de caracteres | HTML para converter em um documento PDF. |
| 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]. |
| FontFamilySysId | Cadeia de caracteres | Opcional. Sys_id da família de fontes a ser usada para o PDF. Este sys_id é da tabela Família de fontes de geração de PDF [sys_pdf_generation_font_family]. Padrão: Nenhum |
| DocumentConfiguration | Objeto | Opcional. Objeto que contém uma configuração de sumário e uma configuração de número de página. |
| DocumentConfiguration.acessibilityHabilitado | Booliano | Opcional. Sinalizador que indica se o PDF gerado deve ser formatado para oferecer suporte à acessibilidade. Quando este recurso estiver habilitado, os marcadores de acessibilidade estarão disponíveis na árvore de marcadores de PDF para ajudar os usuários que dependem de leitores de tela a navegar, entender e interagir com os documentos PDF gerados. Valores válidos:
Padrão: Falso |
| DocumentConfiguration.toc_config | Cadeia de caracteres | Opcional. Sys_id da configuração do sumário a ser usada para o PDF. Este sys_id é da tabela Configuração do sumário [doc_toc_config]. Padrão: Nenhum |
| DocumentConfiguration.page_number_config | Cadeia de caracteres | Opcional. Sys_id da configuração de número de página a ser usada para o PDF. Este sys_id é da tabela Configuração do número da página [doc_page_number_config]. Padrão: Nenhum |
| Tipo | Descrição |
|---|---|
| Objeto | Objeto que indica se a conversão do PDF está em andamento. Você pode revisar o status da conversão na tabela Status de geração de PDF [sys_pdf_generation_status]. |
| <Object>.message | Mensagem confirmando sucesso ou erro. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| <Object>.request_id | Sys_id do registro de solicitação do produtor de mudança . Tipo de dados: Cadeia de caracteres |
O exemplo a seguir mostra como enfileirar uma tarefa que converte HTML em PDF. Quando a conversão é concluída, o PDF chamado "myPDF" é anexado ao registro de destino na tabela Incidente [incidente].
var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
// (Option) get HTML from the description field of an incident record
var gr = new GlideRecord("incident");
var html;
if (gr.get("<tableSysId>")) {
html = gr.description.toString();
}
var result = v.convertToPDFAsync(html, "incident", "<target_sys_id>", "myPDF");
gs.info(JSON.stringify(result));
Saída:
{"message":"HTML to PDF Conversion is in progress.","request_id":"<sys_id>"}
PDFGenerationAPI – convertToPDFWithHeaderFooter(cadeia de caracteres html, cadeia de caracteres targetTable, cadeia de caracteres targetTableSysId, cadeia de caracteres pdfName, objeto headerFoeterInfo, cadeia de caracteres fontFamilySysId, Object documentConfiguration)
Converte uma cadeia de caracteres HTML em um PDF com conteúdo de cabeçalho e rodapé.
- Informações de cabeçalho e rodapé
- Tamanhos das margens
- Orientação
- Enumeração
- Tamanho da página
| Nome | Tipo | Descrição |
|---|---|---|
| html | Cadeia de caracteres | HTML para converter em um documento PDF. |
| 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]. |
| CabeçadoRodaRodaInfo | Objeto | Define os detalhes do cabeçalho e rodapé do PDF. |
| CabeçadoRodaRodaInfo. RodaAlinhamento de imagem | Cadeia de caracteres | Define a posição da imagem no rodapé. Valores válidos:
|
| CabeçadoRodaRodaInfo. Rodapé ImageAttachmentId | Cadeia de caracteres | Sys_id da imagem do rodapé na tabela Anexos [sys_attachment].Para determinar se o tipo de arquivo é compatível com sua instância, navegue até Propriedades do sistema , Segurança e verifique se ele está listado em Lista de extensões de arquivo (separadas por vírgulas) que podem ser anexadas campo. |
| CabeçadoRodaRodaInfo. Altura da imagem do rodapé | Cadeia de caracteres | Altura da imagem do rodapé. Padrão: 50 pontos |
| CabeçadoRodaRodaInfo. RodaTexto | Cadeia de caracteres | Texto do rodapé a ser colocado na parte inferior de cada página PDF. |
| CabeçadoRodaRodaInfo. Alinhamento de texto do rodapé | Cadeia de caracteres | Define a posição do texto no rodapé. Certifique-se de que este valor não corresponda ou entre em conflito com a área fornecida em headerFooterInfo.FooterImageAlignment. Valores válidos:
|
| CabeçadoRodaRodaInfo. GeneratePageNumber | Cadeia de caracteres | Sinalizador que indica se um número de página PDF deve ser gerado. Valores válidos:
Padrão: verdadeiro |
| CabeçadoRodaRodaInfo. HeaderImageAlignment | Cadeia de caracteres | Define a posição da imagem no cabeçalho. Valores válidos:
|
| CabeçadoRodaRodaInfo. HeaderImageAttachmentId | Cadeia de caracteres | Sys_id da imagem do cabeçalho na tabela Anexos [sys_attachment].Para determinar se o tipo de arquivo é compatível com sua instância, navegue até Propriedades do sistema , Segurança e verifique se ele está listado em Lista de extensões de arquivo (separadas por vírgulas) que podem ser anexadas campo. |
| CabeçadoRodaRodaInfo. HeaderImageHeight | Cadeia de caracteres | Altura da imagem do cabeçalho. Padrão: 50 pontos |
| CabeçadoRodaRodaInfo. OrRightMargin | Cadeia de caracteres | Tamanho das margens esquerda e direita. Se posicionados no lado esquerdo ou direito da página, os detalhes do cabeçalho/rodapé serão colocados nesta área. Padrão: 36 pontos |
| CabeçadoRodaRodaInfo. PageOrientation | Cadeia de caracteres | Orientação da página. Valores válidos:
Padrão: Retrato |
| CabeçadoRodaRodaInfo. Tamanho da página | Cadeia de caracteres | Tamanho da página do documento. Valores válidos:
O conteúdo será truncado se exceder o tamanho da página. |
| CabeçadoRodaRodaInfo. TopOrBottomMargin | Cadeia de caracteres | Tamanho das margens superior e inferior. Os detalhes do cabeçalho e rodapé são colocados nesta área. Padrão: 72 pontos |
| FontFamilySysId | Cadeia de caracteres | Opcional. Sys_id da família de fontes a ser usada para o PDF. Este sys_id é da tabela Família de fontes de geração de PDF [sys_pdf_generation_font_family]. Padrão: Nenhum |
| DocumentConfiguration | Objeto | Opcional. Objeto que contém uma configuração de sumário e uma configuração de número de página. |
| DocumentConfiguration.acessibilityHabilitado | Booliano | Opcional. Sinalizador que indica se o PDF gerado deve ser formatado para oferecer suporte à acessibilidade. Quando este recurso estiver habilitado, os marcadores de acessibilidade estarão disponíveis na árvore de marcadores de PDF para ajudar os usuários que dependem de leitores de tela a navegar, entender e interagir com os documentos PDF gerados. Valores válidos:
Padrão: Falso |
| DocumentConfiguration.toc_config | Cadeia de caracteres | Opcional. Sys_id da configuração do sumário a ser usada para o PDF. Este sys_id é da tabela Configuração do sumário [doc_toc_config]. Padrão: Nenhum |
| DocumentConfiguration.page_number_config | Cadeia de caracteres | Opcional. Sys_id da configuração de número de página a ser usada para o PDF. Este sys_id é da tabela Configuração do número da página [doc_page_number_config]. Padrão: Nenhum |
| Tipo | Descrição |
|---|---|
| Objeto | Objeto que contém sys_id do anexo PDF se a conversão for bem-sucedida, caso contrário, mensagem de erro. |
| <Object>. attachment_id | Se a conversão HTML for bem-sucedida, sys_id do PDF convertido e 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:
Tipo de dados: Cadeia de caracteres |
| <Object>.request_id | Sys_id do registro de solicitação do produtor de mudança . Tipo de dados: Cadeia de caracteres |
| <Object>.status | Status que indica se a operação foi bem-sucedida. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
O exemplo a seguir mostra como converter HTML em um PDF chamado "myPDF" e adicionar o PDF como anexo a um registro na tabela Incidente [incidente]. O PDF contém cabeçalho e rodapé fornecidos por meio de anexo.
var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
// (Option) get HTML from the description field of an incident record
var gr = new GlideRecord("incident");
var html;
if (gr.get("<tableSysId>")) {
html = gr.description.toString();
}
var hfInfo = new Object();
hfInfo["HeaderImageAttachmentId"] = "<hdrImgAttSysId>";
hfInfo["HeaderImageAlignment"] = "left";
hfInfo["FooterImageAttachmentId"] = "<ftrImgAttSysId>";
hfInfo["FooterImageAlignment"] = "TOP_CENTER";
hfInfo["FooterText"] = "Sample Footer Message";
hfInfo["PageSize"] = "A4";
hfInfo["GeneratePageNumber"] = "false";
hfInfo["TopOrBottomMargin"] = "36";
hfInfo["LeftOrRightMargin"] = "24";
var result = v.convertToPDFWithHeaderFooter(html, "incident", "<targetTbl_sys_id>", "myPDF", hfInfo);
gs.info(JSON.stringify(result));
Saída:
{"attachment_id":"<sys_id>","message":"Conversion is successful.","request_id":"<change_sys_id>","status":"success"}
PDFGenerationAPI – convertToPDFWithHeaderFoeterAsync(cadeia de caracteres html, cadeia de caracteres targetTable, cadeia de caracteres targetTableSysId, cadeia de caracteres pdfName, objeto headerFooterInfo, cadeia de caracteres fontFamilySysId, Object documentConfiguration)
Prepara um trabalho que converte uma cadeia de caracteres HTML em um PDF com conteúdo de cabeçalho e rodapé de forma assíncrona. O processamento assíncrono permite que você trabalhe na instância enquanto a conversão do PDF está em andamento. Isso é especialmente útil para exportações de PDF maiores.
- Informações de cabeçalho e rodapé
- Tamanhos das margens
- Orientação
- Enumeração
- Tamanho da página
| Nome | Tipo | Descrição |
|---|---|---|
| html | Cadeia de caracteres | HTML para converter em um documento PDF. |
| 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]. |
| CabeçadoRodaRodaInfo | Objeto | Define os detalhes do cabeçalho e rodapé do PDF. |
| CabeçadoRodaRodaInfo. RodaAlinhamento de imagem | Cadeia de caracteres | Define a posição da imagem no rodapé. Valores válidos:
|
| CabeçadoRodaRodaInfo. Rodapé ImageAttachmentId | Cadeia de caracteres | Sys_id da imagem do rodapé na tabela Anexos [sys_attachment].Para determinar se o tipo de arquivo é compatível com sua instância, navegue até Propriedades do sistema , Segurança e verifique se ele está listado em Lista de extensões de arquivo (separadas por vírgulas) que podem ser anexadas campo. |
| CabeçadoRodaRodaInfo. Altura da imagem do rodapé | Cadeia de caracteres | Altura da imagem do rodapé. Padrão: 50 pontos |
| CabeçadoRodaRodaInfo. RodaTexto | Cadeia de caracteres | Texto do rodapé a ser colocado na parte inferior de cada página PDF. |
| CabeçadoRodaRodaInfo. Alinhamento de texto do rodapé | Cadeia de caracteres | Define a posição do texto no rodapé. Certifique-se de que este valor não corresponda ou entre em conflito com a área fornecida em headerFooterInfo.FooterImageAlignment. Valores válidos:
|
| CabeçadoRodaRodaInfo. GeneratePageNumber | Cadeia de caracteres | Sinalizador que indica se um número de página PDF deve ser gerado. Valores válidos:
Padrão: verdadeiro |
| CabeçadoRodaRodaInfo. HeaderImageAlignment | Cadeia de caracteres | Define a posição da imagem no cabeçalho. Valores válidos:
|
| CabeçadoRodaRodaInfo. HeaderImageAttachmentId | Cadeia de caracteres | Sys_id da imagem do cabeçalho na tabela Anexos [sys_attachment].Para determinar se o tipo de arquivo é compatível com sua instância, navegue até Propriedades do sistema , Segurança e verifique se ele está listado em Lista de extensões de arquivo (separadas por vírgulas) que podem ser anexadas campo. |
| CabeçadoRodaRodaInfo. HeaderImageHeight | Cadeia de caracteres | Altura da imagem do cabeçalho. Padrão: 50 pontos |
| CabeçadoRodaRodaInfo. OrRightMargin | Cadeia de caracteres | Tamanho das margens esquerda e direita. Se posicionados no lado esquerdo ou direito da página, os detalhes do cabeçalho/rodapé serão colocados nesta área. Padrão: 36 pontos |
| CabeçadoRodaRodaInfo. PageOrientation | Cadeia de caracteres | Orientação da página. Valores válidos:
Padrão: Retrato |
| CabeçadoRodaRodaInfo. Tamanho da página | Cadeia de caracteres | Tamanho da página do documento. Valores válidos:
O conteúdo será truncado se exceder o tamanho da página. |
| CabeçadoRodaRodaInfo. TopOrBottomMargin | Cadeia de caracteres | Tamanho das margens superior e inferior. Os detalhes do cabeçalho e rodapé são colocados nesta área. Padrão: 72 pontos |
| FontFamilySysId | Cadeia de caracteres | Opcional. Sys_id da família de fontes a ser usada para o PDF. Este sys_id é da tabela Família de fontes de geração de PDF [sys_pdf_generation_font_family]. Padrão: Nenhum |
| DocumentConfiguration | Objeto | Opcional. Objeto que contém uma configuração de sumário e uma configuração de número de página. |
| DocumentConfiguration.acessibilityHabilitado | Booliano | Opcional. Sinalizador que indica se o PDF gerado deve ser formatado para oferecer suporte à acessibilidade. Quando este recurso estiver habilitado, os marcadores de acessibilidade estarão disponíveis na árvore de marcadores de PDF para ajudar os usuários que dependem de leitores de tela a navegar, entender e interagir com os documentos PDF gerados. Valores válidos:
Padrão: Falso |
| DocumentConfiguration.toc_config | Cadeia de caracteres | Opcional. Sys_id da configuração do sumário a ser usada para o PDF. Este sys_id é da tabela Configuração do sumário [doc_toc_config]. Padrão: Nenhum |
| DocumentConfiguration.page_number_config | Cadeia de caracteres | Opcional. Sys_id da configuração de número de página a ser usada para o PDF. Este sys_id é da tabela Configuração do número da página [doc_page_number_config]. Padrão: Nenhum |
| Tipo | Descrição |
|---|---|
| Objeto | |
| <Object>. mensagem | Mensagem confirmando sucesso ou erro. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| <Object>.request_id | Sys_id do registro de solicitação do produtor de mudança . Tipo de dados: Cadeia de caracteres |
O exemplo a seguir mostra como enfileirar uma tarefa que converte HTML em PDF. O PDF contém cabeçalho e rodapé fornecidos por meio de anexo. Quando a conversão é concluída, o PDF chamado "myPDF" é anexado ao registro de destino na tabela Incidente [incidente].
var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
// (Option) get HTML from the description field of an incident record
var gr = new GlideRecord("incident");
var html;
if (gr.get("<tableSysId>")) {
html = gr.description.toString();
}
var hfInfo = new Object();
hfInfo["HeaderImageAttachmentId"] = "<hdrImgAttSysId>";
hfInfo["HeaderImageAlignment"] = "left";
hfInfo["FooterImageAttachmentId"] = "<ftrImgAttSysId>";
hfInfo["FooterImageAlignment"] = "TOP_CENTER";
hfInfo["FooterText"] = "Sample Footer Message";
hfInfo["PageSize"] = "A4";
hfInfo["GeneratePageNumber"] = "false";
hfInfo["TopOrBottomMargin"] = "36";
hfInfo["LeftOrRightMargin"] = "24";
var result = v.convertToPDFWithHeaderFooterAsync(html, "incident", "<targetTbl_sys_id>", "myPDF", hfInfo);
gs.info(JSON.stringify(result));
Saída:
{"message":"HTML to PDF Conversion is in progress.","request_id":"<sys_id>"}
PDFGenerationAPI – fillDocumentFields(Object fieldsMap, cadeia de caracteres SYSID, cadeia de caracteres tablename, cadeia de caracteres tablSysId, cadeia de caracteres pdfName)
Preenche campos em um PDF editável e o anexa ao registro fornecido.
- FillDocumentFieldsAndFlatten() . Preenche os campos em um PDF editável, nivela os campos de dados e os anexa ao registro fornecido.
- FillFieldsAndMergeSignature() . Preenche campos em um PDF editável, adiciona imagem de assinatura, nivela os campos de dados e os anexa ao registro fornecido.
- ObfilledDocumentWithSignatureAsBase64() . Preenche campos em um PDF editável, cria uma imagem e a converte em um PDF codificado em Base64.
| Nome | Tipo | Descrição |
|---|---|---|
| MapeoCampos | Objeto | Opcional. Mapa de valor de chave por nome de campo PDF e valor a ser preenchido. Use GetDocumentFields() método para obter a lista de campos disponíveis. |
| sysId | Cadeia de caracteres | Sys_id de um PDF na tabela Anexos [sys_attachment]. |
| tableName | 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]. |
| tableSysId | 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]. |
| PdfName | Cadeia de caracteres | Nome para fornecer o PDF. Padrão: Sys_id do PDF na tabela Anexos [sys_attachment]. |
| Tipo | Descrição |
|---|---|
| Objeto | Objeto que contém sys_id do anexo PDF atualizado, se bem-sucedido, caso contrário, mensagem de erro. |
| <Object>. attachment_id | Se a operação for bem-sucedida, sys_id do PDF preenchido. O arquivo está listado na tabela Anexos [sys_attachment]. Tipo de dados: Cadeia de caracteres |
| <Object>.message | Mensagem confirmando sucesso ou erro. Valores válidos:
Tipo de dados: Cadeia de caracteres |
| <Object>.status | Status que indica se a operação foi bem-sucedida. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
O exemplo a seguir mostra como preencher campos em um PDF editável.
var fieldMap = new Object();
fieldMap["Address"] = "Address value here";
fieldMap["State"] = "State value here";
var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
var result = v.fillDocumentFields(fieldMap, "<attachmentSysId>", "<tableName>", "<tableSysId>", "pdfName");
gs.info(JSON.stringify(result));
Saída:
{"attachment_id":"<sys_id>","message":"Request completed successfully.","status":"success"}
PDFGenerationAPI – fillDocumentFieldsAndFlatten(Object fieldsMap, cadeia de caracteres SYSID, cadeia de caracteres tablename, cadeia de caracteres tablename, cadeia de caracteres tableSysId, cadeia de caracteres pdfName, achatar objeto)
Preenche os campos em um PDF editável, nivela os campos de dados e os anexa ao registro fornecido.
- FillDocumentFields() . Preenche campos em um PDF editável e o anexa ao registro fornecido.
- FillFieldsAndMergeSignature() . Preenche campos em um PDF editável, adiciona imagem de assinatura, nivela os campos de dados e os anexa ao registro fornecido.
- ObfilledDocumentWithSignatureAsBase64() . Preenche campos em um PDF editável, cria uma imagem e a converte em um PDF codificado em Base64.
| Nome | Tipo | Descrição |
|---|---|---|
| MapeoCampos | Objeto | Opcional. Mapa de valor de chave por nome de campo PDF e valor a ser preenchido. Use GetDocumentFields() método para obter a lista de campos disponíveis. |
| sysId | Cadeia de caracteres | Sys_id de um PDF na tabela Anexos [sys_attachment]. |
| tableName | 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]. |
| tableSysId | 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]. |
| PdfName | Cadeia de caracteres | Nome para fornecer o PDF. Padrão: Sys_id do PDF na tabela Anexos [sys_attachment]. |
| nivelar | Objeto | Opcional. O nivelamento de campos permite bloquear os campos para que outros usuários não possam alterar as informações. Especifique a chave como "FlattenType" e forneça uma opção de nivelamento como uma cadeia de caracteres. Valores válidos:
Padrão: Fully_flatten |
| Tipo | Descrição |
|---|---|
| Objeto | Objeto que contém sys_id do anexo PDF atualizado, se bem-sucedido, caso contrário, mensagem de erro. |
| <Object>. attachment_id | Se a operação for bem-sucedida, sys_id do PDF preenchido. O arquivo está listado na tabela Anexos [sys_attachment]. Tipo de dados: Cadeia de caracteres |
| <Object>.message | Mensagem confirmando sucesso ou erro. Valores válidos:
Tipo de dados: Cadeia de caracteres |
| <Object>.status | Status que indica se a operação foi bem-sucedida. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
O exemplo a seguir mostra como preencher campos e nivelar um PDF editável.
var fieldMap = new Object();
fieldMap["Last Name First Name Middle Initial"] = "Tuter Abel E.";
fieldMap["Date of Birth"] = "08101952";
fieldMap["US SSN"] = "111-22-9999";
fieldMap["Address"] = "PO Box 344";
fieldMap["City"] = "Jerome";
fieldMap["State"] = "AZ";
fieldMap["Zip"] = "86331";
var flatten = new Object();
flatten["FlattenType"] = "partially_flatten";
var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
var result = v.fillDocumentFieldsAndFlatten(fieldMap, "<attachmentSysId>", "<tableName>", "<tableSysId>", "pdfName", flatten);
gs.info(JSON.stringify(result));
Saída:
"attachment_id":"<sys_id>","message":"Request completed successfully.","status":"success"
PDFGenerationAPI – fillFieldsAndMergeSignature(Object fieldsMap, cadeia de caracteres SYSID, cadeia de caracteres tablename, cadeia de caracteres tablename, cadeia de caracteres tableSysId, cadeia de caracteres pdfName, Solicitante de PdfMergeSignSolicitante, nivelar objeto)
Preenche campos em um PDF editável, adiciona imagem de assinatura, nivela os campos de dados e os anexa ao registro fornecido.
- FillDocumentFields() . Preenche campos em um PDF editável e o anexa ao registro fornecido.
- FillDocumentFieldsAndFlatten() . Preenche os campos em um PDF editável, nivela os campos de dados e os anexa ao registro fornecido.
- ObfilledDocumentWithSignatureAsBase64() . Preenche campos em um PDF editável, cria uma imagem e a converte em um PDF codificado em Base64.
| Nome | Tipo | Descrição |
|---|---|---|
| MapeoCampos | Objeto | Opcional. Mapa de valor de chave por nome de campo PDF e valor a ser preenchido. Use GetDocumentFields() método para obter a lista de campos disponíveis. |
| sysId | Cadeia de caracteres | Sys_id de um PDF na tabela Anexos [sys_attachment]. |
| tableName | 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]. |
| tableSysId | 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]. |
| PdfName | Cadeia de caracteres | Nome para fornecer o PDF. Padrão: Sys_id do PDF na tabela Anexos [sys_attachment]. |
| solicitante | Solicitante do PdfMergeSign | Entrada de assinatura retornada de PdfMergeSignSolicitante . |
| nivelar | Objeto | Opcional. O nivelamento de campos permite bloquear os campos para que outros usuários não possam alterar as informações. Especifique a chave como "FlattenType" e forneça uma opção de nivelamento como uma cadeia de caracteres. Valores válidos:
Padrão: Fully_flatten |
| Tipo | Descrição |
|---|---|
| Objeto | Objeto que contém sys_id do anexo PDF atualizado, se bem-sucedido, caso contrário, mensagem de erro. |
| <Object>. attachment_id | Se a operação for bem-sucedida, sys_id do PDF preenchido. O arquivo está listado na tabela Anexos [sys_attachment]. Tipo de dados: Cadeia de caracteres |
| <Object>.message | Mensagem confirmando sucesso ou erro. Valores válidos:
Tipo de dados: Cadeia de caracteres |
| <Object>.status | Status que indica se a operação foi bem-sucedida. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
O exemplo a seguir mostra como preencher campos com assinatura com configurações padrão para nivelar completamente os campos.
var fieldMap = new Object();
fieldMap["Address_Salutation"] = "Address value here";
var paramMap = new Object();
paramMap["FlattenType"] = "partially_flatten";
var requestor = new sn_pdfgeneratorutils.PdfMergeSignRequestor;
requestor.createRequest("<attachmentSysId>", "incident", "<tableSysId>", "filledPdf");
requestor.addSignatureMapping(6, 40, 50, 188, 44, "<signatureSysId>");
var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
var result = v.fillFieldsAndMergeSignature(fieldMap, "<attachmentSysId>", "incident", "<tableSysId>", requestor, "filledPdf", paramMap);
gs.info(JSON.stringify(result));
{"attachment_id":"5440d993dbed3010d66be1191396194e","message":"Request completed successfully.","status":"success"}PDFGenerationAPI – getDocumentFields (cadeia de caracteres SYSID)
Obtém uma lista de campos editáveis em um documento PDF. Permite listar campos PDF editáveis sem abrir manualmente o arquivo para verificar.
| Nome | Tipo | Descrição |
|---|---|---|
| sysId | Cadeia de caracteres | Sys_id de um PDF na tabela Anexos [sys_attachment]. |
| Tipo | Descrição |
|---|---|
| Objeto | Objeto que contém o ID do PDF assinado, caso contrário, mensagem de erro. |
| <Object>.campos | Se a solicitação for bem-sucedida, lista contendo o nome de cada campo no PDF. Tipo de dados: Matriz de cadeias de caracteres |
| <Object>.message | Mensagem confirmando sucesso ou erro. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| <Object>.status | Status que indica se a operação foi bem-sucedida. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
O exemplo a seguir mostra como recuperar campos em um anexo PDF.
var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
var result = v.getDocumentFields("attachmentSysId");
gs.info(JSON.stringify(result));
Saída:
{"message":"Request completed successfully.","fields":["NP_formFillable","reset","print","1SSN","Signature.1","5sigDate","Check Box21"],"status":"success"}
PDFGenerationAPI – getDocumentFieldsType(cadeia de caracteres SYSID)
Obtém o tipo de campo do conjunto de campos editáveis de um documento PDF.
| Nome | Tipo | Descrição |
|---|---|---|
| sysId | Cadeia de caracteres | Sys_id de um PDF na tabela Anexos [sys_attachment]. |
| Tipo | Descrição |
|---|---|
| Objeto | Objeto que contém cada tipo de campo PDF, se bem-sucedido, caso contrário, mensagem de erro. |
| <Object>.fields_type | Objeto que lista cada campo no PDF especificado, se bem-sucedido, caso contrário, mensagem de erro. Tipo de dados: Objeto |
| <Object>.fields_type. <field> | Objeto que contém o número de página de cada campo. O <field> nome do campo representa o rótulo do campo, por exemplo, "SSN" ou um rótulo automatizado que representa o tipo. Tipo de dados: Objeto |
| <Object>.fields_type. Detalhes.Campos <field> | Lista de objetos que contém o nome do campo e o valor correspondente de cada opção para tipos de campo de escolha. Tipos aplicáveis:
Tipo de dados: Matriz |
| <Object>.fields_type. FieldsDetalesDentesDepoCampo.NomeCampo <field> | Nome de um campo de seleção. Tipo de dados: Cadeia de caracteres |
| <Object>.fields_type. NomeDetaDetaDepoDentosCampos.Valor <field> | Valor de um campo de opção. Tipo de dados: Cadeia de caracteres |
| <Object>.fields_type. <field>.pagenumber | Número da página do PDF correspondente a este campo. Tipo de dados: Cadeia de caracteres |
| <Object>.fields_type. <field>.type | Tipo de campo PDF. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| <Object>.message | Mensagem confirmando sucesso ou erro. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| <Object>.status | Status que indica se a operação foi bem-sucedida. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
O exemplo a seguir mostra como recuperar tipos de campo em um anexo PDF. Os resultados incluem retornos manuais para legibilidade e são truncados para brevidade.
var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
var result = v.getDocumentFieldsType("<attachmentSysId>");
gs.info(JSON.stringify(result));
Saída:
{"fields_type":{"1ADDLINE2.25":{"pageNumber":2,"type":"text"},"1ADDLINE2.24":{"pageNumber":2,"type":"text"},
"1ADDLINE2.23":{"pageNumber":2,"type":"text"},"1ADDLINE2.22":{"pageNumber":2,"type":"text"},
"1ADDLINE2.11":{"pageNumber":2,"type":"text"},
"Check Box1":{"fieldsDetails":[{"fieldName":"Yes"}],"pageNumber":2,"type":"check_box"},
"4consentDate.6":{"pageNumber":4,"type":"text"},"4consentDate.7":{"pageNumber":4,"type":"text"},
"3SSN.9":{"pageNumber":3,"type":"text"},"3SSN.8":{"pageNumber":3,"type":"text"},"3SSN.7":{"pageNumber":3,"type":"text"},
"pageNumber":2,"type":"check_box"},"Check Box8":{"fieldsDetails":[{"fieldName":"Off"},{"fieldName":"yes"}],
"4planAdminDate.8":{"pageNumber":4,"type":"text"},"4planAdminDate.7":{"pageNumber":4,"type":"text"},
"1FirstName_ID.7":{"pageNumber":2,"type":"text"},
"Check Box9":{"fieldsDetails":[{"fieldName":"Yes"}],"pageNumber":3,"type":"check_box"},
"1LN.1":{"pageNumber":2,"type":"text"},"1LN.2":{"pageNumber":2,"type":"text"},
"Check Box11":{"fieldsDetails":[{"fieldName":"Yes"}],"pageNumber":3,"type":"check_box"},
"1LN.9":{"pageNumber":2,"type":"text"},
"Check Box17":{"fieldsDetails":[{"fieldName":"Yes"}],"pageNumber":3,"type":"check_box"},
"Check Box16":{"fieldsDetails":[{"fieldName":"Yes"}],"pageNumber":3,"type":"check_box"},
"1LN.7":{"pageNumber":2,"type":"text"},"Check Box19":{"fieldsDetails":[{"fieldName":"Yes"}],
"1LN.8":{"pageNumber":2,"type":"text"},"Check Box18":{"fieldsDetails":[{"fieldName":"Yes"}],
"print":{"pageNumber":2,"type":"push_button"},"4planAdministrator.1":{"pageNumber":4,"type":"text"},
"1TaxID.9":{"pageNumber":2,"type":"text"},"4SSN.1":{"pageNumber":3,"type":"text"},"4SSN.2":{"pageNumber":3,"type":"text"},
"Signature.1":{"pageNumber":4,"type":"text"},"1ZIP.2":{"pageNumber":2,"type":"text"},"1ZIP.3":{"pageNumber":2,"type":"text"},
"message":"Request completed successfully.","status":"success"}
PDFGenerationAPI – getFilledDocumentWithSignatureAsBase64(Object fieldsMap, cadeia de caracteres SYSID, PdfMergeSignSolicitante, objeto planificado)
Preenche campos em um PDF editável, cria uma imagem e a converte em um PDF codificado em Base64.
A codificação base64 permite gerar um PDF como uma cadeia de caracteres em um documento de texto, como HTML ou JSON, sem danificar a sintaxe de caracteres binários.
- FillDocumentFields() . Preenche campos em um PDF editável e o anexa ao registro fornecido.
- FillDocumentFieldsAndFlatten() . Preenche os campos em um PDF editável, nivela os campos de dados e os anexa ao registro fornecido.
- FillFieldsAndMergeSignature() . Preenche campos em um PDF editável, adiciona imagem de assinatura, nivela os campos de dados e os anexa ao registro fornecido.
| Nome | Tipo | Descrição |
|---|---|---|
| MapeoCampos | Objeto | Opcional. Mapa de valor de chave por nome de campo PDF e valor a ser preenchido. Use GetDocumentFields() método para obter a lista de campos disponíveis. |
| sysId | Cadeia de caracteres | Sys_id de um PDF na tabela Anexos [sys_attachment]. |
| solicitante | Solicitante do PdfMergeSign | Entrada de assinatura retornada de PdfMergeSignSolicitante . |
| nivelar | Objeto | Opcional. O nivelamento de campos permite bloquear os campos para que outros usuários não possam alterar as informações. Especifique a chave como "FlattenType" e forneça uma opção de nivelamento como uma cadeia de caracteres. Valores válidos:
Padrão: Fully_flatten |
| Tipo | Descrição |
|---|---|
| Cadeia de caracteres | Se for bem-sucedido, o PDF convertido para o formato Base64 será adicionado à tabela Anexos [sys_attachment]. O conteúdo reflete o anexo PDF fornecido com campos e assinatura preenchidos. Os campos não são editáveis, a menos que uma opção de nivelamento alternativa tenha sido fornecida com flattenparâmetro. |
| <Object>.message | Mensagem confirmando sucesso ou erro. Valores válidos:
Tipo de dados: Cadeia de caracteres |
| <Object>.status | Status que indica se a operação foi bem-sucedida. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
O exemplo a seguir mostra como carregar dois campos em um anexo PDF, nivelar os campos e converter o PDF para o formato Base64.
var mymap = new Object();
mymap["City"] = "City value here";
mymap["State"] = "XX";
// create a requestor
var requestor = new sn_pdfgeneratorutils.PdfMergeSignRequestor;
requestor.createRequest("<sys_id>", "tableName", "<tableSysId>", "pdfName");
requestor.addSignatureMapping(6, 40, 50, 188, 44, "<signImgSysId>");
var processedRequestObj = requestor.processRequest();
var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
var result = v.getFilledDocumentWithSignatureAsBase64(mymap, "<attachmentSysId>", processedRequestObj);
gs.info (JSON.stringify(result));
PDFGenerationAPI – getPdfPageSizes(cadeia de caracteres SYSID)
Obtém o tamanho da página de um documento PDF.
| Nome | Tipo | Descrição |
|---|---|---|
| sysId | Cadeia de caracteres | Sys_id de um PDF na tabela Anexos [sys_attachment]. |
| Tipo | Descrição |
|---|---|
| Objeto | Objeto que contém o tamanho de cada página, se bem-sucedido, caso contrário, mensagem de erro. |
| <Object>.pages_size | Se a operação for bem-sucedida, a largura e a altura de cada página PDF em pontos. O número da página é retornado como uma cadeia de caracteres e os valores de medição são retornados como tipos de dados numéricos. Tipo de dados: Objeto |
| <Object>.message | Mensagem confirmando sucesso ou erro. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| <Object>.status | Status que indica se a operação foi bem-sucedida. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
O exemplo a seguir mostra como exibir a largura e a altura de cada página em um anexo PDF.
var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
var result = v.getPdfPageSizes ("<attachmentSysId>");
gs.info(JSON.stringify(result));
Saída:
{"pages_size":{"1":[612,792],"2":[612,792],"3":[612,792],"4":[612,792],"5":[612,792]},"message":"Request completed successfully.","status":"success"}
PDFGenerationAPI – isDocumentFillable(cadeia de caracteres SYSID)
Verifica se o documento PDF contém campos editáveis.
| Nome | Tipo | Descrição |
|---|---|---|
| sysId | Cadeia de caracteres | Sys_id de um PDF na tabela Anexos [sys_attachment]. |
| Tipo | Descrição |
|---|---|
| Objeto | Objeto que contém o tamanho de cada página, se bem-sucedido, caso contrário, mensagem de erro. |
| <Object>. document_editable | Se a operação for bem-sucedida, sinalize indicando se o documento é editável. Valores válidos:
Tipo de dados: Valor booliano fornecido como uma cadeia de caracteres |
| <Object>.message | Mensagem confirmando sucesso ou erro. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
| <Object>.status | Status que indica se a operação foi bem-sucedida. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
O exemplo a seguir mostra como determinar se os campos de documento PDF são editáveis.
var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
var result = v.isDocumentFillable("<attachmentSysId>");
gs.info(JSON.stringify(result));
Saída:
{"message":"Request completed successfully.","document_editable":"true","status":"success"}
PDFGenerationAPI – Reeditar(Object inputJson)
Aplica a edição a um documento PDF com base nas coordenadas de retângulo fornecidas, nas palavras-chave de pesquisa ou em ambos. Uma cópia editada do PDF original é gerada na tabela Anexos [sys_attachment].
- Os resultados da edição podem incluir um bloco de texto censurado em branco inesperado que substitui o texto não destinado a ser censurado. Se esse evento ocorrer, você poderá selecionar manualmente o conteúdo para edição usando highlightedSectionsOu o plug-in Utilitários de geração de PDF. Para obter mais informações, consulte Redact data from documents.
- Este método não é compatível com a edição em PDFs que contêm imagens JBIG2.
| Nome | Tipo | Descrição |
|---|---|---|
| inputJson | Objeto | Identifica o PDF e seu conteúdo a ser editado. |
| InputJson.SYSID | Cadeia de caracteres | Sys_id de um PDF na tabela Anexos [sys_attachment]. |
| InputJson. Realçadas | Matriz de objetivos | Lista de coordenadas de retângulos fornecidas como um objeto. Cada coordenada representa o local do conteúdo a ser editado em cada página. Opcional se incluir searchedKeywordspropriedade. |
| InputJson. Realçadas. Número de página | Número | Número da página do PDF que contém o conteúdo a ser selecionado para edição. |
| InputJson. Realçadas. x | Número | O eixo X (posição horizontal) do retângulo de edição no PDF em pontos. O valor no canto inferior esquerdo da página PDF é 0. Por exemplo, um valor de 306 Coloca o retângulo aproximadamente no centro horizontal de uma página PDF tamanho carta. |
| InputJson. Realçadas. . | Número | O eixo Y (posição vertical) do retângulo de edição no PDF em pontos. O valor no canto inferior esquerdo da página PDF é 0. Por exemplo, um valor de 396 Coloca o retângulo aproximadamente no centro vertical de uma página PDF tamanho carta. |
| InputJson. Realçadas. largura | Número | A largura do retângulo de edição é em pontos. Este valor aumenta o tamanho do retângulo horizontalmente a partir do ponto inferior esquerdo no qual os eixos x e y se cruzam. |
| InputJson. Realçadas. altura | Número | Altura do retângulo de edição em pontos. Este valor aumenta o tamanho do retângulo verticalmente a partir do ponto inferior esquerdo no qual os eixos x e y se cruzam. |
| InputJson. PesquisarchedPalavras-chave | Matriz | Lista de uma ou mais cadeias de caracteres usadas para encontrar texto para edição. O tamanho do retângulo de edição corresponde à altura e à largura do texto que é bloqueado como resultado. Opcional se incluir highlightedSectionspropriedade. Nota: Em alguns casos, cadeias de caracteres de texto que contêm caracteres especiais ou pontuação, como "itens:" e. "PDF." não foram editados. Como alternativa, você pode remover o caractere da cadeia de caracteres ou realçar a área para remover o texto. |
| Tipo | Descrição |
|---|---|
| Objeto | Objeto que contém sys_id do anexo PDF atualizado, se bem-sucedido, caso contrário, mensagem de erro. |
| <Object>. attachment_id | Se a operação for bem-sucedida, sys_id do PDF preenchido. 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:
Tipo de dados: Cadeia de caracteres |
| <Object>.status | Status que indica se a operação foi bem-sucedida. Valores possíveis:
Tipo de dados: Cadeia de caracteres |
O exemplo a seguir mostra como editar por retângulo e palavra-chave. No PDF censurado, as áreas selecionadas na página 2 são bloqueadas. A cadeia de caracteres "23" é editada em qualquer página em que é encontrada.
var pdfRequest = {
sysId: 'e4b3ae35fc128210f877789781ea59f3',
highlightedSections: [
{
"pageNumber": 2,
"x": 261.75,
"y": 480,
"width": 21,
"height": 14.25
},
{
"pageNumber": 2,
"x": 249,
"y": 390.75,
"width": 63.75,
"height": 15.75
}
// Add more coordinates as needed
],
searchedKeywords: ['23']
};
// Convert the JSON object to a string
var jsonRequest = JSON.stringify(pdfRequest);
gs.info('JSON Request: ' + jsonRequest + '\n');
var PDFRedaction = new sn_pdfgeneratorutils.PDFGenerationAPI;
var result = PDFRedaction.redact(jsonRequest);
gs.info(JSON.stringify(result));
Saída:
JSON Request: {"sysId":"e4b3ae35fc128210f877789781ea59f3","highlightedSections":[{"pageNumber":2,"x":261.75,"y":480,"width":21,"height":14.25},{"pageNumber":2,"x":249,"y":390.75,"width":63.75,"height":15.75}],"searchedKeywords":[23]}
{"attachment_id":"1744ae35fc128210f877789781ea59fc","message":"Request completed successfully.","status":"success"}