Passer au contenu principal

đŸ·ïž Les balises pour les champs tableaux

Tu veux exporter les donnĂ©es saisies dans tes champs tableaux ? Kraaft propose des balises spĂ©cifiques pour rĂ©cupĂ©rer automatiquement toutes les entrĂ©es dans tes modĂšles d'export Word et Excel 🎉

👀 Hop hop hop : si tu n'as jamais entendu parler de balises ou de champ tableau, lis d'abord ces articles avant de continuer đŸ’Ș


âźïž Petit rappel sur les balises !

Retrouve toutes tes balises directement dans l'onglet de crĂ©ation et modification des rapports, sur ton ordinateur. Chaque champ a sa propre clĂ© de balise — et le champ tableau aussi ! Les sous-champs Ă  l'intĂ©rieur du tableau ont Ă©galement leurs propres clĂ©s, gĂ©nĂ©rĂ©es automatiquement en fonction du nom que tu leur as donnĂ©.

💡 La balise du champ tableau correspond au nom donnĂ© au champ tableau dans le modĂšle de rapport — exactement comme pour les balises classiques.


1ïžâƒŁ Exporter toutes les entrĂ©es d'un coup — ##tableau##

La façon la plus simple d'exporter ton champ tableau : utilise la balise du champ tableau. Kraaft rĂ©cupĂšre automatiquement toutes les entrĂ©es et les infos complĂ©tĂ©es, sans que tu aies besoin de faire quoi que ce soit d'autre 🙌

Balise

Signification

Rendu

Dispo sur

##tableau##

Exporte toutes les entrées du champ tableau

Tableau complet avec toutes les lignes

Word & Excel

##tableau$visible##

Affiche le tableau seulement si le champ est visible (condition Kraaft)

En fonction des conditions d'affichage du rapport

Word

##tableau$filled##

Affiche le tableau seulement si au moins une entrée a été saisie

Tableau complet avec toutes les lignes

Word

##tableau$text##

Exporte le contenu du tableau en texte brut, sans mise en forme tableau

Toutes les valeurs saisies listées à la suite

Word & Excel

##tableau__count##

Nombre total d'entrées saisies

Chiffre précis : 3

Word & Excel

##tableau__headers##

En-tĂȘtes de colonnes

Nom du champ, Responsable, Date


Excel uniquement

💡 Les balises de conditions IF/END-IF sont compatibles avec la balise gĂ©nĂ©rale ##tableau## — tu peux donc conditionner l'affichage du tableau entier.

⚠ La balise gĂ©nĂ©rale ##tableau## rĂ©cupĂšre les valeurs texte de tes sous-champs, mais pas les photos avec leurs dĂ©tails : un sous-champ photo ne s'exporte pas comme dans un champ photo classique (pas de date, pas de localisation) via cette balise. Pour afficher une photo en dĂ©tail, cible-la avec une balise dĂ©diĂ©e (section 2ïžâƒŁ).


👀 Exemple avec un Journal de chantier

Voici à quoi ressemble le champ tableau sur le modÚle de rapport > le champ tableau avec ses entrées > et le détail de la premiÚre entrée !

📄 Dans un export Word

Chaque entrée du tableau apparaßt sous forme d'un mini-tableau :

  • La 1Ăšre colonne affiche le nom du sous-champ (ex : Responsable, Date, Signature)

  • La 2Ăšme colonne affiche la valeur saisie dans le rapport

Toutes les entrĂ©es s'exportent automatiquement, l'une aprĂšs l'autre 👌

📊 Dans un export Excel

Chaque entrĂ©e correspond Ă  une ligne, et chaque sous-champ Ă  une colonne. Tu peux mettre en forme ton modĂšle (gras, couleur de cellule
) — la mise en forme est conservĂ©e dans l'export. Si une cellule est colorĂ©e dans ton modĂšle, elle reste telle quelle : le champ tableau remplit simplement les cases et garde la mise en page que tu as dĂ©jĂ  dĂ©finie.

💡 Pour bien gĂ©rer l'insertion des lignes dans ta feuille Excel, jette un Ɠil aux exceptions Excel de l'export de rapport.

⚠ Les en-tĂȘtes de colonnes ne s'affichent pas automatiquement. Deux options :

  • Option A — Ajouter les noms des colonnes manuellement dans ton modĂšle (avec ta propre mise en forme)

  • Option B — Utiliser la balise ##tableau__headers## au-dessus de la balise du tableau → les en-tĂȘtes se mettent automatiquement Ă  jour si tu renommes un champ dans Kraaft 💡

Option

ModĂšle d'export

Résultat à l'export

A

B

