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 💪

🧭 3 Tag-Arten, die du nicht verwechseln solltest

Eine Referenzliste in einem Bericht gibt dir Zugriff auf 3 verschiedene Export-Tags — jedes mit einem klaren Einsatzzweck:

Das Tag des Referenzlisten-Felds (z. B. ##collaborateur##) → exportiert eine Tabelle mit allen Infos zu jedem ausgewählten Element 📋
Ein Tag, das auf ein bestimmtes Unterelement zielt (z. B. ##collaborateur__1__nom##) → statt der ganzen Tabelle zielt es auf ein einziges Unterelement deiner Liste (hier nom) beim ausgewählten Element und zeigt es als reinen Text an, ohne Tabelle — nützlich bei Einzelauswahl 📝 Der Schlüssel des Unterelements (hier nom) stammt aus der Struktur deiner Referenzliste, zu finden im Tab Liste
Das Tag eines Felds Verknüpfte Daten einer Liste (z. B. ##metier##) → wichtiger Vorteil: Dieses Feld wird auch direkt im ausgefüllten Bericht angezeigt 👀 Es liefert dir zusätzlich sein eigenes Export-Tag, als reinen Text, das auch bei Mehrfachauswahl funktioniert (mit Nummerierung) 🎯

Der Rest des Artikels beschreibt jedes dieser 3 Tags im Detail.

🏷️ 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 Unterelemente (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__headers##`	Fügt automatisch Spaltenüberschriften hinzu (die Namen deiner Unterelemente) — direkt über `##collaborateur##` in deiner Excel-Vorlage platzieren. Die Überschriften aktualisieren sich von selbst, wenn du ein Unterelement in Kraaft umbenennst 💡 Nur Excel, funktioniert nicht in Word

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

💡 🔑 Gut zu wissen: 2 Ebenen von Schlüsseln, die du nicht verwechseln solltest

Das Feld im Bericht (z. B. collaborateur) — rechts neben dem Feld, im Berichtsvorlagen-Editor
Das Unterelement in der Liste (z. B. nom, metier, coordonnees) — Berichte → Referenzlisten → deine Liste → Tab Liste

⚠️ $with() und $without() nehmen ausschließlich Schlüssel der 2. Ebene (die Unterelemente deiner Liste), niemals Schlüssel von Berichtsfeldern. Einen Berichtsfeld-Schlüssel in einem $with()/$without() zu verwenden, funktioniert nicht.

📝 Reiner Text: eine einzelne Info ohne Tabelle anzeigen

Das ist das häufigste Bedürfnis: keine Tabelle, nur eine bestimmte Info, einfach in deinem Export angezeigt.

Bei Einzelauswahl — kombiniere 2 Schlüssel in einem einzigen Tag:

den Schlüssel deines Referenzlisten-Felds im Bericht (1. Ebene)
den Schlüssel des Unterelements in deiner Referenzliste (2. Ebene)

##collaborateur__1__nom## → zeigt nur den Namen des ausgewählten Mitarbeiters an, als reinen Text, ohne Tabelle ✅

💡 Das funktioniert auch mit dem Titelfeld deiner Liste (dem, das im Dropdown-Menü angezeigt wird): Es hat ebenfalls seinen eigenen Schlüssel, zu finden im Tab Liste, direkt neben den anderen Unterelementen. In unserem Beispiel ist das genau bei nom der Fall: ##collaborateur__1__nom## (oben verwendet) zeigt also direkt den Titel des ausgewählten Elements an.

Bei Mehrfachauswahl — es gibt kein Äquivalent mit __1__ (das nur auf ein einziges Element zielt). Für reinen Text bei mehreren ausgewählten Elementen füge stattdessen ein Feld Verknüpfte Daten einer Liste hinzu: Nur dieses garantiert reinen Text (mit Nummerierung 1, 2, 3..., falls mehrere Elemente vorhanden sind), und du kannst es überall in deiner Vorlage platzieren, nicht nur an der Stelle des Referenzlisten-Felds 📍

🧩 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, das eine Tabelle erzeugt (##collaborateur##, ##collaborateur$horizontal##, ##collaborateur$with(...)##, ##collaborateur$without(...)##), innerhalb einer Tabellenzelle deiner Vorlage 📝 Es erzeugt eine Mini-Tabelle pro Element → das ergibt eine Tabelle in einer Tabelle, und der Export scheitert mit „Ein Serverfehler ist aufgetreten". Lass diese Tags als reinen Text stehen, außerhalb deiner Formatierungstabellen.
✅ Willst du dein Layout als Tabelle behalten? Nutze ##collaborateur__1__nom## oder ein Feld für verknüpfte Daten: Sie geben reinen Text aus und funktionieren problemlos in einer Zelle.
Das Tag ##collaborateur__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