Portant Docs

Tableaux répétés

Un tableau répété est une ligne unique dans votre modèle qui se développe en plusieurs lignes lorsque Portant exécute le workflow. Vous concevez une ligne, Portant la clone pour chaque élément de ligne de la source.

C'est le mécanisme qui permet de créer des devis, des factures, des bons de livraison, des déclarations de travaux et tout document répertoriant un nombre variable d'éléments.

Ligne de tableau répétée dans un modèle Portant, développée en une ligne par élément de ligne dans le résultat

Fonctionnement

Une balise ordinaire est remplacée par une valeur unique. Une balise d'élément de ligne est remplacée par une liste de valeurs, une par ligne. Portant examine l'emplacement des balises d'élément de ligne et se comporte comme suit :

  • Si les balises se trouvent à l'intérieur d'une ligne de tableau, Portant clone cette ligne, une fois par élément.
  • Si les balises se trouvent en dehors d'un tableau, Portant regroupe les valeurs en un seul bloc de texte.

La règle est donc simple : pour répéter des lignes, placez les balises à l'intérieur d'une ligne unique d'un tableau.

Configurer une ligne répétée

  1. Insérez un tableau dans votre modèle avec le nombre de colonnes nécessaire.

  2. Ajoutez éventuellement une ligne d'en-tête en haut avec les titres des colonnes (cette ligne reste identique dans le résultat).

  3. Ajoutez une ligne de balises d'élément de ligne. Par exemple :

    | {{Item Name}} | {{Quantity}} | {{Unit Price}} | {{Line Total}} |
    
  4. Ajoutez éventuellement une ligne de totaux en dessous en utilisant une formule de balise, par exemple {{=SUM(Line Total)}} dans la colonne de droite.

Lorsque le workflow s'exécute, la ligne de balises est remplacée par une ligne par élément de ligne. La ligne d'en-tête et la ligne de totaux restent à leur place. Tout ce qui se trouve au-dessus ou en dessous du tableau n'est pas modifié.

Contenu de la ligne

Placez dans la ligne répétée uniquement les balises appartenant à l'élément de ligne lui-même. Les champs tels que le nom du client, l'adresse ou le numéro de devis sont des champs au niveau du document et doivent être placés en dehors du tableau.

Si vous mélangez les deux, Portant répètera le nom du client sur chaque ligne, ce qui n'est généralement pas le résultat souhaité.

Recettes par source

Le mécanisme est identique partout, mais la façon dont la source fournit les éléments de ligne diffère :

Erreurs fréquentes

  • Les balises doivent se trouver dans une seule ligne. Si vous répartissez les balises d'éléments de ligne sur deux lignes, Portant ne reconnaîtra pas le modèle répété.
  • Les lignes d'en-tête et de pied de page peuvent être stylisées indépendamment et ne seront pas clonées.
  • Les formules telles que SUM et AVG ne fonctionnent qu'avec des champs faisant partie de l'ensemble d'éléments de ligne. Consultez formules de balises.

Ressources associées