Zelle: Bereichsbezogen, Global

Erstellt ein Zellenobjekt als Zelle in einer Tabelle. Sie können diese API verwenden, um die Zelle zu formatieren und zusätzliche Blöcke wie Absätze und Bilder hinzuzufügen.

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 zum Generieren einer PDF-Datei verwendet wird.

Zelle: Zelle (Nummernzeilenbereich, Nummernspaltenbereich)

Instanziiert ein neues Zellenobjekt. Erstellt eine Zelle, die eine anwenderdefinierte Anzahl von Zellenbereichen in der Tabelle benötigt.

Hinweis:

Wenn Sie für einen der Parameter eine negative Zahl angeben, wird der Wert auf 1 festgelegt.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
rowspan	Nummer	Anzahl der Zeilen, die diese Zelle belegen soll. Standard: 0
Spaltenbereich	Nummer	Anzahl der Spalten, die diese Zelle belegen soll. Standard: 0

Das folgende Beispiel zeigt, wie ein Zellenobjekt erstellt wird, das eine einzelne Zeile und eine einzelne Spalte umfasst.

var cell = new sn_pdfgeneratorutils.Cell(1, 1);

Zelle – addImage(Image image)

Fügt einer Tabellenzelle ein Bild hinzu.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
Bild	Bild	Bild zum Hinzufügen zu einer Tabellenzelle.

Tabelle : 3. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie einen vorhandenen Bildanhang instanziieren und einer Zelle in einer Tabelle hinzufügen. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 1);

var image = new Image("<attachment_sys_id>");

cell.addImage(image);

Zelle – addParagraph(Absatz)

Fügt einer Tabellenzelle Text hinzu.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
Absatz	Absatz	Text, der einer Tabellenzelle hinzugefügt werden soll.

Tabelle : 5. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie Absatzobjekte instanziieren und die Inhaltszellen in einer Tabelle hinzufügen. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);
var para = new sn_pdfgeneratorutils.Paragraph("Paragraph text.");
cell.addParagraph(para);

Zelle – addStyle(Stilstil)

Wendet einen vordefinierten Stil auf Tabellenzellen an.

Tabelle : 6. Parameter

Name	Typ	Beschreibung
Stil	Stil	Auf dieses Element anzuwendender Stil.

Tabelle : 7. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie ein Stil auf eine Tabellenzelle angewendet wird. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);
var style = new sn_pdfgeneratorutils.Style();
style.setBold();
     
cell.addStyle(style);

Zelle – addTable(Table table)

Fügt einer Zelle eine Tabelle hinzu.

Tabelle : 8. Parameter

Name	Typ	Beschreibung
Tabelle	Tabelle	Tabelle, die einer Zelle hinzugefügt werden soll.

Tabelle : 9. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie ein Tabellenobjekt instanziieren und einer Zelle hinzufügen. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 1);

var columnWidths = [100, 50, 50];

var table = new Table(columnWidths, false);

cell.addTable(table);

Zelle – getColumn()

Ruft die Nummer der Spalte ab, in der sich die Zelle befindet.

Tabelle : 10. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 11. Ergebnisse

Typ	Beschreibung
Nummer	Nummer der Spaltenposition für eine Zelle.

Das folgende Beispiel zeigt, wie Sie die Nummer einer Spaltenposition für eine Zelle abrufen.

var cell = new sn_pdfgeneratorutils.Cell(1, 1);

var columnWidths = [100, 50, 50];

var table = new sn_pdfgeneratorutils.Table(true, columnWidths, false);

table.addCell(cell);

var colNum = cell.getColumn();

gs.info("The column position for cell is " + colNum);

Ausgabe:

The column position for cell is 1

Zelle – getRow()

Ruft die Anzahl der Zeilen ab, in denen sich die Zelle befindet.

Tabelle : 12. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 13. Ergebnisse

Typ	Beschreibung
Nummer	Nummer der Zeilenposition für eine Zelle.

Das folgende Beispiel zeigt, wie Sie die Nummer einer Zeilenposition für eine Zelle abrufen.

var cell = new sn_pdfgeneratorutils.Cell(1, 1);

var rowWidths = [100, 50, 50];

var table = new sn_pdfgeneratorutils.Table(true, rowWidths, false);

table.addCell(cell);

var rowNum = cell.getRow();

gs.info("The row position for cell is " + rowNum);

Ausgabe:

The row position for cell is 4927

Zelle – setBackGgroundColor(Farbe – Farbe)

