---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# SVGToPDFConversionAPI : délimité, global

# SVGToPDFConversionAPI : délimité, global {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 minutes de lecture

SVGToPDFConversionAPI fournit des méthodes qui permettent l'ajout d'un SVG à un PDF et la conversion d'un SVG en PDF.

Cette API fait partie du module d'extension ServiceNow PDF Generation Utilities (com.snc.apppdfgenerator) et est fournie dans l'espace de noms `sn_pdfgeneratorutils` . Le module d'extension est activé par défaut.

Voir aussi [PDFGenerationAPI.](https://servicenow-prod.fluidtopics.net/q_fpr42fLYukVHSh6kG_2A#PDFGenerationAPIBothAPI "PDFGenerationAPI prend en charge la conversion PDF et la gestion des champs PDF.")

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

Instancie un nouvel objet SVGToPDFConversionAPI .
{#SV-SVGToPDFConversionAPI__table_twm_hjk_34b__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 1. Paramètres]

{#SV-SVGToPDFConversionAPI__table_twm_hjk_34b}  
Les exemples suivants montrent comment créer un objet SVGToPDFConversionAPI .

    var v = new sn_pdfgeneratorutils.SVGToPDFConversionAPI();

## SVGToPDFConversionAPI : addSVGToPDF(String svg, String inputPdfSysId, String targetTable, String targetSysId, String nameForPdf, Number pageNo, Number x, Number y, Number svgImgWidth, Number svgImgHeight) {#ariaid-title3}

Ajoute une image SVG à un PDF sur une page spécifiée avec la taille de l'image et les coordonnées d'emplacement.
{#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}

| Nom | Type | Description |
|-|-|-|
| SVG | Chaîne | SVG à convertir en document PDF. |
| inputPdfSysId | Chaîne | Sys_id du PDF cible dans lequel créer une copie avec un SVG. Le PDF cible se trouve dans la table Pièces jointes \[sys_attachment\]. |
| targetTable | Chaîne | Nom de la table contenant l'enregistrement auquel le PDF est joint. Vous trouverez cette valeur dans la même ligne que la pièce jointe répertoriée dans le tableau Pièces jointes \[sys_attachment\]. |
| targetTableSysId | Chaîne | Sys_id de l'enregistrement auquel le PDF est joint. Vous trouverez cette valeur dans la même ligne que la pièce jointe répertoriée dans le tableau Pièces jointes \[sys_attachment\]. |
| targetTable | Chaîne | Nom de la table à laquelle joindre le PDF converti. |
| targetTableSysId | Chaîne | Sys_id de l'enregistrement auquel joindre le PDF converti. |
| Nom pdf | Chaîne | Nom à donner au PDF. Par défaut : Sys_id du fichier PDF dans la table Pièces jointes \[sys_attachment\]. |
| pageNo | Numéro | Numéro de page dans le PDF joint sur lequel placer le SVG. |
| x | Numéro | Position horizontale du SVG dans la page. La valeur est en points. |
| o | Numéro | Position verticale du SVG dans la page. La valeur est en points. |
| svgImgWidth | Numéro | Largeur de l'image SVG en pixels. |
| svgImgHauteur | Numéro | Hauteur de l'image SVG en pixels. |
[Tableau 2. Paramètres]

{#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}

| Type | Description |
|-|-|
| Objet | Objet contenant sys_id d'une nouvelle pièce jointe PDF avec SVG inséré en cas de succès, message d'erreur dans le cas contraire. { "attachment_id": "String", "message": "String", "status": "String" } |
| \<Object\>.​attachment_id | Si la conversion SVG réussit, sys_id du PDF joint. Le fichier est répertorié dans la table Pièces jointes \[sys_attachment\]. Type de données : chaîne |
| \<Object\>.Message | Message confirmant la réussite ou l'erreur. Valeurs possibles : * Échec de l'ajout de contenu SVG au PDF. * L'ajout d'un SVG au PDF et la création d'un nouveau PDF ont réussi. * L'enregistrement cible donné \[\<tableName\> \<targetTableSysId\>\] n'existe pas. : l'sys_id de la table cible n'est pas dans la table fournie. Assurez-vous d'inclure le nom de table correct pour l'enregistrement. * L'ID système de la pièce jointe PDF d'entrée à ajouter au contenu SVG est nul * Le contenu SVG d'entrée est vide ou nul * PdfReader n'est pas ouvert avec le mot de passe du propriétaire * Le nom de la table cible à joindre au PDF modifié : \<targetTable\> est vide ou nul * Nom de la table cible à joindre au PDF modifié : \<targetTable\> n'est pas valide {#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__ul_zv2_wq3_k4b} Type de données : chaîne |
| \<Object\>.statut | État indiquant si l'opération a réussi. Valeurs possibles : * réussite : l'opération s'est déroulée correctement. * échec : échec de l'opération. Fournit message des détails. {#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__ul_rlv_5cv_j4b} Type de données : chaîne |
[Tableau 3. Renvoie]

{#SV-addSVGToPDF_S_S_S_S_S_N_N_N_N_N__table_hms_ycm_j4b}  
L'exemple suivant montre comment obtenir SVG à partir du champ de description d'un enregistrement d'incident et l'ajouter à la page 5 d'une pièce jointe PDF. Le nouveau fichier PDF au format SVG se trouve dans la table Pièces jointes \[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));

Sortie :

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

## SVGToPDFConversionAPI : convertSVGToPDF(String svg, String pdfName, String targetTable, String targetTableSysId) {#ariaid-title4}

Convertit un SVG fourni en tant que chaîne en 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}

| Nom | Type | Description |
|-|-|-|
| SVG | Chaîne | SVG à convertir en document PDF. |
| Nom pdf | Chaîne | Nom à donner au PDF. Par défaut : Sys_id du fichier PDF dans la table Pièces jointes \[sys_attachment\]. |
| targetTable | Chaîne | Nom de la table à laquelle joindre le PDF converti. |
| targetTableSysId | Chaîne | Sys_id de l'enregistrement auquel joindre le PDF converti. |
[Tableau 4. Paramètres]

{#SV-convertSVGToPDF_S_S_S_S__table_gms_ycm_j4b} {#SV-convertSVGToPDF_S_S_S_S__table_hms_ycm_j4b__entry__2}

| Type | Description |
|-|-|
| Objet | Objet contenant sys_id de la pièce jointe PDF convertie à partir de SVG en cas de succès, message d'erreur dans le cas contraire. { "attachment_id": "String", "message": "String", "status": "String" } |
| \<Object\>.​attachment_id | Si la conversion SVG réussit, sys_id du PDF joint. Le fichier est répertorié dans la table Pièces jointes \[sys_attachment\]. Type de données : chaîne |
| \<Object\>.Message | Message confirmant la réussite ou l'erreur. Valeurs possibles : * Échec de la conversion de l'image SVG en document PDF. * Exception lors de la lecture du contenu du document source. * L'enregistrement cible donné \[\<tableName\> \<targetTableSysId\>\] n'existe pas. : l'sys_id de la table cible n'est pas dans la table fournie. Assurez-vous d'inclure le nom de table correct pour l'enregistrement. * La conversion SVG en PDF a réussi. * Le nom de la table cible \<tableName \> pour joindre le SVG converti n'est pas valide * Le nom de la table cible \<tableName \> pour joindre le SVG converti est vide ou nul {#SV-convertSVGToPDF_S_S_S_S__ul_zv2_wq3_k4b} Type de données : chaîne |
| \<Object\>.statut | État indiquant si l'opération a réussi. Valeurs possibles : * réussite : l'opération s'est déroulée correctement. * échec : échec de l'opération. Fournit message des détails. {#SV-convertSVGToPDF_S_S_S_S__ul_rlv_5cv_j4b} Type de données : chaîne |
[Tableau 5. Renvoie]

{#SV-convertSVGToPDF_S_S_S_S__table_hms_ycm_j4b}  
L'exemple suivant montre comment obtenir SVG à partir du champ de description d'un enregistrement d'incident, pour convertir le SVG en PDF et le joindre à un enregistrement.

    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));

Sortie :

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

## SVGToPDFConversionAPI : convertSVGToPDFWithSize(String svg, String nameForPDF, String targetTable, String targetTableSysId, Number svgImgWidth, Number svgImgHeight) {#ariaid-title5}

Convertit un SVG fourni sous forme de chaîne en PDF avec les valeurs de largeur et de hauteur de l'image.
{#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}

| Nom | Type | Description |
|-|-|-|
| SVG | Chaîne | SVG à convertir en document PDF. |
| Nom pdf | Chaîne | Nom à donner au PDF. Par défaut : Sys_id du fichier PDF dans la table Pièces jointes \[sys_attachment\]. |
| targetTable | Chaîne | Nom de la table à laquelle joindre le PDF converti. |
| targetTableSysId | Chaîne | Sys_id de l'enregistrement auquel joindre le PDF converti. |
| svgImgWidth | Numéro | Largeur de l'image SVG en pixels. |
| svgImgHauteur | Numéro | Hauteur de l'image SVG en pixels. |
[Tableau 6. Paramètres]

{#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}

| Type | Description |
|-|-|
| Objet | Objet contenant sys_id de la pièce jointe PDF convertie à partir de SVG en cas de succès, message d'erreur dans le cas contraire. { "attachment_id": "String", "message": "String", "status": "String" } |
| \<Object\>.​attachment_id | Si la conversion SVG réussit, sys_id du PDF joint. Le fichier est répertorié dans la table Pièces jointes \[sys_attachment\]. Type de données : chaîne |
| \<Object\>.Message | Message confirmant la réussite ou l'erreur. Valeurs possibles : * Échec de la conversion de l'image SVG en document PDF. * Exception lors de la lecture du contenu du document source. * L'enregistrement cible donné \[\<tableName\> \<targetTableSysId\>\] n'existe pas. : l'sys_id de la table cible n'est pas dans la table fournie. Assurez-vous d'inclure le nom de table correct pour l'enregistrement. * Le nom de la table cible \<tableName \> pour joindre le SVG converti n'est pas valide * Le nom de la table cible \<tableName \> pour joindre le SVG converti est vide ou nul * La conversion SVG en PDF a réussi. {#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__ul_zv2_wq3_k4b} Type de données : chaîne |
| \<Object\>.statut | État indiquant si l'opération a réussi. Valeurs possibles : * réussite : l'opération s'est déroulée correctement. * échec : échec de l'opération. Fournit message des détails. {#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__ul_rlv_5cv_j4b} Type de données : chaîne |
[Tableau 7. Renvoie]

{#SV-convertSVGToPDFWSiz_S_S_S_S_N_N__table_hms_ycm_j4b}  
L'exemple suivant montre comment obtenir SVG à partir du champ de description d'un enregistrement d'incident, convertir le SVG en PDF et le joindre à un enregistrement.

    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));

Sortie :

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