Du nutzt Referenzlisten in deinen Kraaft-Berichten und willst diese Daten in deinen Word- und Excel-Exporten abrufen 📝? Hier sind alle Tags, die du brauchst!

⚠️ Noch nie von Tags gehört? Lies zuerst 🎨 Berichts-Tags, bevor du weitermachst 💪

🏷️ Tag für ein Referenzlisten-Feld

Nutze den Schlüssel deines Felds Referenzliste, um die ausgewählten Elemente automatisch als Tabelle zu exportieren:

📌 Beispiel: Dein Anwesenheitsbericht nutzt ein Referenzlisten-Feld mit dem Schlüssel collaborateur (automatisch in deinem Bericht generiert), verknüpft mit deiner Mitarbeiter-Referenzliste 👷 Schlüssel wie nom oder metier stammen aus der Struktur deiner Referenzliste — zu finden in der Konfiguration deiner Liste (Tab Liste) 🗂️

Tag	Effekt
`##collaborateur##`	Eine Mini-Tabelle pro ausgewähltem Element, mit allen zugehörigen Infos (E-Mail, Kontaktdaten, Referenznummer...) 📋 Sind mehrere Elemente ausgewählt, erhältst du eine Mini-Tabelle pro Element, nacheinander in der Reihenfolge deiner Referenzliste
`##collaborateur$horizontal##`	Horizontale Anzeige (eine Zeile pro Element) ⚠️ Hat deine Liste viele Unterelemente, ergibt das viele Spalten beim Export: Die Tabelle kann abgeschnitten werden oder über die Seite hinausgehen
`##collaborateur$with(nom, metier)##`	Zeigt nur die Spalten der aufgelisteten Elemente, unter Angabe ihres Schlüssels (hier `nom` und `metier`) — praktisch, um nur das Wesentliche anzuzeigen
`##collaborateur$without(coordonnees)##`	Zeigt alle Unterelemente außer denen, deren Schlüssel du auflistest (hier `coordonnees`)
`##collaborateur__1__nom##`	Zielt auf eine bestimmte Angabe des 1. ausgewählten Elements: dein Referenzlisten-Feld im Bericht → das 1. in deinem Bericht ausgewählte Element (der 1. Mitarbeiter) → ein in deiner Liste definiertes Unterelement (hier der Name)
`##collaborateur__headers##`	Fügt automatisch Spaltenüberschriften hinzu (die Namen deiner Unterelemente) — direkt über `##collaborateurs##` in deiner Excel-Vorlage platzieren. Die Überschriften aktualisieren sich von selbst, wenn du ein Unterelement in Kraaft umbenennst 💡 Nur Excel, funktioniert nicht in Word

💡 Die Tags $with und $without sind genau dafür da, die horizontale Anzeige zu entlasten, wenn deine Liste viele Felder hat 🎯 Nutze die Schlüssel der Unterelemente deiner Referenzliste (hier nom, metier, coordonnees), zu finden in der Konfiguration deiner Liste 🔑

💡 Tipp — eine Angabe abrufen, ohne ein Feld für verknüpfte Daten hinzuzufügen

Brauchst du nur eine bestimmte Angabe beim Export? $with() isoliert sie (z. B. ##collaborateurs$with(nom)##), aber die Ausgabe bleibt im Tabellenmodus, auch wenn sie auf eine einzige Spalte reduziert ist
Brauchst du reinen Text, ohne Tabelle? Bei Einzelauswahl reicht ##collaborateurs__1__nom##. Bei Mehrfachauswahl füge stattdessen ein Feld Verknüpfte Daten einer Liste hinzu: nur dieses garantiert reinen Text (mit Nummerierung, falls nötig)
Das Feld für verknüpfte Daten ist auch nützlich, wenn du diese Info direkt im ausgefüllten Bericht anzeigen willst 🙌

🔗 Das sind fast die gleichen Tags wie für ein normales Tabellenfeld — alle Details findest du in 🏷️ Tags für Tabellenfelder 🔧

🏷️ Tag für ein Feld „Verknüpfte Daten einer Liste“

Das Feld Verknüpfte Daten einer Liste zielt auf ein einziges, bestimmtes Unterelement deiner Referenzliste (zum Beispiel nur den Beruf, nur die Kontaktdaten oder nur den Namen) 🎯 Nutze einfach seinen Schlüssel, um es überall in deiner Vorlage zu exportieren, nicht nur an der Stelle des Referenzlisten-Felds 📍

Das Ergebnis beim Export hängt vom Auswahlmodus deines Quell-Referenzlisten-Felds ab:

🔢 Mehrfachauswahl — jedes ausgewählte Element wird nummeriert (1, 2, 3...), in der Reihenfolge deiner Referenzliste. Hast du zum Beispiel 4 Mitarbeiter ausgewählt, erhältst du ihre 4 Berufe nummeriert von 1 bis 4, damit du weißt, wer wer ist
1️⃣ Einzelauswahl — keine Nummerierung: Die Angabe wird roh angezeigt, da nur ein Element ausgewählt ist (zum Beispiel der Name des ausgewählten Mitarbeiters)

🧩 Kombinierter Fall: Referenzliste in einem Tabellenfeld

Nehmen wir das Beispiel eines Baustellenberichts, der die Anwesenheit vor Ort für den Tag angibt 👷 Das Tabellenfeld presences nimmt einen Eintrag pro anwesender Person auf, mit einem Unterelement Referenzliste mit dem Schlüssel collaborateur, um auszuwählen, wer da ist (und, falls nötig, einem Unterelement Verknüpfte Daten einer Liste, um eine zugehörige Info anzuzeigen).

Tag	Effekt
`##presences##`	Eine Mini-Tabelle pro Eintrag, die alle Unterelemente des Tabellenfelds nacheinander zusammenführt: ein normales Datumsfeld, das/die ausgewählte(n) Element(e) (der Titel) deines Referenzlisten-Unterelements, die zugehörigen verknüpften Daten, falls hinzugefügt, und die übrigen Unterelemente der Tabelle
`##presences$horizontal##`	Gleiches Prinzip, horizontal (eine Zeile pro Eintrag)

💡 Gleiche Regel wie bei einem klassischen Feld für verknüpfte Daten: Ist dein Referenzlisten-Unterelement in Mehrfachauswahl, erscheinen die ausgewählten Elemente (und ihre verknüpften Daten) nummeriert (1, 2, 3...) in der Reihenfolge der Liste. Bei Einzelauswahl erscheint nur ein Ergebnis, ohne Nummerierung.

⚠️ 📄 Word vs. Excel: 2 Dinge, die du wissen solltest

Platziere in Word niemals ein Tag für ein Referenzlisten- oder Tabellenfeld innerhalb einer Tabellenzelle deiner Vorlage: Das kann einen Export-Fehler verursachen. Lass sie als reinen Text stehen, außerhalb deiner Formatierungstabellen 📝
Das Tag ##collaborateurs__headers## (Spaltenüberschriften) funktioniert nur beim Excel-Export, nicht in Word 📊

🔗 Weiterführende Infos

🏷️ Tags für Tabellenfelder — alle Tags, um deine Tabellenfelder zu exportieren
🔗 Referenzliste in einem Bericht verwenden — deine Referenzliste mit einer Berichtsvorlage verknüpfen

💬 Brauchst du Hilfe?

Bei Fragen, Kontaktiere uns!

📤 Export von Referenzlisten-Feldern