---
title: Ein Dokument bearbeiten
description: >-
  Ein Smart Document im TipTap-Editor bearbeiten: Variablen einfügen, als
  Benutzer in der Vorschau prüfen, mit Speichern Versionen veröffentlichen und
  frühere wiederherstellen.
sidebar:
  order: 2
---

**Ein Smart Document bearbeiten** geschieht im TipTap-Editor. Sie öffnen ihn unter **Einstellungen → Kommunikation & Dokumente → Dokumente** im ⋯-Menü einer Vorlage mit **Bearbeiten**. Dort schreiben Sie den Text, fügen Variablen und Formularfelder ein, prüfen das Ergebnis in der Vorschau und veröffentlichen mit **Speichern** eine neue Version.

:::tip
Nutzen Sie vor jedem Speichern die **Vorschau** mit einem echten Benutzer. Variablen, Bedingungen und smarte Tabellen zeigen echte Daten, so fallen Lücken sofort auf.
:::

## Warum das wichtig ist

Im Editor wird aus einer Vorlage ein brauchbares Dokument. Sorgfältiges Bearbeiten verhindert leere Felder, falsche Formulierungen und Layouts, die beim Erzeugen für viele Personen über die Seiten auseinanderfallen.

## Bevor Sie beginnen

| Voraussetzung | Detail |
|---|---|
| **Funktion** | **Smart Documents** im Paket FuxamCMS. |
| **Berechtigung** | `read-write:settings-service-contracts`. |
| **Vorlage** | Eine vorhandene Vorlage. Erstellen Sie zuerst eine, falls Sie keine haben. |
| **Testbenutzer** | Bei Benutzer-Vorlagen ein Benutzer, dessen Profil typische Daten enthält. Bei Modul-Vorlagen eine Modulversion. |

## Der Editor im Überblick

| Bereich | Funktion |
|---|---|
| **Dokumenttitel** (oben links) | Dokument direkt umbenennen. Eine Anzeige zeigt „Speichern...“ und „Gespeichert“. |
| **Als Nutzer:** / **Nutzer wählen** | Wählt den Benutzer, dessen Daten in der Vorschau die Variablen füllen. Modul-Vorlagen zeigen stattdessen eine Modulauswahl. |
| Schalter **Vorschau** | Wechselt zwischen Bearbeiten und Vorschau. Ein Banner meldet „Sie befinden sich jetzt im Vorschaumodus.“ |
| **Versionen** | Listet gespeicherte Versionen, markiert die **Aktuell**e und erlaubt **Wiederherstellen** einer älteren. |
| **Speichern** | Prüft das Dokument, veröffentlicht es als neue Version und bringt Sie zurück zu den Dokument-Einstellungen. |
| ⋯ **Weitere Aktionen** | **Schema anzeigen**, **Aus Word importieren** und **Druckvorschau**. |
| Werkzeugleiste | Rückgängig, Wiederholen, Fett, Kursiv, Unterstrichen, Listen, Ausrichtung, **Einfügen**, Textfarbe, Schriftgröße, Blockformat, Schriftart, **Beispieldaten anzeigen**, Zoom und **Seiteneinrichtung**. |

## So bearbeiten Sie ein Dokument

1. Gehen Sie zu **Einstellungen → Kommunikation & Dokumente → Dokumente** und öffnen Sie das ⋯-Menü der Vorlage. Wählen Sie **Bearbeiten**.

2. Schreiben und formatieren Sie den Text. Nutzen Sie die Werkzeugleiste für Überschriften, Listen, Ausrichtung und Schriften.

3. Öffnen Sie **Einfügen**, um Inhalte hinzuzufügen: **Variable**, **Formularelemente**, **Smarte Tabelle**, **Tabelle**, **Bild**, **Seitenumbruch**, **Bedingter Abschnitt** oder **Unterschrift**. Im Text können Sie auch `/` für das Blockmenü oder `@` für Variablen tippen.

4. Öffnen Sie **Seiteneinrichtung**, um Format, Ausrichtung, Ränder, Kopf- und Fußzeile sowie Seitennummerierung festzulegen.

