Regroupement de données avec les webhooks

Si votre payload de webhook contient un tableau d'objets, Portant peut placer chaque objet en tant que ligne dans un tableau à l'intérieur de votre document. C'est ainsi que vous transformez des données de webhook en factures, devis, bons de commande ou tout autre document comportant des lignes d'articles.

Pour le guide de référence, consultez line items > data grouping. Cette page couvre la configuration spécifique aux webhooks.

Étape 1 : structurer le payload

Le tableau sur lequel vous souhaitez effectuer le regroupement doit :

Se trouver au niveau supérieur du payload (une profondeur de tableau d'un niveau).
Contenir des objets (et non des chaînes de caractères ou des nombres).

Voici un exemple de payload contenant un tel tableau :

{
    "city": "Vancouver",
    "csNo": "QZ2257",
    "narrative": "Test report for testing purposes. ",
    "siteName": "Wanda & Sons Snoopy Landing",
    "clearTime": 1720005608143,
    "onsiteTime": 1720005084713,
    "reportNumber": "R24-113100",
    "responseTime": 24.23,
    "rrAlarmDate": 1720003631000,
    "rrAlarmType": "BURGLARY",
    "siteAddress1": "Unit 36 - 1055 Albert Place",
    "siteAddress2": null,
    "rrInitialZone": 18,
    "rrConfirmedBurg": false,
    "rrConfirmedFire": false,
    "rrPoliceFileNo": [
        {
            "imageLink": "https://drive.usercontent.google.com/download?id=1Hv5r4MMu9_uDf-HyvZcckBRJ-xCRjOGL",
            "imageName": "image_one"
        },
        {
            "imageLink": "https://drive.usercontent.google.com/download?id=1LJhk_pdFtxsnnjyHN0u67kNuWxkYwcL_",
            "imageName": "image_two"
        },
        {
            "imageLink": "https://drive.usercontent.google.com/download?id=11spBeKnsr7oHPZTsJye5fwkJ8SCcQouV",
            "imageName": "image_three"
        }
    ],
    "rrPoliceAttended": false,
    "rrTechnicalIssue": false,
    "rrInitialZoneDesc": "SE Side Patio Door ( new edition room)",
    "rrTechnicalIssueDesc": null
}

Dans cet exemple, rrPoliceFileNo est le tableau sur lequel Portant peut effectuer le regroupement.

Étape 2 : ajouter un tableau au document

Ouvrez le bloc de document et insérez un tableau (Insert > Table (Insérer > Tableau)). Ajoutez les balises des champs regroupés dans une seule ligne du tableau. Portant répétera cette ligne pour chaque objet du tableau.

Vous pouvez également utiliser le regroupement de données avec des modèles Google Slides.

Facultatif : ajoutez des lignes d'en-tête et de pied de page au-dessus et en dessous de la ligne de balises. Elles apparaîtront une fois par groupe, avec les lignes répétées entre elles.

Étape 3 : exécuter le workflow

Une fois les paramètres du document configurés (nom de fichier, PDF, e-mail, etc.), cliquez sur Create Documents (Créer des documents). Chaque résultat inclura un tableau comportant une ligne pour chaque objet du tableau.