Gibt eine Hintergrundfarbe für die Zelle an.

Tabelle : 14. Parameter

Name	Typ	Beschreibung
Farbe	Farbe	Hintergrundfarbe.

Tabelle : 15. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie die Hintergrundfarbe für Zellen festgelegt wird. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var color = new sn_pdfgeneratorutils.Color([1, 0.9, 0.9]); // provided as array of RGB float values

cell.setBackGroundColor(color);

Zelle – setBorder(Numberbreite)

Legt einen Rahmen für alle vier Ränder einer Zelle fest.

Tabelle : 16. Parameter

Name	Typ	Beschreibung
width	Nummer	Zellenrahmenbreite in Punkten.

Tabelle : 17. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie ein Zellenrahmen aus einem Punkt für alle vier Ränder einer Zelle festgelegt wird. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 1.0;

cell.setBorder(width);

Zelle – setBorderBOTOM (Zahlenbreite)

Legt einen Rahmen für die Untergrenze einer Zelle fest.

Tabelle : 18. Parameter

Name	Typ	Beschreibung
width	Nummer	Zellenrahmenbreite in Punkten.

Tabelle : 19. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie ein Zellenrahmen festgelegt wird. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 1.0;

cell.setBorder(width);

Zelle – setBorderLeft(Zahlenbreite)

Legt einen Rahmen für die linke Grenze einer Zelle fest.

Tabelle : 20. Parameter

Name	Typ	Beschreibung
width	Nummer	Zellenrahmenbreite in Punkten.

Tabelle : 21. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie einen linken Zellenrahmen festlegen. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 1.0;

cell.setLeftBorder(width);

Zelle – setBorderRecht (Zahlenbreite)

Legt einen Rahmen für die rechte Grenze einer Zelle fest.

Tabelle : 22. Parameter

Name	Typ	Beschreibung
width	Nummer	Zellenrahmenbreite in Punkten.

Tabelle : 23. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie ein rechtsseitiger Zellenrahmen festgelegt wird. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 1.0;

cell.setRightBorder(width);

Zelle – setBorderTop(Zahlenbreite)

Legt einen Rahmen für die Obergrenze einer Zelle fest.

Tabelle : 24. Parameter

Name	Typ	Beschreibung
width	Nummer	Zellenrahmenbreite in Punkten.

Tabelle : 25. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie einen oberen Zellenrahmen festlegen. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 1.0;

cell.setBorderTop(width);

Zelle – setColoredBorder(Farbe, Farbe, Zahlenbreite)

Legt einen farbigen Rahmen für alle vier Ränder einer Zelle fest.

Tabelle : 26. Parameter

Name	Typ	Beschreibung
Farbe	Farbe	Zellenrahmenfarbe.
width	Nummer	Zellenrahmenbreite in Punkten.

Tabelle : 27. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie einen farbigen Zellenrahmen festlegen. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var borderColor = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
var width = 1.0;

cell.setColoredBorder(borderColor, width);

Zelle – setColoredBorderBOTOM(Farbfarbe, Zahlenbreite)

Legt einen farbigen Rahmen für die Untergrenze einer Zelle fest.

Tabelle : 28. Parameter

Name	Typ	Beschreibung
Farbe	Farbe	Zellenrahmenfarbe.
width	Nummer	Zellenrahmenbreite in Punkten.

Tabelle : 29. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie einen farbigen unteren Zellenrahmen festlegen. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var borderColor = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
var width = 1.0;

cell.setColoredBorderBottom(borderColor, width);

Zelle – setColoredBorderLeft(Farbfarbe, Zahlenbreite)

Legt einen farbigen Rahmen für die linke Grenze einer Zelle fest.

Tabelle : 30. Parameter

Name	Typ	Beschreibung
Farbe	Farbe	Zellenrahmenfarbe.
width	Nummer	Zellenrahmenbreite in Punkten.

Tabelle : 31. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie einen farbigen linken Zellenrahmen festlegen. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var borderColor = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
var width = 1.0;

cell.setColoredBorderLeft(borderColor, width);

Zelle – setColoredBorderright(Farbfarbe, Zahlenbreite)

Legt einen farbigen Rahmen für die rechte Grenze einer Zelle fest.

Tabelle : 32. Parameter

Name	Typ	Beschreibung
Farbe	Farbe	Zellenrahmenfarbe.
width	Nummer	Zellenrahmenbreite in Punkten.