5. Wählen Sie **Nutzer wählen** (oder ein Modul) und schalten Sie die **Vorschau** ein. Prüfen Sie jede Variable, Bedingung und Tabelle. Mit **Druckvorschau** unter ⋯ **Weitere Aktionen** sehen Sie die Seite als PDF.

6. Wählen Sie **Speichern**. Fuxam prüft das Dokument und veröffentlicht es dann als neue Version. Schlägt die Prüfung fehl, fordert die Meldung „Speichern blockiert“ (oder „Veröffentlichung blockiert“) Sie auf, zuerst Smart-Table-Datenquellen und eingebettete Schriftarten zu beheben. Beheben Sie diese und versuchen Sie es erneut.

Um später weiteren Word-Inhalt zu übernehmen, nutzen Sie ⋯ **Weitere Aktionen → Aus Word importieren**. Wählen Sie **Am Cursor einfügen** oder **Dokument ersetzen**.

Um zu einem früheren Stand zurückzukehren, öffnen Sie **Versionen** und wählen bei der Version **Wiederherstellen**. Die Meldung „Version wiederhergestellt“ bestätigt es.

:::info
Vorlagen aus der Zeit vor dem TipTap-Editor sind **PDF**-Vorlagen. **Bearbeiten** öffnet für sie den älteren PDF-Editor. Diese Seite beschreibt den TipTap-Editor.
:::

## Best Practices

- **Mit mehr als einem Benutzer prüfen.** Testen Sie einen Benutzer mit vollständigen Daten und einen mit Lücken.
- **„Wenn leer“ bei Variablen setzen.** Wählen Sie **Ausblenden**, einen Strich oder **Fallback-Text**, damit Lücken nie wie Fehler aussehen.
- **Bedingte Abschnitte für optionalen Text nutzen.** Legen Sie eine Regel an, statt mehrere fast gleiche Vorlagen zu pflegen.
- **Zuerst die Seite einrichten.** Ränder und Kopfzeilen verändern, wo Seiten umbrechen.
- **Vor dem Verlassen speichern.** Die automatische Speicherung schützt Ihren Entwurf, aber **Speichern** erzeugt die Version, die andere nutzen.

## Häufige Fallstricke

| Fallstrick | So vermeiden Sie ihn |
|---|---|
| Wert tippen, der eine Variable sein sollte | Fügen Sie eine **Variable** ein, damit er sich je Benutzer ändert. |
| Nur einen Benutzer prüfen | Prüfen Sie mehrere Benutzer in der Vorschau. |
| „Speichern blockiert“ ignorieren | Beheben Sie Smart-Table-Datenquellen und eingebettete Schriftarten und speichern Sie erneut. |
| Falsche Version wiederherstellen | Prüfen Sie zuerst Versionsnummer und Markierung **Aktuell** unter **Versionen**. |
| Word-Layout nach dem Import erwarten | Nur die Textstruktur bleibt. Bauen Sie das Layout im Editor neu auf. |

## FAQ

**Veröffentlicht die automatische Speicherung meine Änderungen?**

Sie sichert Ihren Entwurf während der Arbeit. Erst **Speichern** veröffentlicht das Dokument als neue Version, die andere nutzen können.

**Kann ich ein Speichern rückgängig machen?**

Ja. Öffnen Sie **Versionen** und stellen Sie eine frühere Version wieder her.

**Kann ich eine Vorlage umbenennen, ohne den Editor zu öffnen?**

Ja. Nutzen Sie **Umbenennen** im ⋯-Menü der Vorlagentabelle. Siehe [Dokumente verwalten](/docs/de/fuxam-web/cms/smart-documents/manage-documents).

**Warum sehe ich in der Vorschau keine Daten?**

Der gewählte Benutzer oder das Modul hat für diese Variable keine Daten. Wählen Sie einen anderen Benutzer oder prüfen Sie die Daten in der [Benutzerverwaltung](/docs/de/fuxam-web/base/user-management).

## Verwandte Seiten

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

Variablen, Formate und smarte Tabellen.

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

Dokumente für Benutzer erzeugen.

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

Umbenennen, Standard festlegen und löschen.

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

Eine neue Vorlage anlegen.
