Position: Bereichsbezogen, Global

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 1 Minute Lesedauer
  • Erstellt ein Linienobjekt mit Methoden zum Zeichnen einer Linie in einer PDF-Datei.

    Diese API ist Teil von ServiceNow Plugin „PDF-Generierungsdienstprogramme“ (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 Dient zum Generieren einer PDF-Datei.

    Line – Line()

    Instanziiert eine neue Position Objekt.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine

    Die folgenden Beispiele zeigen, wie Sie einen erstellen Position Objekt.

    var line = new sn_pdfgeneratorutils.Line();

    Position: Draw Line(Dokumentdokument, NummernpageNo, Anzahl xPos, Anzahl yPos, Nummernbreite, Zeilenbreite der Zahl)

    Platziert eine Zeile auf einer Dokumentseite.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    Dokument Dokument Name des Dokumentobjekts.
    pageNo Anzahl Seitenzahl, auf der Sie die Zeile platzieren möchten.
    XPos Anzahl X-Koordinatenbereich der Seite, auf der die Linie platziert werden soll.
    YPos Anzahl Y-Koordinatenbereich der Seite, auf der die Linie platziert werden soll.
    width Anzahl Breitenbereich der Seite, in der Sie die Linie zeichnen möchten. Werte sind in Punkten.
    Linienbreite Anzahl Optional. Wert der Linienstärke in Punkten.

    Standard: 1

    Tabelle : 3. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie eine Zeile am unteren Rand einer Dokumentseite erstellt wird. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument 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)

    Legt die Farbe einer Linie fest.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    Farbe Farbe Linienfarbe.
    Tabelle : 5. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Sie eine Linie erstellen und ihre Farbe in einem Dokument festlegen. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument 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");