Escopo - Global

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

    • Cria um objeto de parágrafo que representa um bloco de texto em um 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.

    Esta API é um componente usado com API de documento Para gerar um PDF.

    Parágrafo - Parágrafo (texto de cadeia de caracteres)

    Instancia um novo Parágrafo objeto que contém uma cadeia de caracteres.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    texto Cadeia de caracteres Bloco de texto de parágrafo.

    O exemplo a seguir mostra como criar um Parágrafo objeto. Para obter um exemplo de uso de documento, consulte Documento API. 

    var para = new Paragraph("hello");

    AddNewLine()

    Adiciona uma linha vazia após um parágrafo em um documento.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 3. Retorna
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como adicionar uma nova linha após um parágrafo em um documento. Para obter um exemplo de uso de documento, consulte Documento API. 

    var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
        
var myPara = new sn_pdfgeneratorutils.Paragraph("This is a paragraph.");
myPara.addNewLine();

document.addParagraph(myPara);       
// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<record_sys_id>", "addText.pdf");

    AddParagraph(parágrafo de parágrafo)

    Adiciona um parágrafo. Você pode usar este método para criar um bloco de parágrafos com quebras de linha automáticas.

    Tabela 4. Parâmetros
    Nome Tipo Descrição
    parágrafo Parágrafo Objeto de parágrafo.
    Tabela 5. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como adicionar uma seção de parágrafos a um documento. Para obter um exemplo de uso de documento, consulte Documento API. 

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

var sectionPara = new sn_pdfgeneratorutils.Paragraph("This is the first paragraph.");
var subPara1 = new sn_pdfgeneratorutils.Paragraph("Pellentesque nec neque interdum turpis ultricies tristique at ut lacus. Nam eget sollicitudin.");
var subPara2 = new sn_pdfgeneratorutils.Paragraph("Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla vel ultrices erat.");
var subPara3 = new sn_pdfgeneratorutils.Paragraph("Aenean fermentum lorem congue metus faucibus, vitae viverra quam eleifend. Donec sed risus quis eros suscipit efficitur.");

sectionPara.addParagraph(subPara1);
sectionPara.addParagraph(subPara2);
sectionPara.addParagraph(subPara3);

document.addParagraph(sectionPara);

// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<record_sys_id>", "filename.pdf");

    AddString (conteúdo da cadeia de caracteres)

    Adiciona uma cadeia de caracteres de texto a um parágrafo. Este método não insere automaticamente um espaço antes do conteúdo.

    Tabela 6. Parâmetros
    Nome Tipo Descrição
    conteúdo Cadeia de caracteres Informações a serem incluídas em um parágrafo.
    Tabela 7. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como adicionar uma nova frase a um parágrafo. Para obter um exemplo de uso de documento, consulte Documento API. 

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

var myPara = new sn_pdfgeneratorutils.Paragraph("This is the first sentence.");

myPara.addString(" This is the second sentence in the same paragraph. Spaces are not inserted automatically.")

document.addParagraph(myPara);

// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<record_sys_id>", "filename.pdf");

    AddStyle(estilo de estilo)

    Aplica um estilo predefinido ao texto do parágrafo.

    Tabela 8. Parâmetros
    Nome Tipo Descrição
    estilo Estilo Estilo a ser aplicado a este elemento.
    Tabela 9. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como aplicar um estilo a um parágrafo. Para obter um exemplo de uso de documento, consulte Documento API. 

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

// Create a font color (result is purple)
var fontColor = new sn_pdfgeneratorutils.Color([0.5,0.0,0.5]);

// Create a style for your paragraph
var paraStyle = new sn_pdfgeneratorutils.Style();
paraStyle.setFontColor(fontColor);
paraStyle.setFontSize(10);

var myPara = new sn_pdfgeneratorutils.Paragraph("This paragraph has style.");

myPara.addStyle(paraStyle);


document.addParagraph(myPara);

// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<record_sys_id>", "addStyle.pdf");

    SetFixedPosition (número à esquerda, número inferior, número largura do número)

    Define um elemento de parágrafo para uma posição fixa na página.

    Tabela 10. Parâmetros
    Nome Tipo Descrição
    esquerda Número Recuo do lado esquerdo da página PDF em pontos.
    parte inferior Número Posição a partir da parte inferior da página PDF em Pontos.
    largura Número Largura do elemento de parágrafo em pontos. Este valor determina o comprimento no qual a linha quebra.
    Tabela 11. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir uma posição fixa em uma página. Para obter um exemplo de uso de documento, consulte Documento API. 

    var pageSize = new sn_pdfgeneratorutils.PdfPage("A4");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

// Create a style
var paraStyle = new sn_pdfgeneratorutils.Style();
paraStyle.setFontSize(48);
paraStyle.setBold();

// my paragraph
var para = new sn_pdfgeneratorutils.Paragraph("Document Title");

para.setFixedPosition(204,400,240);

para.setTextAlignment("text-center");
para.addStyle(paraStyle);


document.addParagraph(para);

// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<record_sys_id>", "fileName.pdf");

    Parágrafo – setMargin(margem numérica)

    Define cada margem de parágrafo.

    Para definir todas as quatro margens com um ou mais valores exclusivos, use SetMargins() .

    Tabela 12. Parâmetros
    Nome Tipo Descrição
    margem Número Valor das margens superior, direita, inferior e esquerda em pontos.
    Tabela 13. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir todas as margens do parágrafo como 48 pontos.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

var margins = 48.0;

var myPara = new sn_pdfgeneratorutils.Paragraph("Paragraph text with all margins set to the same value.");
myPara.setMargin(margins);

document.addParagraph(myPara);

// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<record_sys_id>", "docName.pdf");

    Parágrafo – setMarginBottom(margem numérica)

    Define a margem inferior de um parágrafo.

    Tabela 14. Parâmetros
    Nome Tipo Descrição
    margem Número Altura da margem inferior em pontos.
    Tabela 15. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir a margem inferior de um parágrafo como um ponto.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

var marginVal = 1.0;

var paraMarginBottom = new sn_pdfgeneratorutils.Paragraph("Paragraph text with bottom margin set.");
paraMarginBottom.setMarginBottom(marginVal);

document.addParagraph(paraMarginBottom);

// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<record_sys_id>", "docName.pdf");

    Parágrafo – setMarginLeft(margem numérica)

    Define a margem esquerda de um parágrafo.

    Tabela 16. Parâmetros
    Nome Tipo Descrição
    Margem esquerda Número Largura da margem esquerda em pontos.
    Tabela 17. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir a margem esquerda de um parágrafo como um ponto.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

var marginVal = 1.0;

var paraMarginLeft = new sn_pdfgeneratorutils.Paragraph("Paragraph text with left margin set.");
paraMarginLeft.setMarginLeft(marginVal);

document.addParagraph(paraMarginLeft);

// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<record_sys_id>", "docName.pdf");

    Parágrafo – setMarginRight(margem numérica)

    Define a margem direita de um parágrafo.

    Tabela 18. Parâmetros
    Nome Tipo Descrição
    margem Número Largura da margem direita em pontos.
    Tabela 19. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir a margem direita de um parágrafo como um ponto.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

var marginVal = 1.0;

var paraMarginRight = new sn_pdfgeneratorutils.Paragraph("Paragraph text with right margin set.");
paraMarginRight.setMarginRight(marginVal);

document.addParagraph(paraMarginRight);

// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<record_sys_id>", "docName.pdf");

    Parágrafo – setMargins(Número marginTop, Número marginRight, Número marginBottom, Número marginLeft)

    Define um tamanho para cada margem de parágrafo.

    Para definir cada margem com o mesmo valor, use SetMargin() .

    Tabela 20. Parâmetros
    Nome Tipo Descrição
    TopMargin Número Altura da margem superior em pontos.
    Margem direita Número Largura da margem direita em pontos.
    BottomMargin Número Altura da margem inferior em pontos.
    Margem esquerda Número Largura da margem esquerda em pontos.
    Tabela 21. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir margens de parágrafo.Para obter um exemplo de uso de documento, consulte Documento API. 

    var para = new sn_pdfgeneratorutils.Paragraph("Paragraph text.");

var topMargin = 1.0;
var rightMargin = 1.0;
var bottomMargin = 1.0;
var leftMargin = 1.5;

para.setMargins(marginTop, marginRight, marginBottom, marginLeft);

    Parágrafo – setMarginTop(margem numérica)

    Define a margem superior de um parágrafo.

    Tabela 22. Parâmetros
    Nome Tipo Descrição
    margem Número Altura da margem superior em pontos.
    Tabela 23. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir a margem superior de um parágrafo como um ponto.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);

var marginVal = 1.0;

var paraMarginTop = new sn_pdfgeneratorutils.Paragraph("Paragraph text with top margin set.");
paraMarginTop.setMarginTop(marginVal);

document.addParagraph(paraMarginTop);

// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<record_sys_id>", "docName.pdf");

    SetTextAlignment(alinhamento de cadeia de caracteres)

    Define o alinhamento do texto deste parágrafo.

    Tabela 24. Parâmetros
    Nome Tipo Descrição
    alinhamento Cadeia de caracteres Posição de alinhamento do texto.
    Valores válidos:
    • Text-center: Alinha o texto ao centro.
    • Texto justificado: Modifica o espaço entre caracteres para preencher completamente o texto entre os lados esquerdo e direito. A linha final é alinhada à esquerda.
    • Text-justified-all: Justifica o alinhamento do texto, incluindo a linha final.
    • Text-left: Alinha o texto à esquerda.
    • Text-right: Alinha o texto à direita.
    Tabela 25. Retornos
    Tipo Descrição
    Nenhum(a)

    O exemplo a seguir mostra como definir o texto do parágrafo como alinhamento à esquerda.

    var paragraph = new sn_pdfgeneratorutils.Paragraph("This paragraph text is centered.");
        
var alignment = "text-center";
       
paragraph.setTextAlignment(alignment);