Zum Inhalt springen
Esc
↑↓navigieren↵öffnen⌘Jvorschau
Auf dieser Seite

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.

Verwandte Seiten

Zuletzt aktualisiert am

War diese Seite hilfreich?