Tabelle : 33. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie einen farbigen rechten Zellenrahmen festlegen. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var borderColor = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
var width = 1.0;

cell.setColoredBorderRight(borderColor, width);

Zelle – setColoredBorderTop(Farbfarbe, Zahlenbreite)

Legt einen farbigen Rahmen für die Obergrenze einer Zelle fest.

Tabelle : 34. Parameter

Name	Typ	Beschreibung
Farbe	Farbe	Zellenrahmenfarbe.
width	Nummer	Zellenrahmenbreite in Punkten.

Tabelle : 35. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie einen farbigen oberen Zellenrahmen festlegen. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var borderColor = new sn_pdfgeneratorutils.Color([0.8,0.8,0.8]);
var width = 1.0;

cell.setColoredBorderTop(borderColor, width);

Zelle – setHeight(Height der Zahl)

Legt die Höhe einer Zelle fest.

Tabelle : 36. Parameter

Name	Typ	Beschreibung
Wert	Nummer	Zellenhöhe in Punkten.

Tabelle : 37. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie eine Zellenhöhe von 10 Punkt festlegen. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var height = 10;

cell.setHeight(height);

Zelle – setHorizontalAlignment(Zeichenfolgenausrichtung)

Legt die horizontale Ausrichtung für diese Zelle fest.

Tabelle : 38. Parameter

Name	Typ	Beschreibung
Ausrichtung	Zeichenfolge	Einstellung für horizontale Ausrichtung Gültige Werte: Mitte: Richten Sie Inhalte zentriert aus. links: Inhalt links ausrichten. rechts: Inhalt rechts ausrichten.

Tabelle : 39. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie die horizontale Ausrichtung für eine Zelle festgelegt wird. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var alignment = "center";

cell.setHorizontalAlignment(alignment);

Zelle – setMaxHeight(Zahlenwert)

Legt die maximale Höhe einer Zelle fest.

Tabelle : 40. Parameter

Name	Typ	Beschreibung
Wert	Nummer	Maximale Zellenhöhe in Punkt.

Tabelle : 41. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie eine maximale Zellenhöhe von 409 Punkten festlegen. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var height = 409;

cell.setMaxHeight(height);

Zelle – setMaxWidth(Float-Wert)

Legt die maximale Breite einer Zelle fest.

Tabelle : 42. Parameter

Name	Typ	Beschreibung
Wert	Nummer	Maximale Zellenbreite in Punkten.

Tabelle : 43. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie eine maximale Zellenbreite von 1530 Punkten festlegen. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 1530;

cell.setMaxWidth(width);

Zelle – setMinHeight(Number value)

Legt die Mindesthöhe einer Zelle fest.

Tabelle : 44. Parameter

Name	Typ	Beschreibung
Wert	Nummer	Minimale Zellenhöhe in Punkt.

Tabelle : 45. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie eine minimale Zellenhöhe von 12,75 Punkt festgelegt wird. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var height = 12.75;

cell.setMinHeight(height);

Zelle – setMinWidth(Number value)

Legt die Mindestbreite einer Zelle fest.

Tabelle : 46. Parameter

Name	Typ	Beschreibung
Wert	Nummer	Minimale Zellenbreite in Punkten.

Tabelle : 47. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie eine minimale Zellenbreite von 50,58 Punkt festlegen. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var width = 50.58;

cell.setMinWidth(width);

Zelle – setOpacity(Nummerndeckkraft)

Legt die Opazität von Zelleninhalt, Rahmen und Hintergrund fest.

Hinweis:

Diese Einstellung wirkt sich auf alle untergeordneten Elemente der Zelle aus.

Tabelle : 48. Parameter

Name	Typ	Beschreibung
Opazität	Nummer	Dezimalwert für Gleitkommazahl von 0 bis 1, wobei 0 transparent und 1 vollständig deckend ist. Standard: 0

Tabelle : 49. Rückgaben

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie die Deckkraft einer Zelle festgelegt wird.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var opacity = 0.5;

cell.setOpacity(opacity);

Zelle – setPadding(Nummernauffüllung)

Legt den Abstand aller vier Seiten einer Zelle auf die gleiche Breite fest.

Siehe auch:

• festlegenAuffüllungUnten ()
• festlegenAuffüllungLinks ()
• festlegenAbstandRechts ()
• festlegenAuffüllungTop ()

Tabelle : 50. Parameter

