---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Absatz: Umfang, Global

# Absatz: Umfang, Global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 Minuten Lesedauer

Erstellt ein Absatzobjekt, das einen Textblock in einer PDF darstellt.

Diese API ist Teil von ServiceNowPDF-Generierungsdienstprogramme-Plugin (com.snc.apppdfgenerator) und wird in bereitgestellt `sn_pdfgeneratorutils `Namespace. Das Plugin ist standardmäßig aktiviert.

Diese API ist eine Komponente, die mit verwendet wird [Dokument-API](https://servicenow-prod.fluidtopics.net/tUwTjwhc8qeiH0if1DLMOQ#DocumentBothAPI "Die Dokument Die API bietet Methoden zum Initialisieren einer PDF, Hinzufügen von Inhalten und Schließen der PDF. Nach dem Hinzufügen von Inhalten kann das Dokument an einen Zieldatensatz angehängt werden.")Dient zum Generieren einer PDF.

## Absatz -- Absatz (Zeichenfolgentext) {#ariaid-title2}

Instanziiert eine neue Absatz Objekt, das eine Zeichenfolge enthält.
{#Paragraph-Paragraph_S__table_twm_hjk_34b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| HTML | Zeichenfolge | Absatzblock des Texts. |
[Tabelle : 1. Parameter]

{#Paragraph-Paragraph_S__table_twm_hjk_34b}  
Das folgende Beispiel zeigt, wie ein erstellt wird Absatz Objekt. Ein Beispiel für die Dokumentnutzung finden Sie unter [Dokument](https://servicenow-prod.fluidtopics.net/tUwTjwhc8qeiH0if1DLMOQ#DocumentBothAPI "Die Dokument Die API bietet Methoden zum Initialisieren einer PDF, Hinzufügen von Inhalten und Schließen der PDF. Nach dem Hinzufügen von Inhalten kann das Dokument an einen Zieldatensatz angehängt werden.")API.

    var para = new Paragraph("hello");

## Absatz -- addNewLine() {#ariaid-title3}

Fügt eine leere Zeile nach einem Absatz in einem Dokument hinzu.
{#Paragraph-addNewLine__table_vv5_52h_44b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 2. Parameter]

{#Paragraph-addNewLine__table_vv5_52h_44b} {#Paragraph-addNewLine__table_wv5_52h_44b__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Rückgaben]

{#Paragraph-addNewLine__table_wv5_52h_44b}  
Das folgende Beispiel zeigt, wie nach einem Absatz in einem Dokument eine neue Zeile hinzugefügt wird. Ein Beispiel für die Dokumentnutzung finden Sie unter [Dokument](https://servicenow-prod.fluidtopics.net/tUwTjwhc8qeiH0if1DLMOQ#DocumentBothAPI "Die Dokument Die API bietet Methoden zum Initialisieren einer PDF, Hinzufügen von Inhalten und Schließen der PDF. Nach dem Hinzufügen von Inhalten kann das Dokument an einen Zieldatensatz angehängt werden.")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");

## Absatz -- addParagraph (Absatz) {#ariaid-title4}

Fügt einen Absatz hinzu. Sie können diese Methode verwenden, um einen Block von Absätzen mit automatischen Zeilenumbrüchen zu erstellen.
{#Paragraph-addParagraph_O__table_vv5_52h_44b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Absatz | [Absatz](https://servicenow-prod.fluidtopics.net/Gjs8RFO4IXvCA8uJ5CgZsA#Paragraph-Paragraph_S "Instanziiert eine neue Absatz Objekt, das eine Zeichenfolge enthält.") | Absatzobjekt. |
[Tabelle : 4. Parameter]

{#Paragraph-addParagraph_O__table_vv5_52h_44b} {#Paragraph-addParagraph_O__table_wv5_52h_44b__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Rückgaben]

{#Paragraph-addParagraph_O__table_wv5_52h_44b}  
Das folgende Beispiel zeigt, wie einem Dokument ein Abschnitt von Absätzen hinzugefügt wird. Ein Beispiel für die Dokumentnutzung finden Sie unter [Dokument](https://servicenow-prod.fluidtopics.net/tUwTjwhc8qeiH0if1DLMOQ#DocumentBothAPI "Die Dokument Die API bietet Methoden zum Initialisieren einer PDF, Hinzufügen von Inhalten und Schließen der PDF. Nach dem Hinzufügen von Inhalten kann das Dokument an einen Zieldatensatz angehängt werden.")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");

## Absatz -- addString(Zeichenfolgeninhalt) {#ariaid-title5}

Fügt einem Absatz eine Textzeichenfolge hinzu. Mit dieser Methode wird nicht automatisch ein Leerzeichen vor dem Inhalt eingefügt.
{#Paragraph-addString_S__table_vv5_52h_44b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Content | Zeichenfolge | Informationen, die in einen Absatz aufgenommen werden sollen. |
[Tabelle : 6. Parameter]

{#Paragraph-addString_S__table_vv5_52h_44b} {#Paragraph-addString_S__table_wv5_52h_44b__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 7. Rückgaben]

{#Paragraph-addString_S__table_wv5_52h_44b}  
Das folgende Beispiel zeigt, wie einem Absatz ein neuer Satz hinzugefügt wird. Ein Beispiel für die Dokumentnutzung finden Sie unter [Dokument](https://servicenow-prod.fluidtopics.net/tUwTjwhc8qeiH0if1DLMOQ#DocumentBothAPI "Die Dokument Die API bietet Methoden zum Initialisieren einer PDF, Hinzufügen von Inhalten und Schließen der PDF. Nach dem Hinzufügen von Inhalten kann das Dokument an einen Zieldatensatz angehängt werden.")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");

## Absatz -- addStyle (Stilstil) {#ariaid-title6}

Wendet einen vordefinierten Stil auf den Absatztext an.
{#Paragraph-addStyle_O__table_vv5_52h_44b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Stil | [Stil](https://servicenow-prod.fluidtopics.net/yLV4JOiT9ox0a3Zs8QlYjw#StyleBothAPI "Erstellt einen Stil zum Definieren von Eigenschaften wie Schriftgröße, Rahmen und Ausrichtung. Sie können denselben Stil auf mehrere Objekte gleichzeitig anwenden.") | Stil, der auf dieses Element angewendet werden soll. |
[Tabelle : 8. Parameter]

{#Paragraph-addStyle_O__table_vv5_52h_44b} {#Paragraph-addStyle_O__table_wv5_52h_44b__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 9. Rückgaben]

{#Paragraph-addStyle_O__table_wv5_52h_44b}  
Das folgende Beispiel zeigt, wie ein Stil auf einen Absatz angewendet wird. Ein Beispiel für die Dokumentnutzung finden Sie unter [Dokument](https://servicenow-prod.fluidtopics.net/tUwTjwhc8qeiH0if1DLMOQ#DocumentBothAPI "Die Dokument Die API bietet Methoden zum Initialisieren einer PDF, Hinzufügen von Inhalten und Schließen der PDF. Nach dem Hinzufügen von Inhalten kann das Dokument an einen Zieldatensatz angehängt werden.")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");

## Absatz -- setFixedPosition (Anzahl links, Zahl unten, Nummernbreite) {#ariaid-title7}

Legt ein Absatzelement an eine feste Position auf der Seite fest.
{#Paragraph-setFixedPosition_N_N_N__table_vv5_52h_44b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Links | Nummer | Einzug von der linken Seite der PDF-Seite in Punkten. |
| bottom | Nummer | Position vom unteren Rand der PDF-Seite in Punkten. |
| width | Nummer | Breite des Absatzelements in Punkten. Dieser Wert bestimmt die Länge, bei der die Linie bricht. |
[Tabelle : 10. Parameter]

{#Paragraph-setFixedPosition_N_N_N__table_vv5_52h_44b} {#Paragraph-setFixedPosition_N_N_N__table_wv5_52h_44b__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Rückgaben]

{#Paragraph-setFixedPosition_N_N_N__table_wv5_52h_44b}  
Das folgende Beispiel zeigt, wie Sie eine feste Position auf einer Seite festlegen. Ein Beispiel für die Dokumentnutzung finden Sie unter [Dokument](https://servicenow-prod.fluidtopics.net/tUwTjwhc8qeiH0if1DLMOQ#DocumentBothAPI "Die Dokument Die API bietet Methoden zum Initialisieren einer PDF, Hinzufügen von Inhalten und Schließen der PDF. Nach dem Hinzufügen von Inhalten kann das Dokument an einen Zieldatensatz angehängt werden.")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");

## Absatz -- setMargin (Nummernrand) {#ariaid-title8}

Legt jeden Absatzrand fest.
Um alle vier Ränder mit einem oder mehreren eindeutigen Werten festzulegen, verwenden Sie [SetMargins()](https://servicenow-prod.fluidtopics.net/Gjs8RFO4IXvCA8uJ5CgZsA#Paragraph-setMargins_N_N_N_N "Legt eine Größe für jeden Absatzrand fest.").
{#Paragraph-setMargin_N__table_vv5_52h_44b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Rand | Nummer | Wert des oberen, rechten, unteren und linken Rands in Punkten. |
[Tabelle : 12. Parameter]

{#Paragraph-setMargin_N__table_vv5_52h_44b} {#Paragraph-setMargin_N__table_wv5_52h_44b__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 13. Rückgaben]

{#Paragraph-setMargin_N__table_wv5_52h_44b}  
Das folgende Beispiel zeigt, wie alle Ränder des Absatzes auf 48 Punkte festgelegt werden.

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

## Absatz -- setMarginBottom (Nummernrand) {#ariaid-title9}

Legt den unteren Rand eines Absatzes fest.
{#Paragraph-setMarginBottom_N__table_vv5_52h_44b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Rand | Nummer | Höhe des unteren Rands in Punkten. |
[Tabelle : 14. Parameter]

{#Paragraph-setMarginBottom_N__table_vv5_52h_44b} {#Paragraph-setMarginBottom_N__table_wv5_52h_44b__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 15. Rückgaben]

{#Paragraph-setMarginBottom_N__table_wv5_52h_44b}  
Das folgende Beispiel zeigt, wie der untere Rand eines Absatzes auf einen Punkt festgelegt wird.

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

## Absatz -- setMarginLeft(Nummernrand) {#ariaid-title10}

Legt den linken Rand eines Absatzes fest.
{#Paragraph-setMarginLeft_N__table_vv5_52h_44b__entry__3}{#Paragraph-setMarginLeft_N__docviewer-api-parm-leftM-des}

| Name | Typ | Beschreibung |
|-|-|-|
| Linker Rand | Nummer | Breite des linken Rands in Punkten. |
[Tabelle : 16. Parameter]

{#Paragraph-setMarginLeft_N__table_vv5_52h_44b} {#Paragraph-setMarginLeft_N__table_wv5_52h_44b__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 17. Rückgaben]

{#Paragraph-setMarginLeft_N__table_wv5_52h_44b}  
Das folgende Beispiel zeigt, wie der linke Rand eines Absatzes auf einen Punkt festgelegt wird.

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

## Absatz -- setMarginRight (Nummernrand) {#ariaid-title11}

Legt den rechten Rand eines Absatzes fest.
{#Paragraph-setMarginRight_N__table_vv5_52h_44b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Rand | Nummer | Breite des rechten Rands in Punkten. |
[Tabelle : 18. Parameter]

{#Paragraph-setMarginRight_N__table_vv5_52h_44b} {#Paragraph-setMarginRight_N__table_wv5_52h_44b__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 19. Rückgaben]

{#Paragraph-setMarginRight_N__table_wv5_52h_44b}  
Das folgende Beispiel zeigt, wie der rechte Rand eines Absatzes auf einen Punkt festgelegt wird.

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

## Absatz -- setMargins (Number marginTop, Number marginRight, Number marginBottom, Number marginLeft) {#ariaid-title12}

Legt eine Größe für jeden Absatzrand fest.
Um jeden Rand auf denselben Wert festzulegen, verwenden Sie [SetMargin()](https://servicenow-prod.fluidtopics.net/Gjs8RFO4IXvCA8uJ5CgZsA#Paragraph-setMargin_N "Legt jeden Absatzrand fest.").
{#Paragraph-setMargins_N_N_N_N__table_vv5_52h_44b__entry__3}{#Paragraph-setMargins_N_N_N_N__docviewer-api-parm-topM-des}{#Paragraph-setMargins_N_N_N_N__docviewer-api-parm-rightM-des}{#Paragraph-setMargins_N_N_N_N__docviewer-api-parm-bottomM-des}{#Paragraph-setMargins_N_N_N_N__docviewer-api-parm-leftM-des}

| Name | Typ | Beschreibung |
|-|-|-|
| Oberer Rand | Nummer | Höhe des oberen Rands in Punkten. |
| Rechter Rand | Nummer | Breite des rechten Rands in Punkten. |
| Unterer Rand | Nummer | Höhe des unteren Rands in Punkten. |
| Linker Rand | Nummer | Breite des linken Rands in Punkten. |
[Tabelle : 20. Parameter]

{#Paragraph-setMargins_N_N_N_N__table_vv5_52h_44b} {#Paragraph-setMargins_N_N_N_N__table_wv5_52h_44b__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 21. Rückgaben]

{#Paragraph-setMargins_N_N_N_N__table_wv5_52h_44b}  
Das folgende Beispiel zeigt, wie Absatzränder festgelegt werden.Ein Beispiel für die Dokumentnutzung finden Sie unter [Dokument](https://servicenow-prod.fluidtopics.net/tUwTjwhc8qeiH0if1DLMOQ#DocumentBothAPI "Die Dokument Die API bietet Methoden zum Initialisieren einer PDF, Hinzufügen von Inhalten und Schließen der PDF. Nach dem Hinzufügen von Inhalten kann das Dokument an einen Zieldatensatz angehängt werden.")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);

## Absatz -- setMarginTop(Nummernrand) {#ariaid-title13}

Legt den oberen Rand eines Absatzes fest.
{#Paragraph-setMarginTop_N__table_vv5_52h_44b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Rand | Nummer | Höhe des oberen Rands in Punkten. |
[Tabelle : 22. Parameter]

{#Paragraph-setMarginTop_N__table_vv5_52h_44b} {#Paragraph-setMarginTop_N__table_wv5_52h_44b__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 23. Rückgaben]

{#Paragraph-setMarginTop_N__table_wv5_52h_44b}  
Das folgende Beispiel zeigt, wie der obere Rand eines Absatzes auf einen Punkt festgelegt wird.

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

## Absatz -- setTextAlignment (Zeichenfolgenausrichtung) {#ariaid-title14}

Legt die Textausrichtung dieses Absatzes fest.
{#Paragraph-setTextAlignment_S__table_vv5_52h_44b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Ausrichtung | Zeichenfolge | Textausrichtungsposition. Gültige Werte: * Textmitte: Richtet Text an der Mitte aus. * Textseitig: Ändert den Abstand zwischen Zeichen, um den Text zwischen der linken und rechten Seite vollständig auszufüllen. Die endgültige Zeile ist links ausgerichtet. * Text-ausgerichtet-alle: Begründet die Textausrichtung einschließlich der endgültigen Zeile. * Text links: Text links ausrichten. * Text-Right: Text nach rechts ausrichten. {#Paragraph-setTextAlignment_S__ul_sgj_44p_p4b} |
[Tabelle : 24. Parameter]

{#Paragraph-setTextAlignment_S__table_vv5_52h_44b} {#Paragraph-setTextAlignment_S__table_wv5_52h_44b__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 25. Rückgaben]

{#Paragraph-setTextAlignment_S__table_wv5_52h_44b}  
Das folgende Beispiel zeigt, wie der Absatztext links ausgerichtet wird.

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


