---
title: Eine Dokumentvorlage verwenden
description: >-
  Einem Benutzer ein veröffentlichtes Smart Document hinzufügen, die Aktion
  Smart-Dokument für viele Benutzer nutzen oder Self-Service einrichten, damit
  berechtigte Personen Dokumente selbst erzeugen.
sidebar:
  order: 3
---

**Eine Dokumentvorlage verwenden** heißt, aus einem veröffentlichten Smart Document ein echtes Dokument für eine Person zu machen: Sie fügen es unter **Campus-Management → Benutzerverwaltung → [Benutzer] → Dokumente** hinzu, nutzen die Aktion **Smart Document** für viele Benutzer gleichzeitig oder lassen berechtigte Personen es per Self-Service selbst erzeugen.

:::tip
Öffnen Sie die Vorlage zuerst in der Vorschau mit demselben Benutzer (siehe [Ein Dokument bearbeiten](/docs/de/fuxam-web/cms/smart-documents/edit-a-document)). Sieht die Vorschau richtig aus, gilt das auch für das erzeugte Dokument.
:::

## Warum das wichtig ist

Vorlagen sparen nur Zeit, wenn sie die richtigen Personen erreichen. Wer die drei Wege (einzeln, in Masse, Self-Service) kennt, wählt für jede Aufgabe den schnellsten und vermeidet Dokumente mit leeren Feldern.

## Bevor Sie beginnen

| Voraussetzung | Detail |
|---|---|
| **Funktion** | **Smart Documents** im Paket FuxamCMS. |
| **Vorlage bereit** | Eine Vorlage mit Inhalt und, falls Personen etwas ausfüllen sollen, mindestens einem Formularfeld (siehe Spalte **Formularfelder**). |
| **Benutzerdaten** | Das Benutzerprofil enthält die Daten, die die Variablen brauchen. Siehe [Dokumentvariablen und Datenquellen](/docs/de/fuxam-web/cms/smart-documents/document-variables-and-data-sources). |
| **Standardvorlage** | Optional. Die als **Standard** markierte Vorlage ist beim Hinzufügen eines Dokuments vorausgewählt. |
| **Einstellungsberechtigung** | Nur für die Self-Service-Einrichtung: `read-write:settings-service-contracts`. |

## So fügen Sie einem Benutzer ein Dokument hinzu

1. Öffnen Sie **Campus-Management → Benutzerverwaltung** und wählen Sie den Benutzer. Öffnen Sie den Tab **Dokumente**. Siehe [Einen Benutzer anzeigen](/docs/de/fuxam-web/base/user-management/view-a-user).

2. Wählen Sie **Smart-Dokument**. Ein Fenster mit dem Titel **Smart Document** öffnet sich.

3. Wählen Sie eine Vorlage. Die Vorlagen sind nach **TipTap-Vorlagen** und **PDF-Vorlagen** gruppiert. Die Standardvorlage ist bereits ausgewählt.

4. Ist es eine **Modul**-Vorlage, wählen Sie das Modul. Verwendet sie Zeiterfassungsvariablen, wählen Sie den Zeiterfassungszeitraum.

5. Wählen Sie **Hinzufügen**. Bei einer TipTap-Vorlage öffnet sich die Ausfüllansicht. Bei einer älteren PDF-Vorlage öffnet sich der Ablauf **Bearbeiten und hochladen**.

Sie können den Benutzer auch bitten, das Dokument selbst zu vervollständigen. Nutzen Sie dafür **Vervollständigung vom User anfordern** im Abschnitt **Angeforderte Dokumente**. Siehe [Dokumente verwalten](/docs/de/fuxam-web/cms/smart-documents/manage-documents).

## So funktioniert Self-Service

Mit Self-Service erzeugen berechtigte Benutzer ein Dokument ohne Administrator.

1. Gehen Sie zu **Einstellungen → Kommunikation & Dokumente → Dokumente** und suchen Sie den Abschnitt **Self-Service-Dokumente**.

2. Wählen Sie **Dokument hinzufügen**. Wählen Sie im Fenster **Self-Service-Dokument hinzufügen** die **Vorlage**, die **Rollen**, die sie nutzen dürfen, und optional eine Anforderung.

