---
title: Dokumentvariablen und Datenquellen
description: >-
  Wie Variablen, smarte Tabellen, Formate und Regeln für leere Werte ein Smart
  Document mit Studierenden-, Studiengang-, Kohorten-, Zeiterfassungs- und
  Institutionsdaten füllen.
sidebar:
  order: 4
  label: Dokumentvariablen
---

**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.

:::tip
Wählen Sie unter **Als Nutzer:** einen Benutzer und schalten Sie in der Werkzeugleiste **Beispieldaten anzeigen** ein. Die Variablen zeigen dann beim Schreiben echte Werte.
:::

## 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](/docs/de/fuxam-web/base/user-management/custom-columns) 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](/docs/de/fuxam-web/cms/programs-and-planning/study-programs-cohorts)) |
| **Zulassung** | Bewerbungsdaten |
| **Studiengebühren** | Gebühren- und Entgeltdaten |
| **Unterschrift** | Unterschriftsblöcke |
| **Zeiterfassung** | Werte für einen Zeiterfassungszeitraum ([Zeiterfassung](/docs/de/fuxam-web/cms/time-tracking)) |
| **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

1. Öffnen Sie die Vorlage im Editor und wählen Sie unter **Als Nutzer:** einen Benutzer.

2. Schalten Sie **Beispieldaten anzeigen** ein und lesen Sie jede Variable.

3. Beheben Sie bei leeren Werten die Profildaten oder setzen Sie **Wenn leer** an der Variable.

4. 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](/docs/de/fuxam-web/cms/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](/docs/de/fuxam-web/base/user-management/custom-columns) 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

**[Ein Dokument bearbeiten](/docs/de/fuxam-web/cms/smart-documents/edit-a-document)**

Variablen im Editor einfügen.

**[Eigene Spalten](/docs/de/fuxam-web/base/user-management/custom-columns)**

Eigene Datenfelder hinzufügen.

**[Zeiterfassung](/docs/de/fuxam-web/cms/time-tracking)**

Woher Zeiterfassungsdaten stammen.

**[Eine Dokumentvorlage verwenden](/docs/de/fuxam-web/cms/smart-documents/use-a-document-template)**

Dokumente erzeugen.
