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 💪

🏷️ 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 éléments listés, en indiquant leur clé (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__1__nom##`	Cible une donnée précise du 1ᵉʳ élément sélectionné : ton champ Liste référence du rapport → le 1ᵉʳ élément sélectionné sur ton rapport (le 1ᵉʳ collaborateur) → un sous-champ défini dans ta liste (ici le nom)
`##collaborateur__headers##`	Ajoute automatiquement les en-têtes de colonnes (les noms de tes sous-éléments) — à placer juste au-dessus de `##collaborateurs##` 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

💡 Les balises $with et $without sont justement là pour alléger l'affichage horizontal quand ta liste a beaucoup de champs 🎯 Utilise les clés des sous-champs de ta liste référence (ici nom, metier, coordonnees), à retrouver dans la configuration de ta liste 🔑

💡 Astuce — récupérer une donnée sans ajouter de champ Donnée liée

Juste besoin d'une donnée précise à l'export ? $with() l'isole (ex : ##collaborateurs$with(nom)##), mais le rendu reste en mode tableau, même réduit à une seule colonne
Besoin de texte brut, sans tableau ? En choix unique, ##collaborateurs__1__nom## suffit. En choix multiple, ajoute plutôt un champ Donnée liée d'une liste : lui seul garantit du texte brut (avec numérotation si besoin)
Le champ Donnée liée reste utile si tu veux aussi afficher cette info directement dans le rapport rempli 🙌

🔗 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)

🧩 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 de champ Liste référence ou de champ tableau à l'intérieur d'une cellule de tableau de ton modèle : ça peut provoquer une erreur à l'export. Garde-les en texte simple, en dehors de tes tableaux de mise en forme 📝
La balise ##collaborateurs__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