---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# SVGToPDFConversionAPI -- Umfang, Global

# SVGToPDFConversionAPI -- Umfang, Global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 5 Minuten Lesedauer

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

Diese API ist Teil von ServiceNowPDF-Generierungsdienstprogramme-Plugin (com.snc.apppdfgenerator) und wird in bereitgestellt `sn_pdfgeneratorutils `Namespace. Das Plugin ist standardmäßig aktiviert.

Siehe auch [PDFGenerationAPI](https://servicenow-prod.fluidtopics.net/53XZmikB3x~3TyIWd0R6UA#PDFGenerationAPIBothAPI "Die PDFGenerationAPI Bietet Unterstützung für die PDF-Konvertierung und die Verarbeitung von PDF-Feldern.").

## SVGToPDFConversionAPI -- SVGToPDFConversionAPI() {#ariaid-title2}

Instanziiert eine neue 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 erstellt wird 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) {#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 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 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 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 in der Tabelle „Anhänge" \[sys_attachment\]. |
| pageNo | Nummer | Seitennummer in der angehängten PDF, auf der die SVG platziert werden soll. |
| x | Nummer | Horizontale Position der SVG auf der Seite. Wert ist in Punkten. |
| y | Nummer | Vertikale Position der SVG auf der Seite. Wert ist in Punkten. |
| 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, das die sys_ID eines neuen PDF-Anhangs mit eingefügtem SVG enthält, falls erfolgreich, andernfalls Fehlermeldung. { "attachment_id": "String", "message": "String", "status": "String" } |
| \<Object\>. ​Anhang_ID | Wenn die SVG-Konvertierung erfolgreich ist, sys_ID der angehängten PDF. 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 des SVG-Inhalts 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 befindet sich nicht in der angegebenen Tabelle. 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 {#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__ul_zv2_wq3_k4b} 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. {#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__ul_rlv_5cv_j4b} Datentyp: Zeichenfolge |
[Tabelle : 3. Rückgaben]

{#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__table_hms_ycm_j4b}  
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 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) {#ariaid-title4}

Konvertiert eine als Zeichenfolge angegebene SVG in PDF.
{#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 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 : 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 sys_ID des PDF-Anhangs, der aus SVG konvertiert wurde, falls erfolgreich, andernfalls Fehlermeldung. { "attachment_id": "String", "message": "String", "status": "String" } |
| \<Object\>. ​Anhang_ID | Wenn die SVG-Konvertierung erfolgreich ist, sys_ID der angehängten PDF. 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 befindet sich nicht in der angegebenen Tabelle. 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 {#SV-convertSVGToPDF_S_S_S_S__ul_zv2_wq3_k4b} 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. {#SV-convertSVGToPDF_S_S_S_S__ul_rlv_5cv_j4b} Datentyp: Zeichenfolge |
[Tabelle : 5. Rückgaben]

{#SV-convertSVGToPDF_S_S_S_S__table_hms_ycm_j4b}  
Das folgende Beispiel zeigt, wie SVG aus dem Beschreibungsfeld eines Incident-Datensatzes abgerufen wird, um die SVG in eine PDF-Datei 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, ZeichenfolgennameForPDF, Zeichenfolge targetTable, Zeichenfolge targetTableSysId, Zahl svgImgWidth, Nummer svgImgHeight) {#ariaid-title5}

Konvertiert eine als Zeichenfolge bereitgestellte SVG mit Werten für Bildbreite und -Höhe in PDF.
{#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 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 | 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 sys_ID des PDF-Anhangs, der aus SVG konvertiert wurde, falls erfolgreich, andernfalls Fehlermeldung. { "attachment_id": "String", "message": "String", "status": "String" } |
| \<Object\>. ​Anhang_ID | Wenn die SVG-Konvertierung erfolgreich ist, sys_ID der angehängten PDF. 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 befindet sich nicht in der angegebenen Tabelle. 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. {#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__ul_zv2_wq3_k4b} 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. {#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__ul_rlv_5cv_j4b} Datentyp: Zeichenfolge |
[Tabelle : 7. Rückgaben]

{#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__table_hms_ycm_j4b}  
Das folgende Beispiel zeigt, wie SVG aus dem Beschreibungsfeld eines Incident-Datensatzes abgerufen wird, um die SVG in eine PDF-Datei 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"}


