> For the complete documentation index, see [llms.txt](https://one-loop.gitbook.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://one-loop.gitbook.io/help/plattform/one-loop-plattform/automatisierung/workflows/datumsfelder-im-workflow-aktualisieren.md).

# Datumsfelder im Workflow aktualisieren

## Kurz erklärt

Ein Datumsfeld speichert einen Kalendertag am Kontakt. Mit der Aktion **Kontaktfeld aktualisieren** kannst du ein solches Feld im Workflow automatisch befüllen.

Das eignet sich zum Beispiel für:

* Datum der letzten Qualifizierung;
* Abschlussdatum eines Vorgangs;
* Beginn einer Betreuung;
* Grundlage für spätere Erinnerungen und Warteaktionen.

Dieser Artikel behandelt das Schreiben eines Datums in ein Kontaktfeld. Eine reine Wartezeit oder ein workflowinternes Startdatum ist eine andere Funktion.

## Voraussetzungen

* Das Zielfeld muss als Datumsfeld vorhanden sein.
* Der Workflow benötigt einen passenden Auslöser.
* Der verwendete Wert muss ein gültiges Datum liefern.
* Bestehende Werte dürfen überschrieben werden.
* Nachgelagerte Bedingungen und Erinnerungen müssen das Feld im richtigen Zustand erwarten.

## Aktion einrichten

1. Öffne **Automatisierung → Workflows**.
2. Öffne den gewünschten Workflow.
3. Klicke an der passenden Stelle auf **+**.
4. Wähle **Kontaktfeld aktualisieren**.
5. Vergib einen klaren Namen, zum Beispiel **Datum der Qualifizierung setzen**.
6. Wähle **Felddaten aktualisieren**.
7. Wähle das gewünschte Datumsfeld.
8. Im zweiten Auswahlfeld erscheinen genau drei Eingabemodi: **Benutzerdefiniertes Datum**, **Aktuelles Datum** und **Bestimmtes Datum**.
9. Lege den passenden Modus fest; die dazugehörige Eingabe wird anschließend eingeblendet.
10. Speichere die Aktion.
11. Teste sie mit einem Testkontakt.
12. Öffne den Kontakt und kontrolliere das gespeicherte Datum.
13. Prüfe den Ausführungsverlauf und veröffentliche danach den Workflow.

## Die drei Datumseingaben

### Benutzerdefiniertes Datum

Diese Variante übernimmt einen individuellen Wert oder ein passendes Feld. Nach der Auswahl erscheint in derselben Feldzeile eine zusätzliche Eingabe. Dort legst du fest, welcher Wert oder welches Feld das Datum liefert.

Die Produktquelle nennt für manuell übergebene Werte diese empfohlenen Formate:

* **MM-TT-JJJJ**, zum Beispiel **12-21-2021**;
* **TT-MMM-JJJJ**, zum Beispiel **21-OCT-2021**.

Im ersten Format steht der Monat vor dem Tag. Im zweiten Format wird der Monat mit einer dreibuchstabigen englischen Abkürzung geschrieben. Verwende nicht versehentlich ein deutsches Tages-Monats-Format, wenn die Aktion eines dieser Formate erwartet.

Ein dynamischer Datumswert muss beim Durchlauf für den jeweiligen Kontakt vorhanden und gültig sein.

### Aktuelles Datum

Diese Variante schreibt den Kalendertag, an dem der Kontakt die Aktion erreicht.

Sie eignet sich für Angaben wie **Erstkontakt am**, **Geprüft am** oder **Abgeschlossen am**. Der Wert wird nicht beim Veröffentlichen des Workflows festgelegt, sondern bei jedem tatsächlichen Durchlauf neu. In der Feldzeile ist nach der Auswahl keine weitere Datumseingabe nötig.

### Bestimmtes Datum

Diese Variante verwendet einen fest ausgewählten Kalendertag für alle Kontakte. Nach der Auswahl öffnet sich direkt ein Kalender; dort wechselst du bei Bedarf mit den Pfeilen zum gewünschten Monat und wählst den Tag aus.

Sie eignet sich für einen einmaligen Stichtag. Für dauerhaft wiederkehrende oder kontaktindividuelle Termine ist ein dynamischer Wert oder eine passende Zeitplanfunktion meist verständlicher.

## Welche Variante solltest du wählen?

| Ziel                                                       | Passende Eingabe              |
| ---------------------------------------------------------- | ----------------------------- |
| Den Tag des tatsächlichen Workflow-Schritts speichern      | **Aktuelles Datum**           |
| Für jeden Kontakt ein anderes vorhandenes Datum übernehmen | **Benutzerdefiniertes Datum** |
| Für alle Kontakte denselben festen Stichtag eintragen      | **Bestimmtes Datum**          |

## Was passiert beim Durchlauf?

1. Der Kontakt erreicht die Aktion.
2. Der Datumswert wird bestimmt.
3. Das System prüft, ob der Wert zum Datumsfeld passt.
4. Der bisherige Feldwert wird durch das neue Datum ersetzt.
5. Nachfolgende Schritte können das aktualisierte Datum verwenden.
6. Der Durchlauf wird im Ausführungsverlauf protokolliert.

Die Aktion berechnet nicht automatisch eine Frist. Soll aus einem Datum beispielsweise ein Termin sieben Tage später entstehen, wird dafür eine belegte Datums- oder Rechenfunktion benötigt.

## Datumsfeld mit Warteaktionen verbinden

Ein gespeichertes Datumsfeld kann später eine Warteaktion steuern.

Beispiel:

1. Ein Workflow schreibt einen Folgetermin in ein Kontaktfeld.
2. Eine Warteaktion liest dieses Datum dynamisch.
3. Der Kontakt wartet bis sieben Tage vor dem Datum.
4. Eine Erinnerung wird versendet.
5. Für bereits vergangene Datumswerte ist ein eigener Ausweichweg eingerichtet.

Prüfe besonders, was passiert, wenn das Datumsfeld leer oder beim Erreichen der Warteaktion bereits vergangen ist.

## So testest du ein Datumsfeld

1. Erstelle einen Testkontakt mit einem bekannten alten Datum.
2. Führe den Workflow zunächst mit **Aktuelles Datum** aus.
3. Kontrolliere das Ergebnis am Kontakt.
4. Teste anschließend ein bestimmtes Datum.
5. Teste bei einem benutzerdefinierten Wert beide empfohlenen Formate.
6. Prüfe einen leeren und einen ungültigen Ausgangswert.
7. Öffne den Ausführungsverlauf und kontrolliere mögliche Validierungsfehler.
8. Prüfe eine nachgelagerte Bedingung oder Warteaktion mit dem gespeicherten Wert.

## Häufige Fehler

### Tag und Monat sind vertauscht

Prüfe das erwartete Format. **12-21-2021** bedeutet Monat 12, Tag 21 und Jahr 2021.

### Das dynamische Datum bleibt leer

Kontrolliere das Quellfeld am Testkontakt. Ohne gültigen Ausgangswert kann kein individuelles Datum übernommen werden.

### Das falsche Datum wird überschrieben

Prüfe vor der Veröffentlichung das ausgewählte Zielfeld. Die Aktion ersetzt einen vorhandenen Wert.

### Eine Erinnerung läuft sofort oder gar nicht

Kontrolliere gespeichertes Datum, Zeitzone der nachgelagerten Zeitfunktion und die Regel für bereits vergangene Werte.

### Ein Zeitpunkt mit Uhrzeit wird benötigt

Ein reines Datumsfeld speichert den hier beschriebenen Kalendertag. Prüfe für genaue Uhrzeiten eine dafür vorgesehene Datums-/Zeitfunktion.

## Praxisbeispiel: Qualifizierungsdatum setzen

Ziel: Das Team soll später erkennen, wann ein Kontakt qualifiziert wurde.

1. Eine Wenn/Dann-Aktion prüft die Qualifizierung.
2. Im passenden Pfad aktualisiert die Aktion das Feld **Qualifiziert am**.
3. Als Eingabe wird **Aktuelles Datum** gewählt.
4. Eine zweite Aktion setzt den Status auf **Qualifiziert**.
5. Ein Testkontakt mit altem Status durchläuft den Workflow.
6. Kontaktansicht und Ausführungsverlauf bestätigen Status und Datum.
7. Eine Testliste filtert anschließend nach dem neuen Datum.

Damit wird der fachliche Status mit einem nachvollziehbaren Zeitpunkt verbunden.

## Weiterführende Hilfe

Die allgemeinen Aktionstypen, dynamischen Werte und Feldvalidierungen stehen in [Kontaktfelder im Workflow aktualisieren](/help/plattform/one-loop-plattform/automatisierung/workflows/kontaktfelder-im-workflow-aktualisieren.md).