---
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


---

# Position: Bereichsbezogen, Global

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

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

Erstellt ein Zeilenobjekt mit Methoden zum Zeichnen einer Linie in einer PDF-Datei.

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.

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

Instanziiert eine neue Position Objekt.
{#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 erstellt wird Position Objekt.

    var line = new sn_pdfgeneratorutils.Line();

## Linie: Draw Line(Dokumentdokument, NummernseitenNo, Zahl xPos, Zahl yPos, Nummernbreite, Nummernlinebreite) {#ariaid-title3}

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

| Name | Typ | Beschreibung |
|-|-|-|
| Dokument | [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.") | Name des Dokumentobjekts. |
| pageNo | Nummer | Seitennummer, auf der Sie die Zeile platzieren möchten. |
| XPos | Nummer | X-Koordinatenbereich der Seite, auf dem die Linie platziert werden soll. |
| YPos | Nummer | Y-Koordinatenbereich der Seite, auf dem die Linie platziert werden soll. |
| width | Nummer | Breitenbereich der Seite, in der Sie die Linie zeichnen möchten. Werte sind in Punkten. |
| 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. Rückgaben]

{#Line-drawLine_O_N_N_N_N_N__table_wv5_52h_44b}  
Das folgende Beispiel zeigt, wie eine Zeile am unteren Rand einer Dokumentseite erstellt 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 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");

## Linie -- setColor (Farbfarbe) {#ariaid-title4}

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

| Name | Typ | Beschreibung |
|-|-|-|
| Farbe | [Farbe](https://servicenow-prod.fluidtopics.net/cmxeBX8i9ErCpDNgnDoZ1g#ColorBothAPI "Erstellt ein Farbobjekt, das zum Definieren von Farbattributen verwendet wird, die Sie auf Elemente in einer PDF anwenden können, z. B. Zellen, Tabellen und Linien.") | 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. Rückgaben]

{#Line-setColor_O__table_wv5_52h_44b}  
Das folgende Beispiel zeigt, wie Sie eine Linie erstellen und ihre Farbe in einem Dokument 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("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");