3. Lassen Sie **Aktiv** eingeschaltet. Ist es aktiv, können berechtigte Benutzer dieses Dokument generieren. Wählen Sie **Änderungen speichern**.

Berechtigte Benutzer wählen dann **Self-Service** in ihren Dokumenten, wählen die verfügbare Vorlage und können eine Kopie herunterladen oder **In Dokumente speichern** nutzen. Ein zweiter Eintrag mit derselben Vorlage, denselben Rollen und derselben Anforderung wird als Duplikat abgelehnt.

:::info
Vorlagen aus der Zeit vor dem TipTap-Editor sind **PDF**-Vorlagen. Sie erscheinen in derselben Auswahl und öffnen den älteren PDF-Ablauf. Der Massen-Download funktioniert nur für PDF-Vorlagen.
:::

## Best Practices

- **Zuerst mit einem echten Benutzer testen.** Fügen Sie das Dokument einem Testbenutzer hinzu und prüfen Sie das Ergebnis.
- **Eine Vorlage als Standard markieren**, und zwar für das Dokument, das Sie am häufigsten erzeugen.
- **Rollen und Anforderungen für Self-Service nutzen.** Geben Sie Zugriff nur denen, die ihn brauchen.
- **Spalte Formularfelder prüfen.** Eine Vorlage ohne Formularfelder kann keine Eingaben sammeln.
- **Klare Vorlagennamen verwenden.** Personen wählen aus einer Liste.

## Häufige Fallstricke

| Fallstrick | So vermeiden Sie ihn |
|---|---|
| Leere Werte im Dokument | Prüfen Sie die Profildaten oder legen Sie im Editor eine Regel **Wenn leer** an. |
| Vorlage fehlt in der Auswahl | Prüfen Sie den **Objekttyp**. Modul-Vorlagen brauchen ein Modul. |
| Kein Zeiterfassungszeitraum | Wählen Sie den Zeitraum, wenn das Fenster danach fragt. Ohne ihn lässt sich das Dokument nicht hinzufügen. |
| Doppelter Self-Service-Eintrag | Ändern Sie Vorlage, Rollen oder Anforderung oder bearbeiten Sie den vorhandenen Eintrag. |
| **Aktiv** versehentlich ausgeschaltet | Benutzer können das Dokument dann nicht mehr erzeugen. |

## FAQ

**Was ist der Unterschied zwischen Hinzufügen und Vervollständigung anfordern?**

Beim Hinzufügen wird das Dokument für den Benutzer erstellt. Beim Anfordern der Vervollständigung soll der Benutzer die Formularfelder selbst ausfüllen; der Stand erscheint als **Ausstehend** oder **Fertig**.

**Wo finde ich erzeugte Dokumente?**

Auf dem Tab **Dokumente** des Benutzers. Siehe [Dokumente verwalten](/docs/de/fuxam-web/cms/smart-documents/manage-documents).

**Können Studierende ihr erzeugtes Dokument speichern?**

Ja. Im Self-Service-Viewer können sie eine Kopie herunterladen oder **In Dokumente speichern** wählen.

**Kann ich vielen Benutzern gleichzeitig ein Dokument hinzufügen?**

Ja. Nutzen Sie die Aktion **Smart Document** in der Benutzertabelle. Siehe [Dokumente in Masse erzeugen](/docs/de/fuxam-web/cms/smart-documents/generate-documents-in-bulk).

## Verwandte Seiten

**[Dokumente in Masse erzeugen](/docs/de/fuxam-web/cms/smart-documents/generate-documents-in-bulk)**

Vielen Benutzern gleichzeitig ein Dokument hinzufügen.

**[Dokumente verwalten](/docs/de/fuxam-web/cms/smart-documents/manage-documents)**

Vorlagentabelle und Benutzerdokumente.

**[Dokumentvariablen und Datenquellen](/docs/de/fuxam-web/cms/smart-documents/document-variables-and-data-sources)**

Was ein Dokument füllt.

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

Eine Vorlage ändern.
