Bild: Bereichsbezogen, Global

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 4 Minuten Lesedauer

    • Erstellt ein Bildobjekt, das ein Bild und sein Layout in einer PDF-Datei darstellt. Ermöglicht das Definieren von Attributen wie Skala, Ausrichtung und Rahmenfarbe.

    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.

    Sie können einer PDF-Datei ein Bild mit einer der folgenden Methoden hinzufügen:

    Image – Image (ZeichenfolgenanhangSysId)

    Instanziiert eine neue Bild Objekt. Wird verwendet, um zu überprüfen, ob ein Bildanhang vorhanden ist und zur Änderung verfügbar ist.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    attachmentSysId Zeichenfolge SYS_ID eines Bildes in der Tabelle „Anhänge“ [sys_attachment].

    Das folgende Beispiel zeigt, wie ein erstellt wird Bild Objekt.

    var image = new sn_pdfgeneratorutils.Image("<sys_id>");

    Bild – scaleAbsolute(Nummernbreite, Nummernhöhe)

    Skaliert ein Bild auf absolute Breiten- und Höhengrößen. Diese Einstellung behält das Breiten-Höhen-Verhältnis des Bildes nicht bei und kann zu unerwünschter Dehnung führen, wenn die Einstellungen nicht genau sind.

    Um eine absolute Größe zu erreichen, die das Breiten-Höhen-Verhältnis eines Bildes beibehält, verwenden Sie ScaleToFit() Methode.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    width Anzahl Bildbreite in Punkten.
    height Anzahl Bildhöhe in Punkten.
    Tabelle : 3. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie ein Bild zu einer PDF-Datei mit absoluten Breiten- und Höheneinstellungen hinzugefügt wird.

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

var scaleAbsPic = new sn_pdfgeneratorutils.Image("<img_sys_id>");
scaleAbsPic.scaleAbsolute(25,50);

document.addImage(scaleAbsPic);

document.saveAsAttachment("incident", "<record_sys_id>", "docWithImg.pdf");

    Bild – scaleToFit(Nummernbreite, Nummernhöhe)

    Skaliert ein Bild auf eine absolute Größe, wobei das Verhältnis zwischen Breite und Höhe beibehalten wird.

    Die resultierende Ausgabe variiert je nach Bildseitenverhältnis. Wenn die Parameterwerte für Breite und Höhe nicht mit dem Bildseitenverhältnis übereinstimmen, wird ein Wert in der Ausgabe kleiner als der angegebene Wert gerendert.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    width Anzahl Maximale Bildbreite in Punkten.
    height Anzahl Maximale Bildhöhe in Punkten.
    Tabelle : 5. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie Sie ein Bild einfügen, das mithilfe von skaliert ist Zelle – addImage() Methode.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
// add a table
var table = new sn_pdfgeneratorutils.Table([1,3],false);

// text for the left column
var text = "sample image";

// add a table cell for the image in the right column
var imgCell = new sn_pdfgeneratorutils.Cell(1, 1);

// add an image and set it scale-to-fit
var scaleToFitPic = new sn_pdfgeneratorutils.Image("<img_sys_id>");
scaleToFitPic.scaleToFit(90,175);

// add the image to the cell
imgCell.addImage(scaleToFitPic);
 
table.addTextCell(text);
table.addCell(imgCell);

// Here's a paragraph
var para = new sn_pdfgeneratorutils.Paragraph("The following table image uses scale to fit.");

document.addParagraph(para);
document.addTable(table);

document.saveAsAttachment("incident", "<record_sys_id>", "imgScaleToFit.pdf");

    Image – setAutoScale(boolescher Wert)

    Ermöglicht die Skalierung von Breite und Höhe auf eine Seite oder Zelle unter Beibehaltung der Abmessungen.

    Tabelle : 6. Parameter
    Name Typ Beschreibung
    Wert Boolean

    Kennzeichnung, die angibt, ob ein Bild automatisch skaliert werden soll.

    Gültige Werte:
    • Wahr: Skaliert das Bild automatisch
    • Falsch: Bild wird nicht skaliert

    Standardwert: false
    Tabelle : 7. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie ein Bild mit automatischer Skalierung zu einer PDF-Datei hinzugefügt wird. Das Bild wird mit hinzugefügt Tabelle – addImageCell() Methode.

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

// Add a table
var table = new sn_pdfgeneratorutils.Table([1,2],false);

// Text in left column
var text = "sample image";

// Image in right column
var autoScaledPic = new sn_pdfgeneratorutils.Image("<image_sys_id>");
autoScaledPic.setAutoScale(true);

table.addTextCell(text);
table.addImageCell(autoScaledPic);

document.addTable(table);
document.saveAsAttachment("incident", "<record_sys_id>", "imgAutoScale.pdf");

    Bild – setColoredBorder(Farbfarbe, Zahlenbreite)

    Legt einen Rahmen für eine PDF-Datei in der angegebenen Farbe fest.

    Tabelle : 8. Parameter
    Name Typ Beschreibung
    Farbe Farbe Bildrahmenfarbe.
    width Anzahl Breite des Rahmens in Punkten.
    Tabelle : 9. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie ein roter Rahmen mit fünf Punkten für ein Bild festgelegt wird.

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

var borderColor = new sn_pdfgeneratorutils.Color([1.0,0.0,0.0]);
 
// declare image using sys attachment
var image = new sn_pdfgeneratorutils.Image("<imgAttachment_sys_id>");

image.setColoredBorder(borderColor, 5);

document.addImage(image);
document.saveAsAttachment("incident", "<record_sys_id>", "docWithBorderedImage.pdf");

    Bild – setHorizontalAlignment (Zeichenfolgenausrichtung)

    Legt die horizontale Ausrichtung des Bildes fest.

    Tabelle : 10. Parameter
    Name Typ Beschreibung
    Ausrichtung Zeichenfolge Positioniert die Bildausrichtung auf einer Seite oder einem Blockelement.
    Gültige Werte:
    • Mitte
    • Links
    • Rechts

    Standard: Links
    Tabelle : 11. Rückgaben
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie ein zentriertes Bild auf einer PDF-Seite hinzugefügt wird.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
// declare image using sys attachment
var image = new sn_pdfgeneratorutils.Image("<imgAttachment_sys_id>");

String alignment = "Center";
image.setHorizontalAlignment(alignment);

document.addImage(image);
// save pdf as attachment to target record in the Incident table
document.saveAsAttachment("incident", "<sys_id>", "docWithImageCentered.pdf");

    Image – setNoBorder()

    Legt fest, dass ein Bild keinen Rahmen hat.

    Tabelle : 12. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 13. Ergebnisse
    Typ Beschreibung
    Keine

    Das folgende Beispiel zeigt, wie einem Dokument ohne Rahmen ein Bild hinzugefügt wird.

    var pageSize = new sn_pdfgeneratorutils.PdfPage("LETTER");
var document = new sn_pdfgeneratorutils.Document.createDocument(pageSize);
 
// declare image using sys attachment
var image = new sn_pdfgeneratorutils.Image("<imgAttachment_sys_id>");

image.setNoBorder();

document.addImage(image);
document.saveAsAttachment("incident", "<sys_id>", "docWithImgNoBorder.pdf");