Dokumentvariablen und Datenquellen
Wie Variablen, smarte Tabellen, Formate und Regeln für leere Werte ein Smart Document mit Studierenden-, Studiengang-, Kohorten-, Zeiterfassungs- und Institutionsdaten füllen.
Dokumentvariablen sind Platzhalter, die Sie im TipTap-Editor mit Einfügen → Variable (oder durch Tippen von @ oder /) einfügen. Beim Erzeugen des Dokuments ersetzt Fuxam jede Variable durch echte Daten des Benutzers, Moduls, Curriculums, Raums oder Zertifikats.
Warum das wichtig ist
Variablen halten eine Vorlage für alle gültig. Sind die Daten dahinter vollständig und korrekt, brauchen erzeugte Dokumente keine Handarbeit. Sind sie es nicht, entstehen Lücken in Schreiben und Verträgen.
Bevor Sie beginnen
| Voraussetzung | Detail |
|---|---|
| Funktion und Berechtigung | Smart Documents (Paket FuxamCMS) und read-write:settings-service-contracts. |
| Gepflegte Daten | Die Felder, die Sie nutzen möchten, sind in Benutzerprofilen oder Datensätzen ausgefüllt. |
| Eigene Spalten | Legen Sie eigene Spalten an, bevor Sie sie als Variablen nutzen. |
| Testbenutzer | Ein Benutzer oder eine Modulversion für die Vorschau. |
Was Variablen anzeigen können
Variablen sind nach der Herkunft ihrer Daten gruppiert. Welche Gruppen Sie sehen, hängt vom Objekttyp ab.
| Quelle | Beispiele |
|---|---|
| Zugewiesener Studierender | Name, Kontaktdaten und die eigenen Spalten Ihrer Institution |
| Institution | Name und Angaben der Institution |
| Studiengang | Studiengang- und Kohortendaten (Studiengänge und Kohorten) |
| Zulassung | Bewerbungsdaten |
| Studiengebühren | Gebühren- und Entgeltdaten |
| Unterschrift | Unterschriftsblöcke |
| Zeiterfassung | Werte für einen Zeiterfassungszeitraum (Zeiterfassung) |
| Modul, Curriculum, Raum | Felder des gewählten Datensatzes für diese Objekttypen |
| Zertifikat | Daten zum Kursabschluss bei Zertifikatvorlagen |
| Rechtliches Prüfungsdokument | Daten zu rechtlichen Prüfungsdokumenten |
Format und leere Werte
Wählen Sie eine Variable im Text aus, um die Variableneinstellungen zu öffnen.
- Format: Text, GROSSBUCHSTABEN oder eines von mehreren Datums- und Datum-Uhrzeit-Formaten.
- Wenn leer: Wert Ausblenden, einen Strich (—) zeigen oder einen selbst geschriebenen Fallback-Text zeigen.
- Formatierung: Wert in Fettschrift anzeigen, wenn Daten vorhanden sind.
Smarte Tabellen
Einfügen → Smarte Tabelle füllt eine Tabelle automatisch aus einer Datenquelle und passt sich beim Erzeugen an jeden Benutzer an. Datenquellen sind Studienplan, Benutzerkurse, Terminübersicht, Arbeitsaufwand und Zeiterfassung. Modul-Vorlagen bieten Übergeordnetes Modul und Untermodule. Passt keine Quelle zum Dokumenttyp, meldet das der Dialog.
Das Speichern ist blockiert, solange eine Smart-Table-Datenquelle korrigiert werden muss.
Zeiterfassungszeiträume
Vorlagen mit Zeiterfassungsvariablen brauchen einen Zeitraum. Legen Sie ihn über Zeiterfassungseinstellungen im ⋯-Menü der Vorlage fest. Beim Hinzufügen des Dokuments wählt die Person den Zeitraum, falls er nötig ist.
So prüfen Sie Ihre Daten
Öffnen Sie die Vorlage im Editor und wählen Sie unter Als Nutzer: einen Benutzer.
Schalten Sie Beispieldaten anzeigen ein und lesen Sie jede Variable.
Beheben Sie bei leeren Werten die Profildaten oder setzen Sie Wenn leer an der Variable.
Wiederholen Sie die Prüfung mit einem zweiten Benutzer, dessen Daten unvollständig sind.
Best Practices
- Setzen Sie „Wenn leer“ bei jeder optionalen Variable.
- Nutzen Sie eigene Spalten für institutionsspezifische Daten und benennen Sie sie klar.
- Halten Sie Datumsformate in Ihren Dokumenten einheitlich.
- Prüfen Sie mit mehreren Benutzern, auch mit einem mit Lücken.
- Nehmen Sie nur Daten auf, die die lesende Person sehen darf. Siehe Datenschutz in Smart Documents.
Häufige Fallstricke
| Fallstrick | So vermeiden Sie ihn |
|---|---|
| Leerer Wert in der Ausgabe | Füllen Sie das Profilfeld oder setzen Sie Wenn leer. |
| Variable fehlt in der Liste | Prüfen Sie den Objekttyp der Vorlage. |
| Falsches Datumsformat | Stellen Sie das Format in den Variableneinstellungen ein. |
| Smarte Tabelle blockiert das Speichern | Wählen Sie eine gültige Datenquelle für die Tabelle. |
| Zeiterfassungswerte leer | Wählen Sie den Zeitraum unter Zeiterfassungseinstellungen oder beim Hinzufügen des Dokuments. |
FAQ
Kann ich meine eigenen Spalten nutzen?
Ja. Eigene Spalten aus der Benutzerverwaltung erscheinen bei Benutzer-Vorlagen als Variablen.
Was ist der Unterschied zwischen Variable und Formularfeld?
Eine Variable wird automatisch aus Daten gefüllt. Ein Formularfeld ist eine Eingabe, in die jemand beim Vervollständigen des Dokuments tippt.
Warum sieht die Variablenliste je Vorlage anders aus?
Die Liste hängt vom Objekttyp der jeweiligen Vorlage ab.
Kann ein Formularfeld schon einen Wert enthalten?
Ja. Nutzen Sie Aus Variable vorausfüllen am Formularfeld. Es wird beim Öffnen des Dokuments befüllt, wenn der Entwurf der Person leer ist.