Listes dynamiques | Documentation

Les listes dynamiques vous permettent de répéter un bloc de contenu dans votre document : lignes de facture, liste de participants, compétences, matériaux... Le nombre de lignes est défini lors de la génération.

Comment ça fonctionne

Dans votre modèle Word, vous encadrez le bloc à répéter avec la même syntaxe que les sections conditionnelles. DocXgen détecte automatiquement qu'il s'agit d'une liste dynamique quand le bloc contient des sous-champs.

Dans le modèle Word

Placez vos champs entre les balises d'ouverture et de fermeture :

{#lignes}
Désignation : {designation} — Quantité : {quantite} — Prix : {prix_unitaire}€
{/lignes}

DocXgen va répéter tout le contenu entre {#lignes} et {/lignes} autant de fois qu'il y a de lignes saisies dans le formulaire.

Dans le formulaire

Lors de la génération, un tableau dynamique apparaît avec un bouton « Ajouter une ligne ». Chaque ligne contient les sous-champs détectés dans votre modèle.

Cas d'usage courants

Lignes de facture ou devis

Dans un tableau Word :

{#lignes}
{designation}    {quantite}    {prix_unitaire}€    {total}€
{/lignes}

Le formulaire proposera d'ajouter autant de lignes que nécessaire, chacune avec les champs désignation, quantité, prix unitaire et total.

Liste de participants

{#participants}
- {nom_participant}, {fonction} ({email_participant})
{/participants}

Compétences ou qualifications

{#competences}
• {nom_competence} — Niveau : {niveau}
{/competences}

Articles de contrat

{#articles}
Article {numero_article} — {titre_article}
{contenu_article}
{/articles}

Le format dépend de votre Word

La mise en forme est définie dans votre modèle Word. Si le bloc est dans un tableau Word, les lignes seront répétées dans le tableau. Si c'est une liste à puces, chaque ligne sera une puce. DocXgen conserve toute la mise en forme.

Configurer dans le formulaire

Préparez votre modèle Word

Placez les balises {#nom_liste} et {/nom_liste} autour du bloc à répéter, avec les sous-champs à l'intérieur.

Importez et auto-générez

Importez votre modèle puis cliquez sur « Auto-générer le formulaire ». DocXgen détecte automatiquement la liste dynamique et ses sous-champs.

Configurez les sous-champs

Dans le constructeur de formulaire, ouvrez le champ liste dynamique pour configurer le label et le type de chaque sous-champ (texte, nombre, montant, date...).

Générez le document

Lors de la génération, ajoutez autant de lignes que nécessaire dans le formulaire. Le document final contiendra toutes les lignes saisies.

Importer depuis un fichier

Pour les listes avec beaucoup de lignes (factures, participants, inventaires...), vous pouvez importer les données depuis un fichier CSV ou Excel au lieu de les saisir manuellement.

Boutons disponibles

Chaque liste dynamique affiche trois boutons dans le formulaire de génération :

Bouton	Action
Ajouter une ligne	Ajoute une ligne vide à remplir manuellement
Modèle CSV	Télécharge un fichier CSV avec les bons en-têtes de colonnes
Importer	Importe un fichier `.csv`, `.xlsx` ou `.xls` pour remplir les lignes en masse

L'import ajoute, il ne remplace pas

Les lignes importées s'ajoutent aux lignes déjà présentes dans le formulaire. Si vous avez déjà 3 lignes et que vous importez un fichier de 10 lignes, vous aurez 13 lignes au total.

Étapes pour importer

Téléchargez le modèle CSV

Cliquez sur « Modèle CSV » pour obtenir un fichier avec les en-têtes correspondant aux sous-champs de votre liste. Ouvrez-le dans Excel ou Google Sheets.

Remplissez vos données

Complétez les lignes dans votre tableur. Chaque ligne deviendra une entrée dans la liste dynamique. Gardez les en-têtes de colonnes intacts.

Importez le fichier

Cliquez sur « Importer » et sélectionnez votre fichier (.csv, .xlsx ou .xls). Les lignes sont ajoutées instantanément au formulaire avec un message de confirmation.

Correspondance des colonnes

L'import fait correspondre les colonnes de votre fichier aux sous-champs de la liste de manière flexible :

Insensible à la casse : Nom, NOM, nom correspondent tous au champ nom
Insensible aux accents : Désignation correspond à designation
Espaces et underscores interchangeables : prix unitaire correspond à prix_unitaire

Les colonnes qui ne correspondent à aucun sous-champ sont simplement ignorées.

Formats acceptés

L'import accepte les fichiers .csv (séparateur virgule ou point-virgule), .xlsx (Excel moderne) et .xls (Excel classique). Pour les CSV, l'encodage UTF-8 est recommandé.

Différence avec les sections conditionnelles

	Section conditionnelle	Liste dynamique
Usage	Afficher ou masquer un bloc	Répéter un bloc N fois
Syntaxe Word	`{#nom}...{/nom}`	`{#nom}...{/nom}`
Sous-champs	Non	Oui
Dans le formulaire	Toggle on/off	Tableau avec ajout de lignes
Détection	Automatique (pas de sous-champs)	Automatique (sous-champs détectés)

Détection automatique

DocXgen fait la distinction automatiquement : si le bloc contient des sous-champs, c'est une liste dynamique. Sinon, c'est une section conditionnelle (toggle).

Combien de lignes maximum puis-je ajouter ?

Il n'y a pas de limite technique. Vous pouvez ajouter autant de lignes que nécessaire. Le document Word s'adapte automatiquement.

Puis-je utiliser une liste dynamique dans un tableau Word ?

Oui ! Placez les balises d'ouverture et de fermeture dans les lignes du tableau. Chaque entrée créera une nouvelle ligne dans le tableau Word.

Les sous-champs peuvent-ils être de types différents ?

Oui, chaque sous-champ peut avoir son propre type : texte, nombre, montant, date, email... Configurez-les dans le constructeur de formulaire.

Quelle est la différence avec une section conditionnelle ?

La syntaxe dans le Word est la même. DocXgen détecte automatiquement si c'est une liste dynamique (il y a des sous-champs à l'intérieur) ou une section conditionnelle (pas de sous-champs).

Puis-je importer des données depuis Excel ou Google Sheets ?

Oui ! Cliquez sur « Modèle CSV » pour télécharger un fichier avec les bons en-têtes, remplissez-le dans Excel ou Google Sheets, puis utilisez « Importer » pour charger le fichier (.csv, .xlsx ou .xls).

Que se passe-t-il si mon fichier CSV a des colonnes en trop ?

Les colonnes qui ne correspondent à aucun sous-champ de la liste sont ignorées. Seules les colonnes reconnues sont importées. Un message vous indique le nombre de colonnes trouvées.

Créez des documents avec listes dynamiques

Factures, devis, contrats — automatisez les documents avec un nombre variable de lignes.

Commencer