🔃Les boucles dans l’action Créer une document

Les boucles dans l’action Créer un document permettent d'afficher des enregistrements dans un document issus de n'importe quelle table (à l’exception de la table Utilisateurs et des tables liées aux parcours d’inscription). Cette fonctionnalité est particulièrement utile pour générer des documents tels que des devis, des factures ou des rapports contenant des éléments de données répétitifs.

Les boucles sont disponibles dans les actions suivantes :

• Remplir un Docx

• Remplir un PowerPoint

• Remplir un Excel

Pour ajouter une boucle dans vos champs à placer, cliquez sur « Ajouter une boucle ».

La boucle est automatiquement ajoutée dans la liste des champs à placer.

Vous pouvez modifier les paramètres d'une boucle à tout moment en cliquant sur l’icône ✏️.

⚙️ Paramétrage d’une boucle

1️⃣ Définissez le libellé de la boucle. Le libellé doit être unique entre les boucles situées au même niveau d’imbrication, sinon la génération du document échouera.

2️⃣ Choisissez la table sur laquelle vous souhaitez itérer. C’est dans cette table que seront récupérés les enregistrements à afficher dans le document.

3️⃣ Ajoutez des conditions (facultatif) Cela vous permet de filtrer les enregistrements qui seront affichés.

4️⃣ Configurez le tri (facultatif) Vous pouvez organiser l’ordre d’apparition des enregistrements dans le document :

• Choisissez le type de tri : Alphabétique, Numérique ou Chronologique

• Définissez l’ordre de tri : Croissant ou Décroissant

• Sélectionnez enfin le champ de la table sur lequel s’appliquera le tri.

5️⃣ Sélectionnez les champs de la table que vous souhaitez insérer dans le document.

➕ Ajouter une boucle imbriquée

Les boucles imbriquées permettent de répéter des données liées à un enregistrement principal.

Par exemple, si vous listez les commandes d’un client, vous pouvez imbriquer une boucle pour afficher les produits de chaque commande.

Cela permet de structurer dynamiquement un document en respectant les liens entre vos tables. Pour cela :

6️⃣ Cliquez sur « Ajouter une boucle » dans une boucle existante pour créer une boucle imbriquée.

7️⃣ Saisissez un libellé unique

8️⃣ Sélectionnez une table liée à la boucle parente

9️⃣ Choisissez un champ de liaison. Ce champ permet de relier automatiquement les enregistrements entre la boucle parent et la boucle fille. Seuls les éléments liés à l’enregistrement parent seront affichés.

Le reste du paramétrage (conditions, tri, champs à afficher…) se fait exactement comme la boucle parente.

Vous pouvez ajouter autant de boucles imbriquées que nécessaire. Les boucles dans les documents ne sont soumises à aucune limite d’itérations.

📄 Intégrer une boucle dans votre document

Après avoir ajouté tous vos champs à placer, cliquez sur Étape suivante : un schéma de variable est généré automatiquement.

1️⃣ Copiez ce schéma et collez-le dans votre document à l’endroit où vous souhaitez faire apparaître les enregistrement.

2️⃣ Vous pouvez déplacer librement toutes les variables dans votre document pour adapter la mise en page à vos besoins.

⚠️ Veillez cependant à conserver l’ordre logique des variables, afin d’assurer un rendu correct à la génération. Les champs à placer dans une boucle doivent être positionnés après la balise de début de boucle ({# Boucle}) et avant la balise de fin ({/}).

🚧 Exemple : Historique des commandes d’un client

L’objectif est de générer un fichier .docx contenant toutes les commandes associées à un client donné, avec le détail des produits commandés.

Dans cet exemple, nous utilisons 4 tables organisées comme suit :

📁 Table Client

Contient les informations de base sur chaque client :

• Nom client (champ texte)

• Prénom client (champ texte)

📁 Table Produit

Répertorie les produits disponibles à la commande :

• Référence produit (champ texte)

• Prix produit (champ nombre)

📁 Table Commande

Représente les commandes effectuées par un client :

• Numéro commande (champ nombre ou compteur)

• Liaison client (champ liaison simple vers la table Client)

📁 Table Panier : matrice de la table commande

Détaille le contenu d’une commande :

• Liaison commande (champ liaison simple vers la table Commande)

• Liaison produit (champ liaison simple vers la table Produit)

• Quantité (champ nombre)

• Total ligne commande (champ calculé : Prix produit × Quantité)

⚙️ Paramétrer l'action « Créer un document »

1️⃣ Dans un suivi de la table Client, ajoutez une action → Créer un document, puis sélectionnez Créer un docx.

2️⃣ Ajoutez les champs à placer issus de la table client :

• Nom client

• Prénom client

3️⃣ Cliquez sur Ajouter une boucle.

• Donnez-lui le libellé Boucle Commande.

• Sélectionnez la table Commande.

• Ajoutez un filtre sur la liaison client pour ne récupérer que les commandes liées au client en cours.

• Triez vos enregistrements par date croissante du champ Créé le, pour que vos commandes s’affichent par ordre chronologique.

  
• Ajoutez les champs à placer suivants :

  • Numéro commande

  • Créer le

  • Total commande

4️⃣ Dans la boucle Commande, cliquez sur Ajouter une boucle pour créer une boucle imbriquée.

• Donnez-lui le libellé Boucle Panier.

• Sélectionnez la table Panier.

• Choisissez le champ de liaison Liaison Commande (pour filtrer les enregistrées liées à la commande parente)

  
• Ajoutez les champs à placer dans cette boucle imbriquée :

  • Quantité

  • Total ligne commande

  • Référence produit via la liaison Produit

  • Prix produit via la liaison Produit

  

5️⃣ Fermez les popups et cliquez sur Étape suivante. Un schéma de variables est alors généré automatiquement.

⬇️ Voici comment intégrer vos boucles dans le document .docx :

7KB

Historique commandes.docx

6️⃣ Vous pouvez ensuite ajouter un tableau de source client dans votre espace personnel en y ajoutant les champs suivants : Prénom client , Nom client ainsi que le suivi de la table Client contenant l'action Créer un document.

7️⃣ Vos utilisateurs peuvent ainsi consulter l'historique des commandes d’un client en téléchargeant le fichier associé.

Aperçu du fichier généré côté utilisateur