SVGToPDFConversionAPI: Bereichsbezogen, Global

Die SVGToPDFConversionAPI Stellt Methoden bereit, die das Hinzufügen einer SVG zu einer PDF-Datei und das Konvertieren einer SVG in eine PDF-Datei ermöglichen.

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.

Siehe auch PDFGenerationAPI .

SVGToPDFConversionAPI: SVGToPDFConversionAPI()

Instanziiert eine neue SVGToPDFConversionAPI Objekt.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Keine

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

var v = new sn_pdfgeneratorutils.SVGToPDFConversionAPI();

SVGToPDFConversionAPI – addSVGToPDF(Zeichenfolge svg, Zeichenfolge inputPdfSysId, Zeichenfolge targetTable, Zeichenfolge targetSysId, Zeichenfolge nameForPdf, NummernseitenNein, Zahl x, Zahl y, Zahl svgImgWidth, Zahl svgImgHeight)

Fügt einer PDF-Datei auf einer angegebenen Seite ein SVG-Bild mit Bildgröße und Standortkoordinaten hinzu.

Tabelle : 2. Parameter

Name	Typ	Beschreibung
svg	Zeichenfolge	SVG zum Konvertieren in ein PDF-Dokument.
InputPdfSysId	Zeichenfolge	SYS_ID der Ziel-PDF, in der eine Kopie von mit einer SVG erstellt werden soll. Die Ziel-PDF befindet sich in der Tabelle „Anhänge“ [sys_attachment].
targetTable	Zeichenfolge	Name der Tabelle, die den Datensatz enthält, an den die PDF-Datei angehängt ist. Sie finden diesen Wert in derselben Zeile wie der Anhang, der in der Tabelle „Anhänge“ [sys_attachment] aufgeführt ist.
TargetTableSysId	Zeichenfolge	SYS_ID des Datensatzes, an den die PDF-Datei angehängt ist. Sie finden diesen Wert in derselben Zeile wie der Anhang, der in der Tabelle „Anhänge“ [sys_attachment] aufgeführt ist.
targetTable	Zeichenfolge	Name der Tabelle, an die die konvertierte PDF angehängt werden soll .
TargetTableSysId	Zeichenfolge	SYS_ID des Datensatzes, an den die konvertierte PDF angehängt werden soll.
PdfName	Zeichenfolge	Name für die PDF-Datei. Standard: SYS_ID der PDF-Datei in der Tabelle „Anhänge“ [sys_attachment].
pageNo	Anzahl	Seitenzahl in der angehängten PDF-Datei, auf der die SVG platziert werden soll.
x	Anzahl	Horizontale Position der SVG auf der Seite. Wert ist in Punkten.
y	Anzahl	Vertikale Position der SVG auf der Seite. Wert ist in Punkten.
SvgImgWidth	Anzahl	Breite des SVG-Bilds in Pixel.
SvgImgHeight	Anzahl	Höhe des SVG-Bilds in Pixel.

Tabelle : 3. Rückgaben

Typ	Beschreibung
Objekt	Objekt mit sys_ID eines neuen PDF-Anhangs mit eingefügtem SVG, falls erfolgreich, andernfalls Fehlermeldung. { "attachment_id": "String", "message": "String", "status": "String" }
<Object>. ​Attachment_ID	Wenn die SVG-Konvertierung erfolgreich ist, sys_ID der angehängten PDF-Datei. Die Datei wird in der Tabelle „Anhänge“ [sys_attachment] aufgeführt. Datentyp: Zeichenfolge
<Object>.Nachricht	Nachricht, die Erfolg oder Fehler bestätigt. Mögliche Werte: Fehler beim Hinzufügen von SVG-Inhalten zur PDF-Datei. Das Hinzufügen von SVG zu PDF und das Erstellen einer neuen PDF-Datei ist erfolgreich. Angegebener Zieldatensatz [<tableName> – <targetTableSysId>] ist nicht vorhanden. – Sys_ID der Zieltabelle ist nicht in der angegebenen Tabelle enthalten. Stellen Sie sicher, dass Sie den richtigen Tabellennamen für den Datensatz angeben. SYS-ID des PDF-Anhangs zum Hinzufügen des SVG-Inhalts ist null SVG-Eingabeinhalt ist leer oder null PdfReader wird nicht mit Besitzerpasswort geöffnet Der Name der Zieltabelle zum Anhängen der geänderten PDF: <targetTable> ist leer oder null Der Name der Zieltabelle zum Anhängen der geänderten PDF: <targetTable> ist ungültig Datentyp: Zeichenfolge
<Object>.Status	Status, der angibt, ob der Vorgang erfolgreich ist. Mögliche Werte: Erfolg: Vorgang war erfolgreich. Fehler: Vorgang war nicht erfolgreich. Die messageStellt Details bereit. Datentyp: Zeichenfolge