Name	Typ	Beschreibung
Auffüllung	Nummer	Abstandsbreite in Punkten als Dezimalwert.

Tabelle : 51. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie die untere Zelle auf einen Punkt festgelegt wird. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var padding = 1.0;

cell.setPadding(padding);

Zelle – setPaddingBOTOM(Number Padding)

Legt den Wert der unteren Abstandsbreite einer Zelle fest.

Siehe auch:

• festlegenAuffüllung ()
• festlegenAuffüllungLinks ()
• festlegenAbstandRechts ()
• festlegenPaddingTop ()

Tabelle : 52. Parameter

Name	Typ	Beschreibung
Auffüllung	Nummer	Abstandsbreite in Punkten als Dezimalwert.

Tabelle : 53. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie der untere Zellenabstand auf einen Punkt festgelegt wird. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var padding = 1.0;

cell.setPaddingBottom(padding);

Zelle – setPaddingLeft(Nummernabstand)

Legt den Wert der linken Abstandsbreite einer Zelle fest.

Siehe auch:

• festlegenAuffüllung ()
• festlegenAuffüllungUnten ()
• festlegenAbstandRechts ()
• festlegenPaddingTop ()

Tabelle : 54. Parameter

Name	Typ	Beschreibung
Auffüllung	Nummer	Abstandsbreite in Punkten als Dezimalwert.

Tabelle : 55. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie der linke Zellenabstand auf einen Punkt festgelegt wird. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var padding = 1.0;

cell.setPaddingLeft(padding);

Zelle – setPaddingRecht(Nummernabstand)

Legt den Wert der rechten Abstandsbreite einer Zelle fest.

Siehe auch:

• festlegenAuffüllung ()
• festlegenAuffüllungUnten ()
• festlegenAuffüllungLinks ()
• festlegenAuffüllungTop ()

Tabelle : 56. Parameter

Name	Typ	Beschreibung
Auffüllung	Nummer	Abstandsbreite in Punkten als Dezimalwert.

Tabelle : 57. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie der rechte Zellenabstand auf einen Punkt festgelegt wird. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var padding = 1.0;

cell.setPaddingRight(padding);

Zelle – setPaddingTop(Number Padding)

Legt den Wert der oberen Abstandsbreite einer Zelle fest.

Siehe auch:

• festlegenAuffüllung ()
• festlegenAuffüllungUnten ()
• festlegenAuffüllungLinks ()
• festlegenAbstandRechts ()

Tabelle : 58. Parameter

Name	Typ	Beschreibung
Auffüllung	Nummer	Abstandsbreite in Punkten als Dezimalwert.

Tabelle : 59. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie der Abstand der oberen Zelle auf einen Punkt festgelegt wird. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var padding = 1.0;

cell.setPaddingTop(padding);

Zelle – setTextAlignment(Zeichenfolgenausrichtung)

Legt die Textausrichtung dieser Zelle fest.

Tabelle : 60. Parameter

Name	Typ	Beschreibung
Ausrichtung	Zeichenfolge	Textausrichtungsposition. Gültige Werte: text-center: Richtet den Text zentriert aus. textorientiert: Ändert den Abstand zwischen den Zeichen, um den Text zwischen der linken und rechten Seite vollständig auszufüllen. Die letzte Zeile ist linksbündig. text-berichtigt-all: Blockiert die Textausrichtung einschließlich der letzten Zeile. text-left: Text links ausrichten. text-right: Text rechts ausrichten.

Tabelle : 61. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie Sie den Zellentext auf die linke Ausrichtung festlegen.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var alignment = "text-left";

cell.setTextAlignment(alignment);

Zelle – setVerticalAlignment(Zeichenfolgenausrichtung)

Legt die vertikale Ausrichtung für diese Zelle fest.

Tabelle : 62. Parameter

Name	Typ	Beschreibung
Ausrichtung	Zeichenfolge	Einstellung für vertikale Ausrichtung Gültige Werte: unten: Richtet Inhalte unten aus. mid: Richtet Inhalte in der Mitte aus. top: Richtet den Inhalt oben aus.

Tabelle : 63. Ausgabe

Typ	Beschreibung
Keine

Das folgende Beispiel zeigt, wie die vertikale Ausrichtung für eine Zelle festgelegt wird. Ein Beispiel für die Dokumentverwendung finden Sie unter Dokument -API.

var cell = new sn_pdfgeneratorutils.Cell(1, 3);

var alignment = "mid";

cell.setVerticalAlignment(alignment);