Tu utilises des listes référence dans tes rapports Kraaft et tu veux récupérer ces données dans tes exports Word et Excel 📝 ? Voici toutes les balises dont tu as besoin !

⚠️ Si tu n'as jamais entendu parler de balises, lis d'abord 🎨 Les balises des rapports avant de continuer 💪

🧭 3 types de balises à ne pas confondre

Une liste référence dans un rapport, ça donne accès à 3 balises différentes à l'export — chacune avec un usage bien précis :

La balise du champ Liste référence (ex : ##collaborateur##) → exporte un tableau avec toutes les infos de chaque élément sélectionné 📋
Une balise ciblée sur un sous-élément précis (ex : ##collaborateur__1__nom##) → au lieu du tableau complet, elle cible un seul sous-élément de ta liste (ici nom) sur l'élément choisi, et l'affiche en texte brut, sans tableau — utile en choix unique 📝 La clé du sous-élément (ici nom) vient de la structure de ta liste référence, à retrouver dans l'onglet Liste
La balise d'un champ Donnée liée d'une liste (ex : ##metier##) → avantage clé : ce champ s'affiche aussi directement dans le rapport rempli 👀 Il te donne en plus sa propre balise dédiée à l'export, en texte brut, qui fonctionne aussi en choix multiple (avec numérotation) 🎯

La suite de l'article détaille chacune de ces 3 balises.

🏷️ Balise d'un champ Liste référence

Utilise la clé de ton champ Liste référence pour exporter automatiquement, sous forme de tableau, les éléments sélectionnés :

📌 Exemple : ton rapport de pointage utilise un champ Liste référence de clé collaborateur (générée automatiquement dans ton rapport), connecté à ta liste référence des collaborateurs 👷 Des clés comme nom ou metier, elles, viennent de la structure de ta liste référence — à récupérer dans la configuration de ta liste (onglet Liste) 🗂️

Balise	Effet
`##collaborateur##`	Un mini-tableau par élément sélectionné, avec toutes ses infos associées (mail, coordonnées, numéro de référence...) 📋 Si plusieurs éléments sont sélectionnés, tu obtiens un mini-tableau par élément, affichés à la suite dans l'ordre de ta liste référence
`##collaborateur$horizontal##`	Affichage à l'horizontale (une ligne par élément) ⚠️ Si ta liste contient beaucoup de sous-éléments de liste, ça fait beaucoup de colonnes à l'export : le tableau peut être coupé ou déborder de la page
`##collaborateur$with(nom, metier)##`	Affiche uniquement les colonnes des sous-éléments listés (ici `nom` et `metier`) — pratique pour n'afficher que l'essentiel
`##collaborateur$without(coordonnees)##`	Affiche tous les sous-éléments de liste sauf ceux dont tu listes la clé (ici `coordonnees`)
`##collaborateur__headers##`	Ajoute automatiquement les en-têtes de colonnes (les noms de tes sous-éléments) — à placer juste au-dessus de `##collaborateur##` dans ton modèle Excel. Les en-têtes se mettent à jour tout seuls si tu renommes un sous-élément dans Kraaft 💡 Excel uniquement, ne fonctionne pas en Word

🔗 Ce sont presque les mêmes balises que pour un champ tableau classique — tu peux tout retrouver en détail dans 🏷️ Les balises pour les champs tableaux 🔧

🏷️ Balise d'un champ Donnée liée d'une liste

Le champ Donnée liée d'une liste cible un seul sous-élément précis de ta liste référence (par exemple uniquement le métier, uniquement les coordonnées, ou uniquement le nom/prénom) 🎯 Utilise simplement sa clé pour l'exporter n'importe où dans ton modèle, pas uniquement à l'endroit du champ Liste référence 📍

Le résultat à l'export dépend du mode de sélection de ton champ Liste référence source :

🔢 Choix multiple — chaque élément sélectionné est numéroté (1, 2, 3...), dans l'ordre de ta liste référence. Par exemple, si tu as sélectionné 4 collaborateurs, tu obtiens leurs 4 métiers numérotés de 1 à 4, pour bien savoir à qui correspond quoi
1️⃣ Choix unique — aucune numérotation : la donnée s'affiche brute, puisqu'un seul élément est sélectionné (par exemple le nom/prénom du collaborateur choisi)

💡 🔑 À savoir : 2 niveaux de clés à ne pas confondre

Le champ dans le rapport (ex. collaborateur) — à droite du champ, dans l'éditeur de modèle de rapport
Le sous-élément dans la liste (ex. nom, metier, coordonnees) — Rapports → Listes référence → ta liste → onglet Liste

⚠️ $with() et $without() prennent uniquement des clés du 2ᵉ niveau (les sous-éléments de ta liste), jamais des clés de champs du rapport. Utiliser une clé de champ rapport dans un $with()/$without() ne fonctionnera pas.

📝 Texte brut : afficher une seule info sans tableau

C'est le besoin le plus fréquent : pas de tableau, juste une info précise, affichée simplement dans ton export.

En choix unique — combine 2 clés dans une seule balise :

la clé de ton champ Liste référence dans le rapport (1ᵉʳ niveau)
la clé du sous-élément dans ta liste référence (2ᵉ niveau)

##collaborateur__1__nom## → affiche uniquement le nom du collaborateur sélectionné, en texte brut, sans tableau ✅

💡 Ça marche aussi avec le champ titre de ta liste (celui qui s'affiche dans le menu déroulant) : il a lui aussi sa propre clé, à récupérer dans l'onglet Liste, au même endroit que les autres sous-champs. Dans notre exemple, c'est justement le cas de nom : ##collaborateur__1__nom## (utilisé ci-dessus) affiche donc directement le titre de l'élément sélectionné.

En choix multiple — il n'existe pas d'équivalent avec __1__ (qui ne cible qu'un seul élément). Pour du texte brut avec plusieurs éléments sélectionnés, ajoute plutôt un champ Donnée liée d'une liste : lui seul garantit du texte brut (avec numérotation 1, 2, 3... si plusieurs éléments), et tu peux le placer n'importe où dans ton modèle, pas uniquement à l'endroit du champ Liste référence 📍

🧩 Cas combiné : liste référence dans un champ tableau

Prenons l'exemple d'un rapport de chantier qui indique la présence sur chantier du jour 👷 Le champ tableau presences accueille une entrée par personne présente, avec un sous-champ Liste référence de clé collaborateur pour sélectionner qui est là (et, si besoin, un sous-champ Donnée liée d'une liste pour afficher une info associée).

Balise	Effet
`##presences##`	Un mini-tableau par entrée, qui fusionne à la suite tous les sous-champs du champ tableau : un champ date classique, le ou les élément(s) sélectionné(s) (le titre) de ton sous-champ Liste référence, la donnée liée associée si tu en as ajouté une, et les autres sous-champs du tableau
`##presences$horizontal##`	Même principe, à l'horizontale (une ligne par entrée)

💡 Même règle que pour un champ Donnée liée classique : si ton sous-champ Liste référence est en choix multiple, les éléments sélectionnés (et leur donnée liée associée) apparaissent numérotés (1, 2, 3...) dans l'ordre de la liste. En choix unique, un seul résultat s'affiche, sans numérotation.

⚠️ 📄 Word vs Excel : 2 différences à connaître

En Word, ne place jamais une balise qui génère un tableau (##collaborateur##, ##collaborateur$horizontal##, ##collaborateur$with(...)##, ##collaborateur$without(...)##) à l'intérieur d'une cellule de tableau de ton modèle 📝 Elle crée un mini-tableau par élément → ça fait un tableau dans un tableau, et l'export échoue avec « Une erreur serveur est survenue ». Garde ces balises en texte simple, en dehors de tes tableaux de mise en forme.
✅ Besoin de garder ta mise en page en tableau ? Utilise ##collaborateur__1__nom## ou un champ Donnée liée : elles sortent en texte brut et passent sans aucun souci dans une cellule.
La balise ##collaborateur__headers## (en-têtes de colonnes) ne fonctionne qu'à l'export Excel, pas en Word 📊

🔗 Pour aller plus loin

🏷️ Les balises pour les champs tableaux — toutes les balises pour exporter tes champs tableaux
🔗 Utiliser une liste référence dans un rapport — connecter ta liste référence à un modèle de rapport

💬 Besoin d'aide ?

Si tu as des questions Contacte nous !

📤 Les balises d'export des champs liste référence