Das folgende Beispiel zeigt, wie SVG aus dem Beschreibungsfeld eines Incident-Datensatzes abgerufen und zu Seite 5 eines PDF-Anhangs hinzugefügt wird. Die neue PDF-Datei mit SVG befindet sich in der Tabelle „Anhänge“ [sys_attachment].

var gr = new GlideRecord("incident");

var svg;

if (gr.get("<tableSysId>")) {
 svg = gr.description.toString();
}

var result = new sn_pdfgeneratorutils.SVGToPDFConversionAPI().addSVGToPDF(svg, "<inputPdfSysId>", "incident", "<tableSysId>", "AddSVGToPDF", 5, 30, 30, 300, 100);
gs.info(JSON.stringify(result));

Ausgabe:

{"attachment_id":"<sys_id>","message":"Adding SVG to PDF and creating new PDF is successful.","status":"success"}

SVGToPDFConversionAPI – konvertSVGToPDF(Zeichenfolge svg, Zeichenfolge pdfName, Zeichenfolge targetTable, Zeichenfolge targetTableSysId)

Konvertiert eine als Zeichenfolge bereitgestellte SVG in PDF.

Tabelle : 4. Parameter

Name	Typ	Beschreibung
svg	Zeichenfolge	SVG zum Konvertieren in ein PDF-Dokument.
PdfName	Zeichenfolge	Name für die PDF-Datei. Standard: SYS_ID der PDF-Datei in der Tabelle „Anhänge“ [sys_attachment].
targetTable	Zeichenfolge	Name der Tabelle, an die die konvertierte PDF angehängt werden soll .
TargetTableSysId	Zeichenfolge	SYS_ID des Datensatzes, an den die konvertierte PDF angehängt werden soll.

Tabelle : 5. Ausgabe

Typ	Beschreibung
Objekt	Objekt mit sys_ID des PDF-Anhangs, der aus SVG konvertiert wurde, falls erfolgreich, andernfalls Fehlermeldung. { "attachment_id": "String", "message": "String", "status": "String" }
<Object>. ​Attachment_ID	Wenn die SVG-Konvertierung erfolgreich ist, sys_ID der angehängten PDF-Datei. Die Datei wird in der Tabelle „Anhänge“ [sys_attachment] aufgeführt. Datentyp: Zeichenfolge
<Object>.Nachricht	Nachricht, die Erfolg oder Fehler bestätigt. Mögliche Werte: Fehler beim Konvertieren des SVG-Bilds in das PDF-Dokument. Ausnahme beim Lesen des Quelldokumentinhalts. Angegebener Zieldatensatz [<tableName> – <targetTableSysId>] ist nicht vorhanden. – Sys_ID der Zieltabelle ist nicht in der angegebenen Tabelle enthalten. Stellen Sie sicher, dass Sie den richtigen Tabellennamen für den Datensatz angeben. SVG-in-PDF-Konvertierung erfolgreich. Der Zieltabellenname – <tableName> zum Anhängen der konvertierten SVG ist ungültig Der Zieltabellenname – <tableName> zum Anhängen der konvertierten SVG ist leer oder null Datentyp: Zeichenfolge
<Object>.Status	Status, der angibt, ob der Vorgang erfolgreich ist. Mögliche Werte: Erfolg: Vorgang war erfolgreich. Fehler: Vorgang war nicht erfolgreich. Die messageStellt Details bereit. Datentyp: Zeichenfolge

Das folgende Beispiel zeigt, wie SVG aus dem Beschreibungsfeld eines Incident-Datensatzes abgerufen wird, um die SVG in PDF zu konvertieren und an einen Datensatz anzuhängen.

