Portant Docs

Éléments de ligne et tableaux

La plupart des documents que vous créerez avec Portant comportent des lignes qui doivent se répéter : un devis avec une liste de produits, une facture avec des heures facturables, une proposition avec des options de forfait, un bilan trimestriel avec une ligne par transaction. Les éléments de ligne gèrent tout cela.

Cette section centralise tout ce qui concerne les tableaux répétitifs, le tri des lignes et le regroupement d'enregistrements dans un seul document. Les guides propres à chaque source (éléments de ligne d'une transaction HubSpot, regroupement de données Google Sheets, tableaux dans un payload Webhook) renvoient tous ici afin que le comportement soit documenté en un seul endroit.

Ce que signifie « éléments de ligne » dans Portant

Une balise ordinaire telle que {{Customer Name}} insère une valeur unique dans le document. Une balise d'élément de ligne repose sur le même principe, mais elle se trouve à l'intérieur d'une ligne de tableau. Lorsque Portant exécute le workflow, il duplique cette ligne autant de fois qu'il y a d'éléments de ligne dans la source.

Ainsi, une seule ligne de modèle comme celle-ci :

| {{Item}} | {{Quantity}} | {{Unit Price}} | {{Line Total}} |

devient quelque chose comme ceci dans le document de sortie :

| Widget A | 2  | $50.00  | $100.00 |
| Widget B | 1  | $250.00 | $250.00 |
| Widget C | 5  | $20.00  | $100.00 |

La ligne au-dessus et la ligne en dessous de la ligne d'élément de ligne restent à leur place. Vous pouvez donc placer une ligne d'en-tête au-dessus (noms des colonnes) et une ligne de totaux en dessous avec des formules telles que {{=SUM(Line Total)}}. Ces deux lignes restent en place pendant que la ligne centrale se développe.

Dans cette section

  1. Tableaux répétitifs explique comment une seule ligne de balises se développe en plusieurs lignes lors de la fusion.
  2. Trier et ordonner les lignes explique comment contrôler l'ordre dans lequel les lignes apparaissent dans le document de sortie.
  3. Regrouper les lignes dans un seul document explique comment combiner plusieurs enregistrements source dans un seul document de sortie.

Où les éléments de ligne apparaissent dans Portant

Les différentes sources utilisent un vocabulaire légèrement différent pour désigner la même notion. Les guides ci-dessous sont des recettes propres à chaque source, toutes fondées sur les règles exposées ci-dessus :

Voir aussi