# Dokument aktualisieren

<a
href="#!/guide/p2F6C9FC4_91A9_4C37_B107_05A466B7C906">Dokumentvorlagen</a> enthalten Platzhaltertexte, welche beim Anlegen des Dokuments durch Informationen aus dem Vertrag ersetzt werden. Wurden <span
style='font-weight:bold;font-style:italic'>Inhaltssteuerelemente</span> in Microsoft Word als Platzhalter verwendet, können die darin enthaltenen Informationen nachträglich aktualisiert werden. Gleiches gilt für die hinterlegten Vertragsklauseln, die ebenfalls (gesondert oder mit den Platzhaltertexten gemeinsam) aktualisiert werden können.

> <span
style='font-style:italic'>Zu einem Vertrag wurde ein neues Vertragsdokument angefertigt. Im Kopf des Dokuments wurden Ansprechpartner, sowie die Adresse des Vertragspartners automatisch befüllt. Während der Verhandlung ändert sich der Ansprechpartner, da die Firma umzieht. Mithilfe der Aktion &quot;Dokument aktualisieren&quot; können die Platzhaltertexte im Word-Dokument automatisch erneuert werden.</span>

Nachfolgende Abbildung zeigt ein Inhaltssteuerelement (Content Control) in Microsoft Word.

{@img img1.png}

<span class="tag_warning">Die Aktion aktualisiert alle Inhaltssteuerelemente, die gültige ELO-Tags definieren. Manuelle Änderungen nach der Erstellung des Dokuments in diesen Feldern werden entsprechend aktualisiert.</span>

## Aktion: Dokument aktualisieren

Die Aktion kann im Reiter `Verträge` der Multifunktionsleiste aufgerufen werden. 

{@img img3.png}

### Vorbedingungen

*   Der Anwender befindet sich im Client auf oder innerhalb eines Vertrags.
*   <span
style='font-weight:bold'>Es wurde ein Dokument selektiert, welches Platzhalter-Texte und/oder Vertragsklauseln enthält.</span>

### Dateneingabe

Nach dem Auslösen der Schaltfläche kann der Benutzer entscheiden, ob er nur die Formularfelder, nur die Klauseln oder beides aktualisieren möchte. 

{@img img5.png}

Beim Aktualisieren der Daten werden die evtl. geänderten Inhalte in das Word-Dokument übertragen. Anschließend wird das Dokument zur Bearbeitung geöffnet.

<span class="tag_important">Auch Vertragsdokument-Vorlagen können aktualisiert werden. Dort werden jedoch automatisch nur die Klauseln aktualisiert, da es hier keine Felder zur Aktualisierung gibt.</span>

### Implementierung

<span class="tag_warning"><span
style='font-weight:bold'>Action definitions:</span> Definitionen der Aktion für die Clients finden sich in der Konfiguration `sol.contract.documents.UpdateDocument`.</span>

Der <span
style='font-weight:bold'>technische Ablauf</span> wird durch die ELOas Aktion `sol.contract.as.actions.CreateDocument` implementiert.

Im Erfolgsfall werden folgende Events an den Client übermittelt:

<table><thead><tr><td>Event</td><td>Beschreibung</td><td>Status</td></tr></thead><tbody><tr><td>GOTO</td><td>Zeigt das neu angelegte Element im Client an.</td><td></td></tr></tbody></table>
