---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Position: Bereichsbezogen, global

# Position: Bereichsbezogen, global {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Erstellt ein Linienobjekt mithilfe von Methoden zum Zeichnen einer Linie in einer PDF-Datei.

Diese API ist Teil des Plugins ServiceNow PDF Generierung Utilities (com.snc.apppdfgenerator) und wird im Namespace `sn_pdfgeneratorutils` bereitgestellt. Das Plugin ist standardmäßig aktiviert.

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

## Linie: Linie () {#ariaid-title2}

Instanziiert ein neues Zeilenobjekt.
{#Line-Line__table_twm_hjk_34b__entry__3}

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

{#Line-Line__table_twm_hjk_34b}  
Die folgenden Beispiele zeigen, wie ein Line- Objekt erstellt wird.

    var line = new sn_pdfgeneratorutils.Line();

## Linie --rawLine(Dokumentdokument, Nummer pageNo, Nummer xPos, Nummer yPos, Nummerbreite, Nummer zeilenbreite) {#ariaid-title3}

Platziert eine Zeile auf einer Dokumentseite.
{#Line-drawLine_O_N_N_N_N_N__table_vv5_52h_44b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Dokument | [Dokument](https://www.servicenow.com/docs/CveG5U0vsM3q8bxY3KrZQg#DocumentBothAPI "Die Dokumenten -API bietet Methoden zum Initialisieren einer PDF-Datei, zum Hinzufügen von Inhalten und zum Schließen der PDF-Datei. Nach dem Hinzufügen von Inhalt kann das Dokument an einen Zieldatensatz angehängt werden.") | Name des Dokumentobjekts. |
| pageNo | Nummer | Seitenzahl, auf der Sie die Zeile platzieren möchten. |
| xPos | Nummer | X-Koordinatenbereich der Seite, in dem die Zeile platziert werden soll. |
| yPos | Nummer | Y-Koordinatenbereich der Seite, in dem die Zeile platziert werden soll. |
| width | Nummer | Breitenbereich der Seite, in dem Sie die Linie zeichnen möchten. Die Werte werden in Punkten angegeben. |
| Linienbreite | Nummer | Optional. Wert der Linienstärke in Punkten. Standard: 1 |
[Tabelle : 2. Parameter]

{#Line-drawLine_O_N_N_N_N_N__table_vv5_52h_44b} {#Line-drawLine_O_N_N_N_N_N__table_wv5_52h_44b__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Ergebnisse]

{#Line-drawLine_O_N_N_N_N_N__table_wv5_52h_44b}  
Das folgende Beispiel zeigt, wie Sie eine Zeile am unteren Rand einer Dokumentseite erstellen. Ein Beispiel für die Dokumentverwendung finden Sie unter [Dokument](https://www.servicenow.com/docs/CveG5U0vsM3q8bxY3KrZQg#DocumentBothAPI "Die Dokumenten -API bietet Methoden zum Initialisieren einer PDF-Datei, zum Hinzufügen von Inhalten und zum Schließen der PDF-Datei. Nach dem Hinzufügen von Inhalt 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 num = 1;
    var xpos = 100;
    var ypos = 100;
    var width = 450;
    var linewidth = 2.5;

    document.addNewPage();

    var line = new sn_pdfgeneratorutils.Line();

    line.drawLine(document, num, xpos, ypos, width, linewidth);

    document.saveAsAttachment("incident", "<sys_id>", "line.pdf");

## Zeile -- setColor(Farbe -- Farbe) {#ariaid-title4}

Legt die Farbe einer Linie fest.
{#Line-setColor_O__table_vv5_52h_44b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Farbe | [Farbe](https://www.servicenow.com/docs/TxRHCwvy~USckaZaKz_l2A#ColorBothAPI "Erstellt ein Farbobjekt, das zum Definieren von Farbattributen verwendet wird, die Sie auf Elemente in einer PDF-Datei anwenden können; wie Zellen, Tabellen und Zeilen.") | Linienfarbe. |
[Tabelle : 4. Parameter]

{#Line-setColor_O__table_vv5_52h_44b} {#Line-setColor_O__table_wv5_52h_44b__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Ergebnisse]

{#Line-setColor_O__table_wv5_52h_44b}  
Das folgende Beispiel zeigt, wie Sie in einem Dokument eine Linie erstellen und ihre Farbe festlegen. Ein Beispiel für die Dokumentverwendung finden Sie unter [Dokument](https://www.servicenow.com/docs/CveG5U0vsM3q8bxY3KrZQg#DocumentBothAPI "Die Dokumenten -API bietet Methoden zum Initialisieren einer PDF-Datei, zum Hinzufügen von Inhalten und zum Schließen der PDF-Datei. Nach dem Hinzufügen von Inhalt 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 num = 1;
    var xpos = 100;
    var ypos = 100;
    var width = 450;
    var linewidth = 2.5;

    var color = new sn_pdfgeneratorutils.Color([0.5,0.5,0.8]);   //given as array of RGB values;

    document.addNewPage();

    var line = new sn_pdfgeneratorutils.Line();

    line.setColor(color);

    line.drawLine(document, num, xpos, ypos, width, linewidth);

    document.saveAsAttachment("incident", "<sys_id>", "lineWithColor.pdf");