⚠ Les lignes s'insĂšrent en Ă©crasant le contenu en dessous. Pour Ă©viter tout problĂšme, deux options recommandĂ©es :

  • Placer le tableau en fin de feuille, sans donnĂ©es en dessous

  • L'insĂ©rer dans une feuille dĂ©diĂ©e dans ton fichier Excel


đŸŽ›ïž Choisir la mise en page de ton tableau Kraaft

Par dĂ©faut, chaque entrĂ©e de ton champ tableau s'affiche Ă  la verticale, les unes sous les autres. Tu peux changer cet affichage avec deux nouvelles balises de mise en page — super pratique quand ton tableau a beaucoup de colonnes ! 🎹

Balise

Ce que ça apporte

Dispo sur

##tableau$horizontal##

Bascule le tableau à l'horizontale : chaque entrée devient une ligne et chaque sous-champ une colonne

Word & Excel

##tableau$with(moyens_humains, moyens_materiel)##

Affiche uniquement les colonnes choisies (les clés de sous-champs que tu listes)

Word & Excel

##tableau$without(sous_traitant_intervenant)##

Affiche toutes les colonnes sauf celles que tu listes

Word & Excel

↔ Afficher ton tableau Ă  l'horizontale — ##tableau$horizontal##

Ajoute le suffixe $horizontal à la balise de ton tableau pour un rendu en lignes et colonnes classiques. Sur Word, ça te donne directement un vrai tableau, bien plus lisible que la version verticale par défaut !

⚠ Attention avec beaucoup de sous-champs : sur Word, le tableau peut dĂ©passer de la feuille. Trois rĂ©flexes utiles :

  • Passer ton modĂšle Word en format paysage pour Ă©largir le tableau

  • RĂ©duire les colonnes affichĂ©es pour allĂ©ger le tableau : $with pour n'en garder que certaines, $without pour en enlever certaines (juste en dessous)

  • Faire un export test pour vĂ©rifier le rendu avant de gĂ©nĂ©raliser

💡 Dans tous les cas, il y a une limite au-delà d'un certain nombre de sous-champs 😉

🎯 SĂ©lectionner les colonnes Ă  afficher — ##tableau$with## / ##tableau$without##

Pour garder un tableau clair mĂȘme avec beaucoup de sous-champs, tu choisis les colonnes Ă  afficher grĂące Ă  leur clĂ© de sous-champ (par exemple moyens_humains, moyens_materiel, sous_traitant_intervenant).

  • ##tableau$with(moyens_humains, moyens_materiel)## → affiche seulement les colonnes moyens_humains et moyens_materiel

  • ##tableau$without(sous_traitant_intervenant)## → affiche toutes les colonnes sauf sous_traitant_intervenant

💡 Tu peux combiner les deux balises : ##tableau$horizontal$with(moyens_humains, moyens_materiel)## affiche un tableau horizontal avec uniquement les colonnes moyens_humains et moyens_materiel 🙌

⚠ Le rĂ©ordonnancement des colonnes n'est pas encore possible Ă  l'export : les colonnes gardent leur ordre d'origine. Une amĂ©lioration est prĂ©vue đŸ› ïž


2ïžâƒŁ Cibler une entrĂ©e ou un sous-champ prĂ©cis

Tu veux placer les données à un endroit spécifique dans ton modÚle, ou récupérer uniquement certaines infos ? Utilise les balises avancées.

Le principe du champ tableau : ton champ tableau contient des sous-champs (ex : Nom, Date, Signature
). Ces sous-champs sont prĂ©sents dans chaque entrĂ©e — c'est-Ă -dire chaque nouvelle ligne ajoutĂ©e dans le tableau. Lors de l'export, tu peux donc :

  • Viser une entrĂ©e entiĂšre (ex : toutes les infos de la 1Ăšre ligne ajoutĂ©e) → ##tableau__1##

  • Viser un sous-champ prĂ©cis d'une entrĂ©e prĂ©cise (ex : uniquement la signature de la 2Ăšme ligne) → ##tableau__2__signature##

Le numéro suit l'ordre de création des entrées dans Kraaft.

Balise

Signification

Rendu

##tableau__1##

Toutes les données de la 1Úre entrée (tous ses sous-champs)

Word : Mini-tableau de l'entrée 1

Excel : une ligne qui reprend les infos de l'entrée 1

##tableau__2##

Toutes les données de la 2Úme entrée

Word : Mini-tableau de l'entrée 2
Excel : une ligne qui reprend les infos de l'entrée 2

##tableau__1__clé_sous_champ##

Valeur d'un sous-champ précis dans la 1Úre entrée

Word et Excel : Info saisie sur le sous-champ


🔗 Pour aller plus loin

Besoin d'aide ? Contacte-nous via le chat 💬

Avez-vous trouvé la réponse à votre question ?