var gr = new GlideRecord("incident");

var svg;

if (gr.get("<tableSysId>")) {
 svg = gr.description.toString();
}

var v = new sn_pdfgeneratorutils.SVGToPDFConversionAPI();

var result = v.convertSVGToPDF(svg, "ConvertSVGToPDF", "incident", "<targetTableSysId>");
gs.info(JSON.stringify(result));

Ausgabe:

{"attachment_id":"<pdf_attachment_sys_id>","message":"SVG to PDF conversion is successful.","status":"success"}

SVGToPDFConversionAPI – konvertSVGToPDFWithSize(Zeichenfolge svg, Zeichenfolge nameForPDF, Zeichenfolge targetTable, Zeichenfolge targetTableSysId, Zahl svgImgWidth, NummernsvgImgHeight)

Konvertiert eine als Zeichenfolge bereitgestellte SVG mit Bildbreiten- und -Höhen-Werten in PDF.

Tabelle : 6. Parameter

Name	Typ	Beschreibung
svg	Zeichenfolge	SVG zum Konvertieren in ein PDF-Dokument.
PdfName	Zeichenfolge	Name für die PDF-Datei. Standard: SYS_ID der PDF-Datei in der Tabelle „Anhänge“ [sys_attachment].
targetTable	Zeichenfolge	Name der Tabelle, an die die konvertierte PDF angehängt werden soll .
TargetTableSysId	Zeichenfolge	SYS_ID des Datensatzes, an den die konvertierte PDF angehängt werden soll.
SvgImgWidth	Anzahl	Breite des SVG-Bilds in Pixel.
SvgImgHeight	Anzahl	Höhe des SVG-Bilds in Pixel.

Tabelle : 7. Rückgaben

Typ	Beschreibung
Objekt	Objekt mit sys_ID des PDF-Anhangs, der aus SVG konvertiert wurde, falls erfolgreich, andernfalls Fehlermeldung. { "attachment_id": "String", "message": "String", "status": "String" }
<Object>. ​Attachment_ID	Wenn die SVG-Konvertierung erfolgreich ist, sys_ID der angehängten PDF-Datei. Die Datei wird in der Tabelle „Anhänge“ [sys_attachment] aufgeführt. Datentyp: Zeichenfolge
<Object>.Nachricht	Nachricht, die Erfolg oder Fehler bestätigt. Mögliche Werte: Fehler beim Konvertieren des SVG-Bilds in das PDF-Dokument. Ausnahme beim Lesen des Quelldokumentinhalts. Angegebener Zieldatensatz [<tableName> – <targetTableSysId>] ist nicht vorhanden. – Sys_ID der Zieltabelle ist nicht in der angegebenen Tabelle enthalten. Stellen Sie sicher, dass Sie den richtigen Tabellennamen für den Datensatz angeben. Der Zieltabellenname – <tableName> zum Anhängen der konvertierten SVG ist ungültig Der Zieltabellenname – <tableName> zum Anhängen der konvertierten SVG ist leer oder null SVG-in-PDF-Konvertierung erfolgreich. Datentyp: Zeichenfolge
<Object>.Status	Status, der angibt, ob der Vorgang erfolgreich ist. Mögliche Werte: Erfolg: Vorgang war erfolgreich. Fehler: Vorgang war nicht erfolgreich. Die messageStellt Details bereit. Datentyp: Zeichenfolge

Das folgende Beispiel zeigt, wie SVG aus dem Beschreibungsfeld eines Incident-Datensatzes abgerufen wird, um SVG in PDF zu konvertieren und an einen Datensatz anzuhängen.

var gr = new GlideRecord("incident");

var svg;

if (gr.get("<tableSysId>")) {
 svg = gr.description.toString();
}

var v = new sn_pdfgeneratorutils.SVGToPDFConversionAPI();

var result = v.convertSVGToPDFWithSize(svg, "ConvertSVGToPDF", "incident", "<targetTableSysId>", 600, 150);
gs.info(JSON.stringify(result));

Ausgabe:

{"attachment_id":"<pdf_attachment_sys_id>","message":"SVG to PDF conversion is successful.","status":"success"}