PDFGenerationAPI : champ d’application, global

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 47 minutes de lecture
  • PDFGenerationAPI prend en charge la conversion PDF et la gestion des champs 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.

    Utilisez cette glide.pdf.url.whitelist propriété pour ajouter une validation supplémentaire afin de s’assurer que toute URL externe introduite doit être incluse dans le PDF généré. : si la propriété système glide.pdf.url.whitelisting.enabled est définie sur vrai, le PDF ne traite pas le contenu de l’URL, sauf s’il est répertorié dans le champ Valeur de la propriété système com.snc.pdf.whitelisted_urls. Ces propriétés sont répertoriées dans le tableau Propriétés système [sys_properties]. Pour en savoir plus, consultez Available system properties.

    Les méthodes de cette classe activent les tâches suivantes :
    Remarque :
    Ces méthodes peuvent également être utilisées pour les documents créés par des éléments hors catalogue.

    PDFGenerationAPI – PDFGenerationAPI()

    Instancie un nouvel objet PDFGenerationAPI .

    Tableau 1. Paramètres
    Nom Type Description
    Aucun

    L’exemple suivant montre comment créer un objet PDFGenerationAPI .

    var v = new sn_pdfgeneratorutils.PDFGenerationAPI;

    PDFGenerationAPI – convertToPDF(String html, String targetTable, String targetTableSysId, String pdfName, String fontFamilySysId, Object documentConfiguration)

    Convertit une chaîne HTML en document PDF.

    Cette méthode crée un PDF en utilisant le format de page A4 – 595 × 842 points. Le contenu sera tronqué s’il dépasse cette taille.

    Pour générer un PDF avec des paramètres supplémentaires, tels que la taille de la page, l’orientation et les numéros de page, utilisez convertToPDFWithHeaderFooter().

    Tableau 2. Paramètres
    Nom Type Description
    HTML Chaîne HTML à convertir en document PDF.
    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 PDF dans la table Pièces jointes [sys_attachment].

    fontFamilySysId Chaîne Facultatif. Sys_id de la famille de polices à utiliser pour le PDF. Cette sys_id provient de la table Famille de polices de génération PDF [sys_pdf_generation_font_family].

    Valeur par défaut : aucun

    documentConfiguration Objet Facultatif. Objet contenant une configuration de table des matières et une configuration de numéro de page.
    {​
       "accessibilityEnabled" : Boolean,
       "toc_config" : "String",​
       "page_number_config": "String"​
    }​
    documentConfiguration.accessibilityEnabled Booléen Facultatif. Marqueur indiquant s’il faut formater le PDF généré pour prendre en charge l’accessibilité. Lorsque cette fonctionnalité est activée, des balises d’accessibilité sont disponibles dans l’arborescence des balises PDF pour aider les utilisateurs qui utilisent des lecteurs d’écran à naviguer, comprendre et interagir avec les documents PDF générés.
    Valeurs valides :
    • true : le PDF généré est formaté pour l’accessibilité.
    • false : le PDF généré n’est pas formaté pour l’accessibilité.

    Valeur par défaut : false

    documentConfiguration.toc_config Chaîne Facultatif. Sys_id de la configuration de la table des matières à utiliser pour le PDF. Cette sys_id est issue de la table Configuration de la table des matières [doc_toc_config].

    Valeur par défaut : aucun

    documentConfiguration.page_number_config Chaîne Facultatif. Sys_id de la configuration du numéro de page à utiliser pour le PDF. Cette sys_id provient de la table Configuration du numéro de page [doc_page_number_config].

    Valeur par défaut : aucun

    Tableau 3. Renvoie
    Type Description
    Objet Objet contenant sys_id de la pièce jointe PDF si la conversion est réussie, message d’erreur dans le cas contraire.
    {
      "attachment_id": "String",
      "message": "String",
      "request_id": "String",
      "status": "String"
    }
    <Object>.​attachment_id Si la conversion HTML réussit, sys_id du PDF converti et 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. – Aucun PDF créé. Assurez-vous que les valeurs fournies sont exactes.
    • La conversion est réussie. – Le HTML a été converti avec succès en PDF.
    • Exception lors de la lecture du contenu du document source. En-tête de PDF introuvable. – La pièce jointe fournie n’est pas un PDF valide. Fournir la pièce jointe correcte sys_id.
    • L’enregistrement cible indiqué [<tableName> <targetTableSysId>] n’existe pas. : la table cible sys_id n’est pas dans la table fournie. Assurez-vous d’inclure le nom de table correct pour l’enregistrement.
    • Aucun formulaire associé au PDF à remplir. attachmentSysId : <sys_id>
    • Il n’existe aucun champ modifiable avec des noms spécifiés. Veuillez vérifier et réessayer. Noms de champs : <noms de champs>
    • Impossible de poursuivre la demande, car la pièce jointe avec sys_id [{0}] n’a pas réussi l’analyse de sécurité – Le PDF n’a pas réussi l’analyse antivirus.
    • La demande ne peut pas être traitée car la pièce jointe avec sys_id [{0}] est en attente d’analyse de sécurité – Le PDF nécessite une analyse antivirus.
    • Demande terminée avec succès : l’opération est réussie.
    • Non défini : Sys_id fourni n’existe pas ou n’est pas une pièce jointe PDF.
    • < URL > n’est pas répertoriée dans l’URL sur liste blanche, veuillez vérifier la propriété de la liste d’inclusion des URL : « glide.pdf.url.whitelisting.enabled » et « com.snc.pdf.whitelisted_urls » : si la propriété système glide.pdf.url.whitelisting.enabled est définie sur vrai, le PDF ne traite pas le contenu de l’URL, sauf s’il est répertorié dans le champ Valeur de la propriété système com.snc.pdf.whitelisted_urls. Ces propriétés sont répertoriées dans le tableau Propriétés système [sys_properties].

    Type de données : chaîne

    <Object>.request_id Sys_id de l’enregistrement de la demande du créateur de changement.

    Type de données : chaîne

    <Object>.statut État indiquant si l’opération a réussi.
    Valeurs possibles :
    • réussite : l’opération a réussi.
    • échec : l’opération n’a pas réussi. Le message fournit des détails.

    Type de données : chaîne

    L’exemple suivant montre comment convertir du code HTML en PDF et le joindre à un enregistrement dans la table Incident [incident].

    var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
    
    //  (Option) get HTML from the description field of an incident record
    var gr = new GlideRecord("incident");
    var html;
    
    if (gr.get("<tableSysId>")) {
     html = gr.description.toString();
    }
    
    var result = v.convertToPDF(html, "incident", "<target_sys_id>", "myPDF");
    gs.info(JSON.stringify(result));

    Sortie :

    {"attachment_id":"<sys_id>","message":"Conversion is successful.","request_id":"<change_sys_id>","status":"success"}

    PDFGenerationAPI – convertToPDFAsync(String html, String targetTable, String targetTableSysId, String pdfName, String fontFamilySysId, Object documentConfiguration)

    Met en scène une tâche qui convertit une chaîne HTML en document PDF de manière asynchrone. Le traitement asynchrone vous permet de travailler dans l’instance pendant que la conversion PDF est en cours. Ceci est particulièrement utile pour les exportations PDF plus volumineuses.

    Cette API crée un PDF en utilisant le format de page A4 – 595 × 842 points. Le contenu sera tronqué s’il dépasse cette taille.

    Pour générer un PDF avec des paramètres supplémentaires, tels que la taille de la page, l’orientation et les numéros de page, utilisez convertToPDFWithHeaderFooterAsync().

    Tableau 4. Paramètres
    Nom Type Description
    HTML Chaîne HTML à convertir en document PDF.
    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 PDF dans la table Pièces jointes [sys_attachment].

    fontFamilySysId Chaîne Facultatif. Sys_id de la famille de polices à utiliser pour le PDF. Cette sys_id provient de la table Famille de polices de génération PDF [sys_pdf_generation_font_family].

    Valeur par défaut : aucun

    documentConfiguration Objet Facultatif. Objet contenant une configuration de table des matières et une configuration de numéro de page.
    {​
       "accessibilityEnabled" : Boolean,
       "toc_config" : "String",​
       "page_number_config": "String"​
    }​
    documentConfiguration.accessibilityEnabled Booléen Facultatif. Marqueur indiquant s’il faut formater le PDF généré pour prendre en charge l’accessibilité. Lorsque cette fonctionnalité est activée, des balises d’accessibilité sont disponibles dans l’arborescence des balises PDF pour aider les utilisateurs qui utilisent des lecteurs d’écran à naviguer, comprendre et interagir avec les documents PDF générés.
    Valeurs valides :
    • true : le PDF généré est formaté pour l’accessibilité.
    • false : le PDF généré n’est pas formaté pour l’accessibilité.

    Valeur par défaut : false

    documentConfiguration.toc_config Chaîne Facultatif. Sys_id de la configuration de la table des matières à utiliser pour le PDF. Cette sys_id est issue de la table Configuration de la table des matières [doc_toc_config].

    Valeur par défaut : aucun

    documentConfiguration.page_number_config Chaîne Facultatif. Sys_id de la configuration du numéro de page à utiliser pour le PDF. Cette sys_id provient de la table Configuration du numéro de page [doc_page_number_config].

    Valeur par défaut : aucun

    Tableau 5. Renvoie
    Type Description
    Objet Objet indiquant si la conversion PDF est en cours. Vous pouvez consulter l’état de la conversion dans le tableau État de la génération de PDF [sys_pdf_generation_status].
    {
      "message": "String",
      "request_id": "String"
    }
    <Object>.Message Message confirmant la réussite ou l’erreur.
    Valeurs possibles :
    • La conversion HTML en PDF est en cours. – La demande de conversion de HTML en document PDF est réussie.
    • Exception lors de la lecture du contenu du document source. En-tête de PDF introuvable. – La pièce jointe fournie n’est pas un PDF valide. Fournir la pièce jointe correcte sys_id.
    • L’enregistrement cible indiqué [<tableName> <targetTableSysId>] n’existe pas. : la table cible sys_id n’est pas dans la table fournie. Assurez-vous d’inclure le nom de table correct pour l’enregistrement.
    • Aucun formulaire associé au PDF à remplir. attachmentSysId : <sys_id>
    • Il n’existe aucun champ modifiable avec des noms spécifiés. Veuillez vérifier et réessayer. Noms de champs : <noms de champs>
    • Impossible de poursuivre la demande, car la pièce jointe avec sys_id [{0}] n’a pas réussi l’analyse de sécurité – Le PDF n’a pas réussi l’analyse antivirus.
    • La demande ne peut pas être traitée car la pièce jointe avec sys_id [{0}] est en attente d’analyse de sécurité – Le PDF nécessite une analyse antivirus.
    • Non défini : Sys_id fourni n’existe pas ou n’est pas une pièce jointe PDF.
    • < URL > n’est pas répertoriée dans l’URL sur liste blanche, veuillez vérifier la propriété de la liste d’inclusion des URL : « glide.pdf.url.whitelisting.enabled » et « com.snc.pdf.whitelisted_urls » : si la propriété système glide.pdf.url.whitelisting.enabled est définie sur vrai, le PDF ne traite pas le contenu de l’URL, sauf s’il est répertorié dans le champ Valeur de la propriété système com.snc.pdf.whitelisted_urls. Ces propriétés sont répertoriées dans le tableau Propriétés système [sys_properties].

    Type de données : chaîne

    <Object>.request_id Sys_id de l’enregistrement de la demande du créateur de changement.

    Type de données : chaîne

    L’exemple suivant montre comment mettre en file d’attente une tâche qui convertit du HTML en PDF. Lorsque la conversion est terminée, le PDF nommé « myPDF » est joint à l’enregistrement cible dans la table Incident [incident].

    var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
    
    //  (Option) get HTML from the description field of an incident record
    var gr = new GlideRecord("incident");
    var html;
    
    if (gr.get("<tableSysId>")) {
     html = gr.description.toString();
    }
    
    var result = v.convertToPDFAsync(html, "incident", "<target_sys_id>", "myPDF");
    gs.info(JSON.stringify(result));

    Sortie :

    {"message":"HTML to PDF Conversion is in progress.","request_id":"<sys_id>"}

    PDFGenerationAPI – convertToPDFWithHeaderFooter(String html, String targetTable, String targetTableSysId, String pdfName, Object headerFooterInfo, String fontFamilySysId, Object documentConfiguration)

    Convertit une chaîne HTML en PDF avec contenu d’en-tête et de pied de page.

    Utilisez cette méthode pour générer des PDF avec des paramètres de page :
    • Informations d’en-tête et de pied de page
    • Tailles des marges
    • Orientation
    • Énumération
    • Taille de page
    Tableau 6. Paramètres
    Nom Type Description
    HTML Chaîne HTML à convertir en document PDF.
    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 PDF dans la table Pièces jointes [sys_attachment].

    headerFooterInfo Objet Définit les détails d’en-tête et de pied de page du PDF.
    {
      "FooterImageAlignment": "String",
      "FooterImageAttachmentId": "String",
      "FooterImageHeight": "String",
      "FooterText": "String",
      "FooterTextAlignment": "String",
      "GeneratePageNumber": "String",
      "HeaderImageAlignment": "String",
      "HeaderImageAttachmentId": "String",
      "HeaderImageHeight": "String",
      "LeftOrRightMargin": "String",
      "PageOrientation": "String",
      "PageSize": "String",
      "TopOrBottomMargin": "String"
    }
    headerFooterInfo.Alignement de l’image du pied de page Chaîne Définit la position de l’image dans le pied de page.
    Valeurs valides :
    • BOTTOM_CENTER : Placez l’image en bas au centre du pied de page.
    • BOTTOM_LEFT : Positionnez l’image dans la zone inférieure gauche du pied de page.
    • BOTTOM_RIGHT : Positionnez l’image dans la zone inférieure droite du pied de page.
    • TOP_CENTER : Placez l’image en haut au centre du pied de page.
    • TOP_LEFT : Positionnez l’image dans la zone supérieure gauche du pied de page.
    • TOP_RIGHT : Placez l’image dans la zone supérieure droite du pied de page.
    headerFooterInfo.Pied de pageImageAttachmentId Chaîne Sys_id de l’image de pied de page dans la table Pièces jointes [sys_attachment]. Pour déterminer si le type de fichier est pris en charge dans votre instance, accédez à Propriétés système, Sécurité, et vérifiez s’il est répertorié dans le champ Liste d’extensions de fichier (séparées par des virgules) qui peuvent être jointes .
    headerFooterInfo.Hauteur de l’image de pied de page Chaîne Hauteur de l’image de pied de page.

    Par défaut : 50 points

    headerFooterInfo.Texte de pied de page Chaîne Texte de pied de page à placer au bas de chaque page PDF.
    headerFooterInfo.Alignement du texte de pied de page Chaîne Définit la position du texte dans le pied de page. Assurez-vous que cette valeur ne correspond pas ou n’entre pas en conflit avec la zone fournie dans headerFooterInfo.FooterImageAlignment.
    Valeurs valides :
    • BOTTOM_CENTER : Placez le texte en bas au centre du pied de page.
    • BOTTOM_LEFT : Placez le texte dans la zone inférieure gauche du pied de page.
    • BOTTOM_RIGHT : Placez le texte dans la zone inférieure droite du pied de page.
    • TOP_CENTER : Placez le texte en haut au centre du pied de page.
    • TOP_LEFT : Placez le texte dans la zone supérieure gauche du pied de page.
    • TOP_RIGHT : Placez le texte dans la zone supérieure droite du pied de page.
    headerFooterInfo.Numéro de GeneratePageNumber Chaîne Marqueur indiquant s’il faut générer un numéro de page PDF.
    Valeurs valides :
    • vrai : générer des numéros de page.
    • faux : ne générez pas de numéros de page.

    Par défaut : true

    headerFooterInfo.Alignement de l’image d’en-tête Chaîne Définit la position de l’image dans l’en-tête.
    Valeurs valides :
    • centre : Placez l’image au centre de l’en-tête.
    • gauche : placez l’image sur le côté gauche de l’en-tête.
    • droite : Placez l’image sur le côté droit de l’en-tête.
    headerFooterInfo.HeaderImageAttachmentId Chaîne Sys_id de l’image d’en-tête dans la table Pièces jointes [sys_attachment]. Pour déterminer si le type de fichier est pris en charge dans votre instance, accédez à Propriétés système, Sécurité, et vérifiez s’il est répertorié dans le champ Liste d’extensions de fichier (séparées par des virgules) qui peuvent être jointes .
    headerFooterInfo.HeaderImageHeight Chaîne Hauteur de l’image d’en-tête.

    Par défaut : 50 points

    headerFooterInfo.Marge gauche ou droite Chaîne Taille des marges gauche et droite. S’il est placé sur le côté gauche ou droit de la page, les détails de l’en-tête et du pied de page sont placés dans cette zone.

    Par défaut : 36 points

    headerFooterInfo.Orientation de la page Chaîne Orientation de la page.
    Valeurs valides :
    • PORTRAIT
    • PAYSAGE

    Par défaut : portrait

    headerFooterInfo.Pagesize Chaîne Taille de la page du document.
    Valeurs valides :
    • A4 – 595 × 842 points
    • LETTRE – 612 × 792 points
    • GRAND LIVRE – 792 x 1224 points

    Le contenu est tronqué s’il dépasse la taille de la page.

    headerFooterInfo.Marge supérieure ou inférieure Chaîne Taille des marges supérieure et inférieure. Les détails d’en-tête et de pied de page sont placés dans cette zone.

    Par défaut : 72 points

    fontFamilySysId Chaîne Facultatif. Sys_id de la famille de polices à utiliser pour le PDF. Cette sys_id provient de la table Famille de polices de génération PDF [sys_pdf_generation_font_family].

    Valeur par défaut : aucun

    documentConfiguration Objet Facultatif. Objet contenant une configuration de table des matières et une configuration de numéro de page.
    {​
       "accessibilityEnabled" : Boolean,
       "toc_config" : "String",​
       "page_number_config": "String"​
    }​
    documentConfiguration.accessibilityEnabled Booléen Facultatif. Marqueur indiquant s’il faut formater le PDF généré pour prendre en charge l’accessibilité. Lorsque cette fonctionnalité est activée, des balises d’accessibilité sont disponibles dans l’arborescence des balises PDF pour aider les utilisateurs qui utilisent des lecteurs d’écran à naviguer, comprendre et interagir avec les documents PDF générés.
    Valeurs valides :
    • true : le PDF généré est formaté pour l’accessibilité.
    • false : le PDF généré n’est pas formaté pour l’accessibilité.

    Valeur par défaut : false

    documentConfiguration.toc_config Chaîne Facultatif. Sys_id de la configuration de la table des matières à utiliser pour le PDF. Cette sys_id est issue de la table Configuration de la table des matières [doc_toc_config].

    Valeur par défaut : aucun

    documentConfiguration.page_number_config Chaîne Facultatif. Sys_id de la configuration du numéro de page à utiliser pour le PDF. Cette sys_id provient de la table Configuration du numéro de page [doc_page_number_config].

    Valeur par défaut : aucun

    Tableau 7. Renvoie
    Type Description
    Objet Objet contenant sys_id de la pièce jointe PDF si la conversion est réussie, message d’erreur dans le cas contraire.
    {
      "attachment_id": "String",
      "message": "String",
      "request_id": "String",
      "status": "String"
    }
    <Object>.​attachment_id Si la conversion HTML réussit, sys_id du PDF converti et 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. – Aucun PDF créé. Assurez-vous que les valeurs fournies sont exactes.
    • La conversion est réussie. – Le HTML a été converti avec succès en PDF.
    • L’alignement de l’image de pied de page et l’alignement du texte ne peuvent pas se trouver dans la même région avec le même alignement : <valeur footerImageAlignement> : assurez-vous que headerFooterInfo.​FooterImageAlignment les valeurs et headerFooterInfo.​FooterTextAlignment ne se trouvent pas dans la même zone.
    • Exception lors de la lecture du contenu du document source. En-tête de PDF introuvable. – La pièce jointe fournie n’est pas un PDF valide. Fournir la pièce jointe correcte sys_id.
    • L’enregistrement cible indiqué [<tableName> <targetTableSysId>] n’existe pas. : la table cible sys_id n’est pas dans la table fournie. Assurez-vous d’inclure le nom de table correct pour l’enregistrement.
    • Alignement de l’image de pied de page non valide : <invalid_option> est fourni. – Fournir une option valide dans la headerFooterInfo.​FooterImageAlignment propriété.
    • Alignement du texte de pied de page non valide : « + <invalid_option> + » est fourni. – Fournir une option valide dans la headerFooterInfo.​footerTextAlignment propriété.
    • Aucun formulaire associé au PDF à remplir. attachmentSysId : <sys_id>
    • Il n’existe aucun champ modifiable avec des noms spécifiés. Veuillez vérifier et réessayer. Noms de champs : <noms de champs>
    • Impossible de poursuivre la demande, car la pièce jointe avec sys_id [{0}] n’a pas réussi l’analyse de sécurité – Le PDF n’a pas réussi l’analyse antivirus.
    • La demande ne peut pas être traitée car la pièce jointe avec sys_id [{0}] est en attente d’analyse de sécurité – Le PDF nécessite une analyse antivirus.
    • Demande terminée avec succès : l’opération est réussie.
    • Impossible d’obtenir l’image de pied de page. sysId : + <valeur fournie> : assurez-vous que les sys_id fournis headerFooterInfo.​footerImageId sont exacts.
    • Impossible d’obtenir l’image d’en-tête. sysId : + <valeur fournie> : assurez-vous que les sys_id fournis headerFooterInfo.​headerImageId sont exacts.
    • Non défini : Sys_id fourni n’existe pas ou n’est pas une pièce jointe PDF.
    • < URL > n’est pas répertoriée dans l’URL sur liste blanche, veuillez vérifier la propriété de la liste d’inclusion des URL : « glide.pdf.url.whitelisting.enabled » et « com.snc.pdf.whitelisted_urls » : si la propriété système glide.pdf.url.whitelisting.enabled est définie sur vrai, le PDF ne traite pas le contenu de l’URL, sauf s’il est répertorié dans le champ Valeur de la propriété système com.snc.pdf.whitelisted_urls. Ces propriétés sont répertoriées dans le tableau Propriétés système [sys_properties].

    Type de données : chaîne

    <Object>.request_id Sys_id de l’enregistrement de la demande du créateur de changement.

    Type de données : chaîne

    <Object>.statut État indiquant si l’opération a réussi.
    Valeurs possibles :
    • réussite : l’opération a réussi.
    • échec : l’opération n’a pas réussi. Le message fournit des détails.

    Type de données : chaîne

    L’exemple suivant montre comment convertir du HTML en un PDF nommé « myPDF » et ajouter le PDF en tant que pièce jointe à un enregistrement dans la table Incident [incident]. Le PDF contient un en-tête et un pied de page fournis en pièce jointe.

    var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
    
    //  (Option) get HTML from the description field of an incident record
    var gr = new GlideRecord("incident");
    var html;
    
    if (gr.get("<tableSysId>")) {
     html = gr.description.toString();
    }
    
    var hfInfo = new Object();
    hfInfo["HeaderImageAttachmentId"] = "<hdrImgAttSysId>";
    hfInfo["HeaderImageAlignment"] = "left";
    hfInfo["FooterImageAttachmentId"] = "<ftrImgAttSysId>";
    hfInfo["FooterImageAlignment"] = "TOP_CENTER";
    hfInfo["FooterText"] = "Sample Footer Message";
    hfInfo["PageSize"] = "A4";
    hfInfo["GeneratePageNumber"] = "false";
    hfInfo["TopOrBottomMargin"] = "36";
    hfInfo["LeftOrRightMargin"] = "24";
    
    var result = v.convertToPDFWithHeaderFooter(html, "incident", "<targetTbl_sys_id>", "myPDF", hfInfo);
    gs.info(JSON.stringify(result));

    Sortie :

    {"attachment_id":"<sys_id>","message":"Conversion is successful.","request_id":"<change_sys_id>","status":"success"}

    PDFGenerationAPI – convertToPDFWithHeaderFooterAsync(String html, String targetTable, String targetTableSysId, String pdfName, Object headerFooterInfo, String fontFamilySysId, Object documentConfiguration)

    Met en scène une tâche qui convertit une chaîne HTML en PDF avec un contenu d’en-tête et de pied de page de manière asynchrone. Le traitement asynchrone vous permet de travailler dans l’instance pendant que la conversion PDF est en cours. Ceci est particulièrement utile pour les exportations PDF plus volumineuses.

    Utilisez cette méthode pour générer des PDF avec des paramètres de page :
    • Informations d’en-tête et de pied de page
    • Tailles des marges
    • Orientation
    • Énumération
    • Taille de page
    Tableau 8. Paramètres
    Nom Type Description
    HTML Chaîne HTML à convertir en document PDF.
    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 PDF dans la table Pièces jointes [sys_attachment].

    headerFooterInfo Objet Définit les détails d’en-tête et de pied de page du PDF.
    {
      "FooterImageAlignment": "String",
      "FooterImageAttachmentId": "String",
      "FooterImageHeight": "String",
      "FooterText": "String",
      "FooterTextAlignment": "String",
      "GeneratePageNumber": "String",
      "HeaderImageAlignment": "String",
      "HeaderImageAttachmentId": "String",
      "HeaderImageHeight": "String",
      "LeftOrRightMargin": "String",
      "PageOrientation": "String",
      "PageSize": "String",
      "TopOrBottomMargin": "String"
    }
    headerFooterInfo.Alignement de l’image du pied de page Chaîne Définit la position de l’image dans le pied de page.
    Valeurs valides :
    • BOTTOM_CENTER : Placez l’image en bas au centre du pied de page.
    • BOTTOM_LEFT : Positionnez l’image dans la zone inférieure gauche du pied de page.
    • BOTTOM_RIGHT : Positionnez l’image dans la zone inférieure droite du pied de page.
    • TOP_CENTER : Placez l’image en haut au centre du pied de page.
    • TOP_LEFT : Positionnez l’image dans la zone supérieure gauche du pied de page.
    • TOP_RIGHT : Placez l’image dans la zone supérieure droite du pied de page.
    headerFooterInfo.Pied de pageImageAttachmentId Chaîne Sys_id de l’image de pied de page dans la table Pièces jointes [sys_attachment]. Pour déterminer si le type de fichier est pris en charge dans votre instance, accédez à Propriétés système, Sécurité, et vérifiez s’il est répertorié dans le champ Liste d’extensions de fichier (séparées par des virgules) qui peuvent être jointes .
    headerFooterInfo.Hauteur de l’image de pied de page Chaîne Hauteur de l’image de pied de page.

    Par défaut : 50 points

    headerFooterInfo.Texte de pied de page Chaîne Texte de pied de page à placer au bas de chaque page PDF.
    headerFooterInfo.Alignement du texte de pied de page Chaîne Définit la position du texte dans le pied de page. Assurez-vous que cette valeur ne correspond pas ou n’entre pas en conflit avec la zone fournie dans headerFooterInfo.FooterImageAlignment.
    Valeurs valides :
    • BOTTOM_CENTER : Placez le texte en bas au centre du pied de page.
    • BOTTOM_LEFT : Placez le texte dans la zone inférieure gauche du pied de page.
    • BOTTOM_RIGHT : Placez le texte dans la zone inférieure droite du pied de page.
    • TOP_CENTER : Placez le texte en haut au centre du pied de page.
    • TOP_LEFT : Placez le texte dans la zone supérieure gauche du pied de page.
    • TOP_RIGHT : Placez le texte dans la zone supérieure droite du pied de page.
    headerFooterInfo.Numéro de GeneratePageNumber Chaîne Marqueur indiquant s’il faut générer un numéro de page PDF.
    Valeurs valides :
    • vrai : générer des numéros de page.
    • faux : ne générez pas de numéros de page.

    Par défaut : true

    headerFooterInfo.Alignement de l’image d’en-tête Chaîne Définit la position de l’image dans l’en-tête.
    Valeurs valides :
    • centre : Placez l’image au centre de l’en-tête.
    • gauche : placez l’image sur le côté gauche de l’en-tête.
    • droite : Placez l’image sur le côté droit de l’en-tête.
    headerFooterInfo.HeaderImageAttachmentId Chaîne Sys_id de l’image d’en-tête dans la table Pièces jointes [sys_attachment]. Pour déterminer si le type de fichier est pris en charge dans votre instance, accédez à Propriétés système, Sécurité, et vérifiez s’il est répertorié dans le champ Liste d’extensions de fichier (séparées par des virgules) qui peuvent être jointes .
    headerFooterInfo.HeaderImageHeight Chaîne Hauteur de l’image d’en-tête.

    Par défaut : 50 points

    headerFooterInfo.Marge gauche ou droite Chaîne Taille des marges gauche et droite. S’il est placé sur le côté gauche ou droit de la page, les détails de l’en-tête et du pied de page sont placés dans cette zone.

    Par défaut : 36 points

    headerFooterInfo.Orientation de la page Chaîne Orientation de la page.
    Valeurs valides :
    • PORTRAIT
    • PAYSAGE

    Par défaut : portrait

    headerFooterInfo.Pagesize Chaîne Taille de la page du document.
    Valeurs valides :
    • A4 – 595 × 842 points
    • LETTRE – 612 × 792 points
    • GRAND LIVRE – 792 x 1224 points

    Le contenu est tronqué s’il dépasse la taille de la page.

    headerFooterInfo.Marge supérieure ou inférieure Chaîne Taille des marges supérieure et inférieure. Les détails d’en-tête et de pied de page sont placés dans cette zone.

    Par défaut : 72 points

    fontFamilySysId Chaîne Facultatif. Sys_id de la famille de polices à utiliser pour le PDF. Cette sys_id provient de la table Famille de polices de génération PDF [sys_pdf_generation_font_family].

    Valeur par défaut : aucun

    documentConfiguration Objet Facultatif. Objet contenant une configuration de table des matières et une configuration de numéro de page.
    {​
       "accessibilityEnabled" : Boolean,
       "toc_config" : "String",​
       "page_number_config": "String"​
    }​
    documentConfiguration.accessibilityEnabled Booléen Facultatif. Marqueur indiquant s’il faut formater le PDF généré pour prendre en charge l’accessibilité. Lorsque cette fonctionnalité est activée, des balises d’accessibilité sont disponibles dans l’arborescence des balises PDF pour aider les utilisateurs qui utilisent des lecteurs d’écran à naviguer, comprendre et interagir avec les documents PDF générés.
    Valeurs valides :
    • true : le PDF généré est formaté pour l’accessibilité.
    • false : le PDF généré n’est pas formaté pour l’accessibilité.

    Valeur par défaut : false

    documentConfiguration.toc_config Chaîne Facultatif. Sys_id de la configuration de la table des matières à utiliser pour le PDF. Cette sys_id est issue de la table Configuration de la table des matières [doc_toc_config].

    Valeur par défaut : aucun

    documentConfiguration.page_number_config Chaîne Facultatif. Sys_id de la configuration du numéro de page à utiliser pour le PDF. Cette sys_id provient de la table Configuration du numéro de page [doc_page_number_config].

    Valeur par défaut : aucun

    Tableau 9. Renvoie
    Type Description
    Objet
    <Object>.​Message Message confirmant la réussite ou l’erreur.
    Valeurs possibles :
    • La conversion HTML en PDF est en cours. – La demande de conversion de HTML en document PDF est réussie.
    • L’alignement de l’image de pied de page et l’alignement du texte ne peuvent pas se trouver dans la même région avec le même alignement : <valeur footerImageAlignement> : assurez-vous que headerFooterInfo.​FooterImageAlignment les valeurs et headerFooterInfo.​FooterTextAlignment ne se trouvent pas dans la même zone.
    • Exception lors de la lecture du contenu du document source. En-tête de PDF introuvable. – La pièce jointe fournie n’est pas un PDF valide. Fournir la pièce jointe correcte sys_id.
    • L’enregistrement cible indiqué [<tableName> <targetTableSysId>] n’existe pas. : la table cible sys_id n’est pas dans la table fournie. Assurez-vous d’inclure le nom de table correct pour l’enregistrement.
    • Alignement de l’image de pied de page non valide : <invalid_option> est fourni. – Fournir une option valide dans la headerFooterInfo.​FooterImageAlignment propriété.
    • Alignement du texte de pied de page non valide : « + <invalid_option> + » est fourni. – Fournir une option valide dans la headerFooterInfo.​footerTextAlignment propriété.
    • Aucun formulaire associé au PDF à remplir. attachmentSysId : <sys_id>
    • Il n’existe aucun champ modifiable avec des noms spécifiés. Veuillez vérifier et réessayer. Noms de champs : <noms de champs>
    • Impossible de poursuivre la demande, car la pièce jointe avec sys_id [{0}] n’a pas réussi l’analyse de sécurité – Le PDF n’a pas réussi l’analyse antivirus.
    • La demande ne peut pas être traitée car la pièce jointe avec sys_id [{0}] est en attente d’analyse de sécurité – Le PDF nécessite une analyse antivirus.
    • Impossible d’obtenir l’image de pied de page. sysId : + <valeur fournie> : assurez-vous que les sys_id fournis headerFooterInfo.​footerImageId sont exacts.
    • Impossible d’obtenir l’image d’en-tête. sysId : + <valeur fournie> : assurez-vous que les sys_id fournis headerFooterInfo.​headerImageId sont exacts.
    • Non défini : Sys_id fourni n’existe pas ou n’est pas une pièce jointe PDF.
    • < URL > n’est pas répertoriée dans l’URL sur liste blanche, veuillez vérifier la propriété de la liste d’inclusion des URL : « glide.pdf.url.whitelisting.enabled » et « com.snc.pdf.whitelisted_urls » : si la propriété système glide.pdf.url.whitelisting.enabled est définie sur vrai, le PDF ne traite pas le contenu de l’URL, sauf s’il est répertorié dans le champ Valeur de la propriété système com.snc.pdf.whitelisted_urls. Ces propriétés sont répertoriées dans le tableau Propriétés système [sys_properties].

    Type de données : chaîne

    <Object>.request_id Sys_id de l’enregistrement de la demande du créateur de changement.

    Type de données : chaîne

    L’exemple suivant montre comment mettre en file d’attente une tâche qui convertit du HTML en PDF. Le PDF contient un en-tête et un pied de page fournis en pièce jointe. Lorsque la conversion est terminée, le PDF nommé « myPDF » est joint à l’enregistrement cible dans la table Incident [incident].

    var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
    
    //  (Option) get HTML from the description field of an incident record
    var gr = new GlideRecord("incident");
    var html;
    
    if (gr.get("<tableSysId>")) {
     html = gr.description.toString();
    }
    
    var hfInfo = new Object();
    hfInfo["HeaderImageAttachmentId"] = "<hdrImgAttSysId>";
    hfInfo["HeaderImageAlignment"] = "left";
    hfInfo["FooterImageAttachmentId"] = "<ftrImgAttSysId>";
    hfInfo["FooterImageAlignment"] = "TOP_CENTER";
    hfInfo["FooterText"] = "Sample Footer Message";
    hfInfo["PageSize"] = "A4";
    hfInfo["GeneratePageNumber"] = "false";
    hfInfo["TopOrBottomMargin"] = "36";
    hfInfo["LeftOrRightMargin"] = "24";
    
    var result = v.convertToPDFWithHeaderFooterAsync(html, "incident", "<targetTbl_sys_id>", "myPDF", hfInfo);
    gs.info(JSON.stringify(result));

    Sortie :

    {"message":"HTML to PDF Conversion is in progress.","request_id":"<sys_id>"}

    PDFGenerationAPI : fillDocumentFields(Object fieldsMap, String sysId, String tableName, String tableSysId, String pdfName)

    remplit les champs d’un PDF modifiable et le joint à l’enregistrement fourni.

    Utilisez les méthodes suivantes pour déterminer si le PDF peut être rempli et obtenir des informations sur le champ :
    PDFGenerationAPI fournit des méthodes de remplissage supplémentaires avec différentes options :
    Tableau 10. Paramètres
    Nom Type Description
    fieldMap Objet Facultatif. Carte de valeur de clé par nom de champ PDF et valeur à remplir. Utilisez la méthode getDocumentFields() pour obtenir la liste des champs disponibles.
    sysId Chaîne Sys_id d’un PDF dans la table Pièces jointes [sys_attachment].
    tableName Chaîne Nom de la table contenant l’enregistrement auquel le PDF est joint. Vous pouvez trouver cette valeur dans la même ligne que la pièce jointe répertoriée dans le tableau Pièces jointes [sys_attachment].
    tableSysId Chaîne Sys_id de l’enregistrement auquel le PDF est joint. Vous pouvez trouver cette valeur dans la même ligne que la pièce jointe répertoriée dans le tableau Pièces jointes [sys_attachment].
    Nom pdf Chaîne Nom à donner au PDF.

    Par défaut : Sys_id du PDF dans la table Pièces jointes [sys_attachment].

    Tableau 11. Renvoie
    Type Description
    Objet Objet contenant sys_id de la pièce jointe PDF mise à jour en cas de réussite, message d’erreur dans le cas contraire.
    {
      "attachment_id": "String",
      "message": "String",
      "status": "String"
    }
    <Object>.​attachment_id Si l’opération réussit, sys_id du PDF rempli. 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 valides :
    • Exception lors de la lecture du contenu du document source. En-tête de PDF introuvable. – La pièce jointe fournie n’est pas un PDF valide. Fournir la pièce jointe correcte sys_id.
    • L’enregistrement cible indiqué [<tableName> <targetTableSysId>] n’existe pas. : la table cible sys_id n’est pas dans la table fournie. Assurez-vous d’inclure le nom de table correct pour l’enregistrement.
    • Aucun formulaire associé au PDF à remplir. attachmentSysId : <sys_id>
    • Il n’existe aucun champ modifiable avec des noms spécifiés. Veuillez vérifier et réessayer. Noms de champs : <noms de champs>
    • Impossible de poursuivre la demande, car la pièce jointe avec sys_id [{0}] n’a pas réussi l’analyse de sécurité – Le PDF n’a pas réussi l’analyse antivirus.
    • La demande ne peut pas être traitée car la pièce jointe avec sys_id [{0}] est en attente d’analyse de sécurité – Le PDF nécessite une analyse antivirus.
    • Demande terminée avec succès : l’opération est réussie.
    • Non défini : Sys_id fourni n’existe pas ou n’est pas une pièce jointe PDF.

    Type de données : chaîne

    <Object>.statut État indiquant si l’opération a réussi.
    Valeurs possibles :
    • réussite : l’opération a réussi.
    • échec : l’opération n’a pas réussi. Le message fournit des détails.

    Type de données : chaîne

    L’exemple suivant montre comment remplir les champs d’un PDF modifiable.

    var fieldMap = new Object();
    fieldMap["Address"] = "Address value here";
    fieldMap["State"] = "State value here";
    
    var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
    var result = v.fillDocumentFields(fieldMap, "<attachmentSysId>", "<tableName>", "<tableSysId>", "pdfName");
    gs.info(JSON.stringify(result));

    Sortie :

    {"attachment_id":"<sys_id>","message":"Request completed successfully.","status":"success"}

    PDFGenerationAPI – fillDocumentFieldsAndFlatten(Object fieldsMap, String sysId, String tableName, String tableSysId, String pdfName, Object flatten)

    Remplit les champs dans un PDF modifiable, aplatit les champs de données et les joint à l’enregistrement fourni.

    Utilisez les méthodes suivantes pour déterminer si le PDF peut être rempli et obtenir des informations sur le champ :
    PDFGenerationAPI fournit des méthodes de remplissage supplémentaires avec différentes options :
    Tableau 12. Paramètres
    Nom Type Description
    fieldMap Objet Facultatif. Carte de valeur de clé par nom de champ PDF et valeur à remplir. Utilisez la méthode getDocumentFields() pour obtenir la liste des champs disponibles.
    sysId Chaîne Sys_id d’un PDF dans la table Pièces jointes [sys_attachment].
    tableName Chaîne Nom de la table contenant l’enregistrement auquel le PDF est joint. Vous pouvez trouver cette valeur dans la même ligne que la pièce jointe répertoriée dans le tableau Pièces jointes [sys_attachment].
    tableSysId Chaîne Sys_id de l’enregistrement auquel le PDF est joint. Vous pouvez trouver cette valeur dans la même ligne que la pièce jointe répertoriée dans le tableau Pièces jointes [sys_attachment].
    Nom pdf Chaîne Nom à donner au PDF.

    Par défaut : Sys_id du PDF dans la table Pièces jointes [sys_attachment].

    aplatir Objet Facultatif. L’aplatissement des champs permet de verrouiller les champs afin que d’autres utilisateurs ne puissent pas modifier les informations. Spécifiez la clé en tant que « FlattenType » et fournissez une option d’aplatissement en tant que chaîne.
    Valeurs valides :
    • donot_flatten : n’aplatissez aucun champ.
    • partially_flatten : aplatissez uniquement les champs qui sont modifiés.
    • fully_flatten : aplatit tous les champs.

    Par défaut : fully_flatten

    {
      "FlattenType": "String" 
    }
    Tableau 13. Renvoie
    Type Description
    Objet Objet contenant sys_id de la pièce jointe PDF mise à jour en cas de réussite, message d’erreur dans le cas contraire.
    {
      "attachment_id": "String",
      "message": "String",
      "status": "String"
    }
    <Object>.​attachment_id Si l’opération réussit, sys_id du PDF rempli. 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 valides :
    • Exception lors de la lecture du contenu du document source. En-tête de PDF introuvable. – La pièce jointe fournie n’est pas un PDF valide. Fournir la pièce jointe correcte sys_id.
    • L’enregistrement cible indiqué [<tableName> <targetTableSysId>] n’existe pas. : la table cible sys_id n’est pas dans la table fournie. Assurez-vous d’inclure le nom de table correct pour l’enregistrement.
    • Aucun formulaire associé au PDF à remplir. attachmentSysId : <sys_id>
    • Il n’existe aucun champ modifiable avec des noms spécifiés. Veuillez vérifier et réessayer. Noms de champs : <noms de champs>
    • Impossible de poursuivre la demande, car la pièce jointe avec sys_id [{0}] n’a pas réussi l’analyse de sécurité – Le PDF n’a pas réussi l’analyse antivirus.
    • La demande ne peut pas être traitée car la pièce jointe avec sys_id [{0}] est en attente d’analyse de sécurité – Le PDF nécessite une analyse antivirus.
    • Demande terminée avec succès : l’opération est réussie.
    • Non défini : Sys_id fourni n’existe pas ou n’est pas une pièce jointe PDF.

    Type de données : chaîne

    <Object>.statut État indiquant si l’opération a réussi.
    Valeurs possibles :
    • réussite : l’opération a réussi.
    • échec : l’opération n’a pas réussi. Le message fournit des détails.

    Type de données : chaîne

    L’exemple suivant montre comment remplir des champs et aplatir un PDF modifiable.

    var fieldMap = new Object();
    fieldMap["Last Name First Name Middle Initial"] = "Tuter Abel E.";
    fieldMap["Date of Birth"] = "08101952";
    fieldMap["US SSN"] = "111-22-9999";
    fieldMap["Address"] = "PO Box 344";
    fieldMap["City"] = "Jerome";
    fieldMap["State"] = "AZ";
    fieldMap["Zip"] = "86331";
    
    var flatten = new Object();
    flatten["FlattenType"] = "partially_flatten";
    
    var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
    var result = v.fillDocumentFieldsAndFlatten(fieldMap, "<attachmentSysId>", "<tableName>", "<tableSysId>", "pdfName", flatten);
    gs.info(JSON.stringify(result));

    Sortie :

    "attachment_id":"<sys_id>","message":"Request completed successfully.","status":"success"

    PDFGenerationAPI : fillFieldsAndMergeSignature(Object fieldsMap, String sysId, String tableName, String tableSysId, String pdfName, PdfMergeSignRequestor requestor, Object flatten)

    Remplit les champs dans un PDF modifiable, ajoute une image de signature, aplatit les champs de données et les joint à l’enregistrement fourni.

    Utilisez les méthodes suivantes pour déterminer si le PDF peut être rempli et obtenir des informations sur le champ :
    PDFGenerationAPI fournit des méthodes de remplissage supplémentaires avec différentes options :
    Tableau 14. Paramètres
    Nom Type Description
    fieldMap Objet Facultatif. Carte de valeur de clé par nom de champ PDF et valeur à remplir. Utilisez la méthode getDocumentFields() pour obtenir la liste des champs disponibles.
    sysId Chaîne Sys_id d’un PDF dans la table Pièces jointes [sys_attachment].
    tableName Chaîne Nom de la table contenant l’enregistrement auquel le PDF est joint. Vous pouvez trouver cette valeur dans la même ligne que la pièce jointe répertoriée dans le tableau Pièces jointes [sys_attachment].
    tableSysId Chaîne Sys_id de l’enregistrement auquel le PDF est joint. Vous pouvez trouver cette valeur dans la même ligne que la pièce jointe répertoriée dans le tableau Pièces jointes [sys_attachment].
    Nom pdf Chaîne Nom à donner au PDF.

    Par défaut : Sys_id du PDF dans la table Pièces jointes [sys_attachment].

    demandeur PdfMergeSignRequestor Entrée de signature renvoyée par pdfMergeSignRequestor.
    aplatir Objet Facultatif. L’aplatissement des champs permet de verrouiller les champs afin que d’autres utilisateurs ne puissent pas modifier les informations. Spécifiez la clé en tant que « FlattenType » et fournissez une option d’aplatissement en tant que chaîne.
    Valeurs valides :
    • donot_flatten : n’aplatissez aucun champ.
    • partially_flatten : aplatissez uniquement les champs qui sont modifiés.
    • fully_flatten : aplatit tous les champs.

    Par défaut : fully_flatten

    {
      "FlattenType": "String" 
    }
    Tableau 15. Renvoie
    Type Description
    Objet Objet contenant sys_id de la pièce jointe PDF mise à jour en cas de réussite, message d’erreur dans le cas contraire.
    {
      "attachment_id": "String",
      "message": "String",
      "status": "String"
    }
    <Object>.​attachment_id Si l’opération réussit, sys_id du PDF rempli. 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 valides :
    • Exception lors de la lecture du contenu du document source. En-tête de PDF introuvable. – La pièce jointe fournie n’est pas un PDF valide. Fournir la pièce jointe correcte sys_id.
    • L’enregistrement cible indiqué [<tableName> <targetTableSysId>] n’existe pas. : la table cible sys_id n’est pas dans la table fournie. Assurez-vous d’inclure le nom de table correct pour l’enregistrement.
    • Aucun formulaire associé au PDF à remplir. attachmentSysId : <sys_id>
    • Il n’existe aucun champ modifiable avec des noms spécifiés. Veuillez vérifier et réessayer. Noms de champs : <noms de champs>
    • Impossible de poursuivre la demande, car la pièce jointe avec sys_id [{0}] n’a pas réussi l’analyse de sécurité – Le PDF n’a pas réussi l’analyse antivirus.
    • La demande ne peut pas être traitée car la pièce jointe avec sys_id [{0}] est en attente d’analyse de sécurité – Le PDF nécessite une analyse antivirus.
    • Demande terminée avec succès : l’opération est réussie.
    • Non défini : Sys_id fourni n’existe pas ou n’est pas une pièce jointe PDF.

    Type de données : chaîne

    <Object>.statut État indiquant si l’opération a réussi.
    Valeurs possibles :
    • réussite : l’opération a réussi.
    • échec : l’opération n’a pas réussi. Le message fournit des détails.

    Type de données : chaîne

    L’exemple suivant montre comment remplir des champs avec une signature avec des paramètres par défaut pour aplatir complètement les champs.

    var fieldMap = new Object();
    fieldMap["Address_Salutation"] = "Address value here";
    
    var paramMap = new Object();
    paramMap["FlattenType"] = "partially_flatten";
    
    var requestor = new sn_pdfgeneratorutils.PdfMergeSignRequestor;
    requestor.createRequest("<attachmentSysId>", "incident", "<tableSysId>", "filledPdf");
    requestor.addSignatureMapping(6, 40, 50, 188, 44, "<signatureSysId>");
    
    var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
    var result = v.fillFieldsAndMergeSignature(fieldMap, "<attachmentSysId>", "incident", "<tableSysId>", requestor, "filledPdf", paramMap);
    gs.info(JSON.stringify(result));
    Sortie :
    {"attachment_id":"5440d993dbed3010d66be1191396194e","message":"Request completed successfully.","status":"success"}

    PDFGenerationAPI : getDocumentFields(String sysId)

    Obtient une liste de champs modifiables dans un document PDF. Permet de lister les champs PDF modifiables sans ouvrir manuellement le fichier à vérifier.

    Tableau 16. Paramètres
    Nom Type Description
    sysId Chaîne Sys_id d’un PDF dans la table Pièces jointes [sys_attachment].
    Tableau 17. Renvoie
    Type Description
    Objet Objet contenant l’ID du PDF signé, message d’erreur dans le cas contraire.
    {
      "attachment_id": "String",
      "message": "String",
      "status": "String"
    }
    <Object>.champs Si la demande aboutit, liste contenant le nom de chaque champ dans le PDF.

    Type de données : tableau de chaînes

    "fields": ["field_name"]
    <Object>.Message Message confirmant la réussite ou l’erreur.
    Valeurs possibles :
    • Exception lors de la lecture du contenu du document source. En-tête de PDF introuvable. – La pièce jointe fournie n’est pas un PDF valide. Fournir la pièce jointe correcte sys_id.
    • Impossible de poursuivre la demande, car la pièce jointe avec sys_id [{0}] n’a pas réussi l’analyse de sécurité – Le PDF n’a pas réussi l’analyse antivirus.
    • La demande ne peut pas être traitée car la pièce jointe avec sys_id [{0}] est en attente d’analyse de sécurité – Le PDF nécessite une analyse antivirus.
    • Demande terminée avec succès : l’opération est réussie.
    • Non défini : Sys_id fourni n’existe pas ou n’est pas une pièce jointe PDF.

    Type de données : chaîne

    <Object>.statut État indiquant si l’opération a réussi.
    Valeurs possibles :
    • réussite : l’opération a réussi.
    • échec : l’opération n’a pas réussi. Le message fournit des détails.

    Type de données : chaîne

    L’exemple suivant montre comment récupérer les champs d’une pièce jointe PDF.

    var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
    var result = v.getDocumentFields("attachmentSysId");
    gs.info(JSON.stringify(result));
    

    Sortie :

    {"message":"Request completed successfully.","fields":["NP_formFillable","reset","print","1SSN","Signature.1","5sigDate","Check Box21"],"status":"success"}

    PDFGenerationAPI – getDocumentFieldsType(String sysId)

    Obtient le type de champ de l’ensemble de champs modifiables à partir d’un document PDF.

    Tableau 18. Paramètres
    Nom Type Description
    sysId Chaîne Sys_id d’un PDF dans la table Pièces jointes [sys_attachment].
    Tableau 19. Renvoie
    Type Description
    Objet Objet contenant chaque type de champ PDF en cas de réussite, message d’erreur dans le cas contraire.
    {
      "fields_type": {Object},
      "message": "String",
      "status": "String"
    }
    <Object>.fields_type Objet répertoriant chaque champ dans le PDF spécifié en cas de réussite, message d’erreur dans le cas contraire.

    Type de données : objet

    "fields_type": {
      "<field type>": {Object},
    }
    <Object>.fields_type.<champ > Objet contenant le numéro de page de chaque champ. Le nom < champ > représente l’étiquette du champ, par exemple, « SSN », ou une étiquette automatisée représentant le type.

    Type de données : objet

    "<field>": { 
      "fieldsDetails": [Array], // Check boxes, radio buttons, choice boxes only
      "pageNumber": "String",
      "type": "String"
    }
    <Object>.fields_type.<field>.fieldsDetails Liste des objets contenant le nom de champ et la valeur correspondante de chaque option pour les types de champ de choix.
    Types applicables :
    • Case à cocher
    • Boîte de choix
    • Déroulante
    • Boîte de choix à sélection multiple

    Type de données : tableau

    "fieldsDetails": [ 
      "fieldName": "String",
      "value": "String"
    ]
    <Object>.fields_type.<field>.fieldsDetails.fieldName Nom d’un champ de choix.

    Type de données : chaîne

    <Object>.fields_type.<field>.fieldsDetails.value Valeur d’un champ de choix.

    Type de données : chaîne

    <Object>.fields_type.<field>.pageNumber Numéro de page PDF correspondant à ce champ.

    Type de données : chaîne

    <Object>.fields_type.<field>.type Type de champ PDF.
    Valeurs possibles :
    • check_box
    • choice_box
    • combo_box
    • multi_select_choice_box
    • push_button
    • radio_button
    • signature
    • Texte

    Type de données : chaîne

    <Object>.Message Message confirmant la réussite ou l’erreur.
    Valeurs possibles :
    • Exception lors de la lecture du contenu du document source. En-tête de PDF introuvable. – La pièce jointe fournie n’est pas un PDF valide. Fournir la pièce jointe correcte sys_id.
    • Impossible de poursuivre la demande, car la pièce jointe avec sys_id [{0}] n’a pas réussi l’analyse de sécurité – Le PDF n’a pas réussi l’analyse antivirus.
    • La demande ne peut pas être traitée car la pièce jointe avec sys_id [{0}] est en attente d’analyse de sécurité – Le PDF nécessite une analyse antivirus.
    • Demande terminée avec succès : l’opération est réussie.
    • Non défini : Sys_id fourni n’existe pas ou n’est pas une pièce jointe PDF.

    Type de données : chaîne

    <Object>.statut État indiquant si l’opération a réussi.
    Valeurs possibles :
    • réussite : l’opération a réussi.
    • échec : l’opération n’a pas réussi. Le message fournit des détails.

    Type de données : chaîne

    L’exemple suivant montre comment récupérer les types de champs dans une pièce jointe PDF. Les résultats incluent des retours manuels pour plus de lisibilité et sont tronqués pour plus de concision.

    var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
    var result = v.getDocumentFieldsType("<attachmentSysId>");
    gs.info(JSON.stringify(result));
    

    Sortie :

    {"fields_type":{"1ADDLINE2.25":{"pageNumber":2,"type":"text"},"1ADDLINE2.24":{"pageNumber":2,"type":"text"},
    "1ADDLINE2.23":{"pageNumber":2,"type":"text"},"1ADDLINE2.22":{"pageNumber":2,"type":"text"},
    "1ADDLINE2.11":{"pageNumber":2,"type":"text"},
    "Check Box1":{"fieldsDetails":[{"fieldName":"Yes"}],"pageNumber":2,"type":"check_box"},
    "4consentDate.6":{"pageNumber":4,"type":"text"},"4consentDate.7":{"pageNumber":4,"type":"text"},
    "3SSN.9":{"pageNumber":3,"type":"text"},"3SSN.8":{"pageNumber":3,"type":"text"},"3SSN.7":{"pageNumber":3,"type":"text"},
    "pageNumber":2,"type":"check_box"},"Check Box8":{"fieldsDetails":[{"fieldName":"Off"},{"fieldName":"yes"}],
    "4planAdminDate.8":{"pageNumber":4,"type":"text"},"4planAdminDate.7":{"pageNumber":4,"type":"text"},
    "1FirstName_ID.7":{"pageNumber":2,"type":"text"},
    "Check Box9":{"fieldsDetails":[{"fieldName":"Yes"}],"pageNumber":3,"type":"check_box"},
    "1LN.1":{"pageNumber":2,"type":"text"},"1LN.2":{"pageNumber":2,"type":"text"},
    "Check Box11":{"fieldsDetails":[{"fieldName":"Yes"}],"pageNumber":3,"type":"check_box"},
    "1LN.9":{"pageNumber":2,"type":"text"},
    "Check Box17":{"fieldsDetails":[{"fieldName":"Yes"}],"pageNumber":3,"type":"check_box"},
    "Check Box16":{"fieldsDetails":[{"fieldName":"Yes"}],"pageNumber":3,"type":"check_box"},
    "1LN.7":{"pageNumber":2,"type":"text"},"Check Box19":{"fieldsDetails":[{"fieldName":"Yes"}],
    "1LN.8":{"pageNumber":2,"type":"text"},"Check Box18":{"fieldsDetails":[{"fieldName":"Yes"}],
    "print":{"pageNumber":2,"type":"push_button"},"4planAdministrator.1":{"pageNumber":4,"type":"text"},
    "1TaxID.9":{"pageNumber":2,"type":"text"},"4SSN.1":{"pageNumber":3,"type":"text"},"4SSN.2":{"pageNumber":3,"type":"text"},
    "Signature.1":{"pageNumber":4,"type":"text"},"1ZIP.2":{"pageNumber":2,"type":"text"},"1ZIP.3":{"pageNumber":2,"type":"text"},
    "message":"Request completed successfully.","status":"success"}

    PDFGenerationAPI – getFilledDocumentWithSignatureAsBase64(Objet, fieldsMap, String sysId, PdfMergeSignRequestor, demandeur, aplatissement de l’objet)

    remplit les champs d’un PDF modifiable, crée une image et la convertit en PDF encodé en Base64.

    L’encodage Base64 vous permet de générer un PDF sous forme de chaîne dans un document texte, tel que HTML ou JSON, sans endommager la syntaxe des caractères binaires.

    Utilisez les méthodes suivantes pour déterminer si le PDF peut être rempli et obtenir des informations sur le champ :
    PDFGenerationAPI fournit des méthodes de remplissage supplémentaires avec différentes options :
    • fillDocumentFields()remplit les champs d’un PDF modifiable et le joint à l’enregistrement fourni.
    • fillDocumentFieldsAndFlatten()Remplit les champs dans un PDF modifiable, aplatit les champs de données et les joint à l’enregistrement fourni.
    • fillFieldsAndMergeSignature()Remplit les champs dans un PDF modifiable, ajoute une image de signature, aplatit les champs de données et les joint à l’enregistrement fourni.
    Tableau 20. Paramètres
    Nom Type Description
    fieldMap Objet Facultatif. Carte de valeur de clé par nom de champ PDF et valeur à remplir. Utilisez la méthode getDocumentFields() pour obtenir la liste des champs disponibles.
    sysId Chaîne Sys_id d’un PDF dans la table Pièces jointes [sys_attachment].
    demandeur PdfMergeSignRequestor Entrée de signature renvoyée par pdfMergeSignRequestor.
    aplatir Objet Facultatif. L’aplatissement des champs permet de verrouiller les champs afin que d’autres utilisateurs ne puissent pas modifier les informations. Spécifiez la clé en tant que « FlattenType » et fournissez une option d’aplatissement en tant que chaîne.
    Valeurs valides :
    • donot_flatten : n’aplatissez aucun champ.
    • partially_flatten : aplatissez uniquement les champs qui sont modifiés.
    • fully_flatten : aplatit tous les champs.

    Par défaut : fully_flatten

    {
      "FlattenType": "String" 
    }
    Tableau 21. Renvoie
    Type Description
    Chaîne En cas de succès, le PDF converti au format Base64 est ajouté à la table Pièces jointes [sys_attachment]. Le contenu reflète la pièce jointe PDF fournie avec les champs et la signature renseignés. Les champs ne sont pas modifiables à moins qu’une autre option d’aplatissement n’ait été fournie avec le flatten paramètre.
    <Object>.Message Message confirmant la réussite ou l’erreur.
    Valeurs valides :
    • Exception lors de la lecture du contenu du document source. En-tête de PDF introuvable. – La pièce jointe fournie n’est pas un PDF valide. Fournir la pièce jointe correcte sys_id.
    • L’enregistrement cible indiqué [<tableName> <targetTableSysId>] n’existe pas. : la table cible sys_id n’est pas dans la table fournie. Assurez-vous d’inclure le nom de table correct pour l’enregistrement.
    • Aucun formulaire associé au PDF à remplir. attachmentSysId : <sys_id>
    • Il n’existe aucun champ modifiable avec des noms spécifiés. Veuillez vérifier et réessayer. Noms de champs : <noms de champs>
    • Impossible de poursuivre la demande, car la pièce jointe avec sys_id [{0}] n’a pas réussi l’analyse de sécurité – Le PDF n’a pas réussi l’analyse antivirus.
    • La demande ne peut pas être traitée car la pièce jointe avec sys_id [{0}] est en attente d’analyse de sécurité – Le PDF nécessite une analyse antivirus.
    • Demande terminée avec succès : l’opération est réussie.
    • Non défini : Sys_id fourni n’existe pas ou n’est pas une pièce jointe PDF.

    Type de données : chaîne

    <Object>.statut État indiquant si l’opération a réussi.
    Valeurs possibles :
    • réussite : l’opération a réussi.
    • échec : l’opération n’a pas réussi. Le message fournit des détails.

    Type de données : chaîne

    L’exemple suivant montre comment charger deux champs dans une pièce jointe PDF, aplatir les champs et convertir le PDF au format Base64.

    var mymap = new Object();
    mymap["City"] = "City value here";
    mymap["State"] = "XX";
    
    // create a requestor
    var requestor = new sn_pdfgeneratorutils.PdfMergeSignRequestor;
    requestor.createRequest("<sys_id>", "tableName", "<tableSysId>", "pdfName");
    requestor.addSignatureMapping(6, 40, 50, 188, 44, "<signImgSysId>");
    var processedRequestObj = requestor.processRequest();
    
    var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
    
    var result = v.getFilledDocumentWithSignatureAsBase64(mymap, "<attachmentSysId>", processedRequestObj);
    gs.info (JSON.stringify(result));

    PDFGenerationAPI : getPdfPageSizes(String sysId)

    Obtient la taille de page d’un document PDF.

    Tableau 22. Paramètres
    Nom Type Description
    sysId Chaîne Sys_id d’un PDF dans la table Pièces jointes [sys_attachment].
    Tableau 23. Renvoie
    Type Description
    Objet Objet contenant la taille de chaque page en cas de réussite, message d’erreur dans le cas contraire.
    {
      "pages_size": {Object},
      "message": "String",
      "status": "String"
    }
    <Object>.pages_size Si l’opération réussit, la largeur et la hauteur de chaque page PDF en points. Le numéro de page est renvoyé sous forme de chaîne et les valeurs de mesure sont renvoyées sous forme de types de données numériques.

    Type de données : objet

    "pages_size": {"<page number>":[<width>,<height>]}
    <Object>.Message Message confirmant la réussite ou l’erreur.
    Valeurs possibles :
    • Impossible de poursuivre la demande, car la pièce jointe avec sys_id [{0}] n’a pas réussi l’analyse de sécurité – Le PDF n’a pas réussi l’analyse antivirus.
    • La demande ne peut pas être traitée car la pièce jointe avec sys_id [{0}] est en attente d’analyse de sécurité – Le PDF nécessite une analyse antivirus.
    • Demande terminée avec succès : l’opération est réussie.
    • Non défini : Sys_id fourni n’existe pas ou n’est pas une pièce jointe PDF.

    Type de données : chaîne

    <Object>.statut État indiquant si l’opération a réussi.
    Valeurs possibles :
    • réussite : l’opération a réussi.
    • échec : l’opération n’a pas réussi. Le message fournit des détails.

    Type de données : chaîne

    L’exemple suivant montre comment afficher la largeur et la hauteur de chaque page dans une pièce jointe PDF.

    var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
    var result = v.getPdfPageSizes ("<attachmentSysId>");
    gs.info(JSON.stringify(result));
    

    Sortie :

    {"pages_size":{"1":[612,792],"2":[612,792],"3":[612,792],"4":[612,792],"5":[612,792]},"message":"Request completed successfully.","status":"success"}
    

    PDFGenerationAPI : isDocumentFillable(String sysId)

    Vérifie si le document PDF contient des champs modifiables.

    Tableau 24. Paramètres
    Nom Type Description
    sysId Chaîne Sys_id d’un PDF dans la table Pièces jointes [sys_attachment].
    Tableau 25. Renvoie
    Type Description
    Objet Objet contenant la taille de chaque page en cas de réussite, message d’erreur dans le cas contraire.
    {
      "document_editable": "String",
      "message": "String",
      "status": "String"
    }
    <Object>.​document_editable Si l’opération réussit, marqueur indiquant si le document est modifiable.
    Valeurs valides :
    • vrai : le document PDF comporte des champs modifiables.
    • faux : le document PDF n’a pas de champs modifiables.

    Type de données : valeur booléenne fournie sous forme de chaîne

    <Object>.Message Message confirmant la réussite ou l’erreur.
    Valeurs possibles :
    • Exception lors de la lecture du contenu du document source. En-tête de PDF introuvable. – La pièce jointe fournie n’est pas un PDF valide. Fournir la pièce jointe correcte sys_id.
    • Impossible de poursuivre la demande, car la pièce jointe avec sys_id [{0}] n’a pas réussi l’analyse de sécurité – Le PDF n’a pas réussi l’analyse antivirus.
    • La demande ne peut pas être traitée car la pièce jointe avec sys_id [{0}] est en attente d’analyse de sécurité – Le PDF nécessite une analyse antivirus.
    • Demande terminée avec succès : l’opération est réussie.
    • Non défini : Sys_id fourni n’existe pas ou n’est pas une pièce jointe PDF.

    Type de données : chaîne

    <Object>.statut État indiquant si l’opération a réussi.
    Valeurs possibles :
    • réussite : l’opération a réussi.
    • échec : l’opération n’a pas réussi. Le message fournit des détails.

    Type de données : chaîne

    L’exemple suivant montre comment déterminer si les champs de document PDF sont modifiables.

    var v = new sn_pdfgeneratorutils.PDFGenerationAPI;
    var result = v.isDocumentFillable("<attachmentSysId>");
    gs.info(JSON.stringify(result));
    

    Sortie :

    {"message":"Request completed successfully.","document_editable":"true","status":"success"}

    PDFGenerationAPI – redact(Object inputJson)

    Applique la rédaction à un document PDF en fonction des coordonnées rectangulaires, des mots clés de recherche ou des deux indiqués. Une copie expurgée du PDF original est générée dans la table Pièces jointes [sys_attachment].

    Remarque :
    • Les résultats de la rédaction peuvent inclure un bloc de texte blanc caviardé inattendu qui écrase le texte qui n’est pas destiné à être caviardé. Si cet événement se produit, vous pouvez sélectionner manuellement le contenu à caviarder à l’aide de la highlightedSections propriété ou du module d’extension PDF Generation Utilities. Pour plus d'informations, consultez Redact data from documents.
    • Cette méthode ne prend pas en charge la rédaction dans les fichiers PDF contenant des images JBIG2.
    Tableau 26. Paramètres
    Nom Type Description
    inputJson Objet Identifie le PDF et son contenu à expurger.
    {
      "sysId": "String",
      "highlightedSections": [Array],
      "searchedKeywords": [Array]
    }
    inputJson.sysId Chaîne Sys_id d’un PDF dans la table Pièces jointes [sys_attachment].
    inputJson. sections mises en surbrillance Tableau d'objets Liste des coordonnées rectangulaires fournies en tant qu’objet. Chaque coordonnée représente l’emplacement du contenu à biffer sur chaque page.
    Facultatif si la searchedKeywords propriété est incluse.
    [
       {
         "pageNumber": Number,
         "x": Number,
         "y": Number,
         "width": Number,
         "height": Number
       }
    ]
    inputJson. mis en surbrillance. Numéro de page Numéro Numéro de page PDF contenant le contenu à sélectionner pour la rédaction.
    inputJson. mis en surbrillance. x Numéro Axe X (position horizontale) du rectangle de rédaction sur le PDF en points. La valeur dans le coin inférieur gauche de la page PDF est de 0. Par exemple, une valeur de 306 place le rectangle approximativement au centre horizontal d’une page PDF au format lettre.
    inputJson. mis en surbrillance. y Numéro Axe Y (position verticale) du rectangle de rédaction sur le PDF en points. La valeur dans le coin inférieur gauche de la page PDF est de 0. Par exemple, une valeur de 396 place le rectangle approximativement au centre vertical d’une page PDF au format lettre.
    inputJson. mis en surbrillance. Largeur Numéro La largeur du rectangle de rédaction est en points. Cette valeur augmente la taille du rectangle horizontalement à partir du point inférieur gauche où les axes x et y se croisent.
    inputJson. mis en surbrillance. hauteur Numéro Hauteur du rectangle de rédaction en points. Cette valeur augmente la taille du rectangle verticalement à partir du point inférieur gauche où les axes x et y se croisent.
    inputJson. mots-clés recherchés Tableau Liste d’une ou plusieurs chaînes utilisées pour trouver du texte à biffer. La taille du rectangle de rédaction correspond à la hauteur et à la largeur du texte qui est bloqué en conséquence.
    Facultatif si la highlightedSections propriété est incluse.
    Remarque :
    Dans certains cas, les chaînes de texte contenant des caractères spéciaux ou des signes de ponctuation tels que « éléments : » et « PDF » ne sont pas rédigées. Vous pouvez également supprimer le caractère de la chaîne ou mettre en surbrillance la zone pour supprimer le texte.
    Tableau 27. Renvoie
    Type Description
    Objet Objet contenant sys_id de la pièce jointe PDF mise à jour en cas de réussite, message d’erreur dans le cas contraire.
    {
      "attachment_id": "String",
      "message": "String",
      "status": "String"
    }
    <Object>.​attachment_id Si l’opération réussit, sys_id du PDF rempli. 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 :
    • Impossible d’analyser ce format : impossible de traiter une image incorporée dans le PDF. Le PDF contient une ou plusieurs images dans un format non pris en charge, comme une image JBIG2.
    • Exception lors de la lecture du contenu du document source. En-tête de PDF introuvable. – La pièce jointe fournie n’est pas un PDF valide. Fournir la pièce jointe correcte sys_id.
    • Impossible de poursuivre la demande, car la pièce jointe avec sys_id [{0}] n’a pas réussi l’analyse de sécurité – Le PDF n’a pas réussi l’analyse antivirus.
    • La demande ne peut pas être traitée car la pièce jointe avec sys_id [{0}] est en attente d’analyse de sécurité – Le PDF nécessite une analyse antivirus.
    • Demande terminée avec succès : l’opération est réussie.
    • Non défini : Sys_id fourni n’existe pas ou n’est pas une pièce jointe PDF.

    Type de données : chaîne

    <Object>.statut État indiquant si l’opération a réussi.
    Valeurs possibles :
    • réussite : l’opération a réussi.
    • échec : l’opération n’a pas réussi. Le message fournit des détails.

    Type de données : chaîne

    L’exemple suivant montre comment biffer par rectangle et mot clé. Sur le PDF expurgé, les zones sélectionnées à la page 2 sont masquées. La chaîne '23' est rédigée sur toutes les pages sur lesquelles elle se trouve.

    var pdfRequest = {
      sysId: 'e4b3ae35fc128210f877789781ea59f3',
      highlightedSections: [
        {
          "pageNumber": 2,
          "x": 261.75,
          "y": 480,
          "width": 21,
          "height": 14.25
        },
        {
          "pageNumber": 2,
          "x": 249,
          "y": 390.75,
          "width": 63.75,
          "height": 15.75
        }
        // Add more coordinates as needed
      ],
      searchedKeywords: ['23']
    };
    
    // Convert the JSON object to a string
    var jsonRequest = JSON.stringify(pdfRequest);
    gs.info('JSON Request: ' + jsonRequest + '\n');
    
    var PDFRedaction = new sn_pdfgeneratorutils.PDFGenerationAPI;
    var result = PDFRedaction.redact(jsonRequest);
    gs.info(JSON.stringify(result));

    Sortie :

    JSON Request: {"sysId":"e4b3ae35fc128210f877789781ea59f3","highlightedSections":[{"pageNumber":2,"x":261.75,"y":480,"width":21,"height":14.25},{"pageNumber":2,"x":249,"y":390.75,"width":63.75,"height":15.75}],"searchedKeywords":[23]}
    
    {"attachment_id":"1744ae35fc128210f877789781ea59fc","message":"Request completed successfully.","status":"success"}