--- sourceDocument: Xanadu-API-Referenz sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference Release : - xanadu ft:locale : - de-DE ft:publication_title : - Xanadu-API-Referenz ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # SVGToPDFConversionAPI: Bereichsbezogen, global # SVGToPDFConversionAPI: Bereichsbezogen, global {#ariaid-title1} * Freigeben Version: Xanadu * * Aktualisiert 1. August 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 Minuten Lesedauer Die SVGToPDFConversionAPI bietet Methoden, die das Hinzufügen einer SVG-Datei zu einer PDF-Datei und die Konvertierung einer SVG-Datei in eine PDF-Datei ermöglichen. 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. Siehe auch [PDFGenerationAPI](https://www.servicenow.com/docs/MBdtnESrY~nspFYQ4NpxMw#PDFGenerationAPIBothAPI "Die PDFGenerationAPI bietet Unterstützung für die PDF-Konvertierung und die Verarbeitung von PDF-Feldern."). ## SVGToPDFConversionAPI: SVGToPDFConversionAPI() {#ariaid-title2} Instanziiert ein neues SVGToPDFConversionAPI- Objekt. {#SV-SVGToPDFConversionAPI__table_twm_hjk_34b__entry__3} | Name | Typ | Beschreibung | |-|-|-| | Keine | | | [Tabelle : 1. Parameter] {#SV-SVGToPDFConversionAPI__table_twm_hjk_34b} Die folgenden Beispiele zeigen, wie ein SVGToPDFConversionAPI- Objekt erstellt wird. var v = new sn_pdfgeneratorutils.SVGToPDFConversionAPI(); ## SVGToPDFConversionAPI - addSVGToPDF(Zeichenfolge „svg", Zeichenfolge „inputPdfSysId", „Zeichenfolge targetTable", „Zeichenfolge targetSysId", „Zeichenfolge nameForPdf", „Nummer pageNo", „Nummer x", „Nummer y", „Nummer SVGImgWidth", „Nummer SVGImgHeight") {#ariaid-title3} Fügt einer PDF-Datei auf einer angegebenen Seite ein SVG-Bild mit Bildgröße und Standortkoordinaten hinzu. {#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__table_gms_ycm_j4b__entry__3}{#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__api_pdfgen_parm_fill_tableN_desc} | 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-Datei 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 der gleichen Zeile wie den Anhang in der Tabelle „Anhänge" \[sys_attachment\]. | | targetTableSysId | Zeichenfolge | Sys_id des Datensatzes, an den die PDF-Datei angehängt ist. Sie finden diesen Wert in der gleichen Zeile wie den Anhang in der Tabelle „Anhänge" \[sys_attachment\]. | | targetTable | Zeichenfolge | Name der Tabelle, an die die konvertierte PDF-Datei angehängt werden soll. | | targetTableSysId | Zeichenfolge | Sys_id des Datensatzes, an den die konvertierte PDF-Datei 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 | Nummer | Seitenzahl in der angehängten PDF-Datei, auf der die SVG-Datei platziert werden soll. | | x | Nummer | Horizontale Position der SVG-Datei auf der Seite. Der Wert wird in Punkten angegeben. | | y | Nummer | Vertikale Position der SVG-Datei auf der Seite. Der Wert wird in Punkten angegeben. | | SVGImgWidth | Nummer | Breite des SVG-Bilds in Pixel. | | SVGImgHeight | Nummer | Höhe des SVG-Bilds in Pixel. | [Tabelle : 2. Parameter] {#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__table_gms_ycm_j4b} {#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__table_hms_ycm_j4b__entry__2}{#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__row_svg2PDF-return-svg_attach} | Typ | Beschreibung | |-|-| | Objekt | Objekt mit der sys_id eines neuen PDF-Anhangs mit eingefügter SVG-Datei bei Erfolg, andernfalls Fehlermeldung. { "attachment_id": "String", "message": "String", "status": "String" } | | \.​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 | | \.message | Meldung, die den Erfolg oder Fehler bestätigt. Mögliche Werte: * Fehler beim Hinzufügen von SVG-Inhalten zu PDF. * Das Hinzufügen von SVG-Dateien zu PDFs und das Erstellen einer neuen PDF-Datei war erfolgreich. * Angegebener Zieldatensatz \[\ -\ \] ist nicht vorhanden. -- sys_id der Zieltabelle befindet sich nicht in der angegebenen Tabelle. Stellen Sie sicher, dass Sie den richtigen Tabellennamen für den Datensatz angeben. * Sys-ID des eingegebenen PDF-Anhangs zum Hinzufügen des SVG-Inhalts ist null * Der eingegebene SVG-Inhalt ist leer oder null * PdfReader ist nicht mit Besitzerpasswort geöffnet * Der Name der Zieltabelle zum Anhängen der geänderten PDF-Datei:\ ist leer oder null * Der Name der Zieltabelle zum Anhängen der geänderten PDF-Datei:\ ist ungültig {#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__ul_zv2_wq3_k4b} Datentyp: Zeichenfolge | | \.status | Status, der angibt, ob der Vorgang erfolgreich ist. Mögliche Werte: * erfolgreich: Vorgang war erfolgreich. * Fehler: Vorgang war nicht erfolgreich. message enthält Details. {#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__ul_rlv_5cv_j4b} Datentyp: Zeichenfolge | [Tabelle : 3. Ergebnisse] {#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__table_hms_ycm_j4b} Das folgende Beispiel zeigt, wie Sie SVG-Dateien aus dem Beschreibungsfeld eines incident-Datensatzes abrufen und auf Seite 5 eines PDF-Anhangs hinzufügen. Die neue PDF-Datei mit SVG-Datei befindet sich in der Tabelle „Anhänge" \[sys_attachment\]. var gr = new GlideRecord("incident"); var svg; if (gr.get("")) { svg = gr.description.toString(); } var result = new sn_pdfgeneratorutils.SVGToPDFConversionAPI().addSVGToPDF(svg, "", "incident", "", "AddSVGToPDF", 5, 30, 30, 300, 100); gs.info(JSON.stringify(result)); Ausgabe: {"attachment_id":"","message":"Adding SVG to PDF and creating new PDF is successful.","status":"success"} ## SVGToPDFConversionAPI - konvertierenSVGToPDF(String „svg", „String pdfName", „String targetTable", „String targetTableSysId") {#ariaid-title4} Konvertiert eine als Zeichenfolge bereitgestellte SVG-Datei in eine PDF-Datei. {#SV-convertSVGToPDF_S_S_S_S__table_gms_ycm_j4b__entry__3}{#SV-convertSVGToPDF_S_S_S_S__api_pdfgen_parm_fill_tableN_desc} | 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-Datei angehängt werden soll. | | targetTableSysId | Zeichenfolge | Sys_id des Datensatzes, an den die konvertierte PDF-Datei angehängt werden soll. | [Tabelle : 4. Parameter] {#SV-convertSVGToPDF_S_S_S_S__table_gms_ycm_j4b} {#SV-convertSVGToPDF_S_S_S_S__table_hms_ycm_j4b__entry__2} | Typ | Beschreibung | |-|-| | Objekt | Objekt mit der sys_id des aus SVG konvertierten PDF-Anhangs bei Erfolg, andernfalls Fehlermeldung. { "attachment_id": "String", "message": "String", "status": "String" } | | \.​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 | | \.message | Meldung, die den Erfolg oder Fehler bestätigt. Mögliche Werte: * Fehler beim Konvertieren des SVG-Bilds in ein PDF-Dokument. * Ausnahme beim Lesen des Quelldokumentinhalts. * Angegebener Zieldatensatz \[\ -\ \] ist nicht vorhanden. -- sys_id der Zieltabelle befindet sich nicht in der angegebenen Tabelle. Stellen Sie sicher, dass Sie den richtigen Tabellennamen für den Datensatz angeben. * Konvertierung von SVG in PDF erfolgreich. * Der Name der Zieltabelle --\ zum Anhängen der konvertierten SVG-Datei ist ungültig * Der Name der Zieltabelle --\ zum Anhängen der konvertierten SVG-Datei ist leer oder null {#SV-convertSVGToPDF_S_S_S_S__ul_zv2_wq3_k4b} Datentyp: Zeichenfolge | | \.status | Status, der angibt, ob der Vorgang erfolgreich ist. Mögliche Werte: * erfolgreich: Vorgang war erfolgreich. * Fehler: Vorgang war nicht erfolgreich. message enthält Details. {#SV-convertSVGToPDF_S_S_S_S__ul_rlv_5cv_j4b} Datentyp: Zeichenfolge | [Tabelle : 5. Ausgabe] {#SV-convertSVGToPDF_S_S_S_S__table_hms_ycm_j4b} Das folgende Beispiel zeigt, wie Sie die SVG-Datei aus dem Beschreibungsfeld eines Incident-Datensatzes abrufen, um die SVG-Datei in eine PDF-Datei zu konvertieren und an einen Datensatz anzuhängen. var gr = new GlideRecord("incident"); var svg; if (gr.get("")) { svg = gr.description.toString(); } var v = new sn_pdfgeneratorutils.SVGToPDFConversionAPI(); var result = v.convertSVGToPDF(svg, "ConvertSVGToPDF", "incident", ""); gs.info(JSON.stringify(result)); Ausgabe: {"attachment_id":"","message":"SVG to PDF conversion is successful.","status":"success"} ## SVGToPDFConversionAPI - konvertierenSVGToPDFWithSize(Zeichenfolge SVG, Zeichenfolge nameForPDF, Zeichenfolge targetTable, Zeichenfolge targetTableSysId, Anzahl SVGImgWidth, Anzahl SVGImgHeight) {#ariaid-title5} Konvertiert eine als Zeichenfolge bereitgestellte SVG-Datei in eine PDF-Datei mit Werten für Bildbreite und -höhe. {#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__table_nqj_1dm_j4b__entry__3}{#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__api_pdfgen_parm_fill_tableN_desc} | 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-Datei angehängt werden soll. | | targetTableSysId | Zeichenfolge | Sys_id des Datensatzes, an den die konvertierte PDF-Datei angehängt werden soll. | | SVGImgWidth | Nummer | Breite des SVG-Bilds in Pixel. | | SVGImgHeight | Nummer | Höhe des SVG-Bilds in Pixel. | [Tabelle : 6. Parameter] {#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__table_nqj_1dm_j4b} {#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__table_hms_ycm_j4b__entry__2} | Typ | Beschreibung | |-|-| | Objekt | Objekt mit der sys_id des aus SVG konvertierten PDF-Anhangs bei Erfolg, andernfalls Fehlermeldung. { "attachment_id": "String", "message": "String", "status": "String" } | | \.​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 | | \.message | Meldung, die den Erfolg oder Fehler bestätigt. Mögliche Werte: * Fehler beim Konvertieren des SVG-Bilds in ein PDF-Dokument. * Ausnahme beim Lesen des Quelldokumentinhalts. * Angegebener Zieldatensatz \[\ -\ \] ist nicht vorhanden. -- sys_id der Zieltabelle befindet sich nicht in der angegebenen Tabelle. Stellen Sie sicher, dass Sie den richtigen Tabellennamen für den Datensatz angeben. * Der Name der Zieltabelle --\ zum Anhängen der konvertierten SVG-Datei ist ungültig * Der Name der Zieltabelle --\ zum Anhängen der konvertierten SVG-Datei ist leer oder null * Konvertierung von SVG in PDF erfolgreich. {#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__ul_zv2_wq3_k4b} Datentyp: Zeichenfolge | | \.status | Status, der angibt, ob der Vorgang erfolgreich ist. Mögliche Werte: * erfolgreich: Vorgang war erfolgreich. * Fehler: Vorgang war nicht erfolgreich. message enthält Details. {#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__ul_rlv_5cv_j4b} Datentyp: Zeichenfolge | [Tabelle : 7. Ergebnisse] {#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__table_hms_ycm_j4b} Das folgende Beispiel zeigt, wie Sie die SVG-Datei aus dem Beschreibungsfeld eines Incident-Datensatzes abrufen, um die SVG-Datei in eine PDF-Datei zu konvertieren und an einen Datensatz anzuhängen. var gr = new GlideRecord("incident"); var svg; if (gr.get("")) { svg = gr.description.toString(); } var v = new sn_pdfgeneratorutils.SVGToPDFConversionAPI(); var result = v.convertSVGToPDFWithSize(svg, "ConvertSVGToPDF", "incident", "", 600, 150); gs.info(JSON.stringify(result)); Ausgabe: {"attachment_id":"","message":"SVG to PDF conversion is successful.","status":"success"}