Über Aktionen kannst du Werte in ausgewählte Felder bei einer Synchronisierung schreiben, auch konditional.
Aktionen erstellen
Um Aktionen in deinem Plan zu setzen, navigiere zu dem Reiter Verbindung. Bei einem bidirektionalen Plan, wähle die entsprechende Synchronisationsrichtung aus. Du siehst die gemappten Felder und direkt darunter befindet sich der Konfigurationsbereich für die Aktionen.
Wenn du nun oben über dem Feld-Mapping auf Bearbeiten klickst, kannst du alle Optionen (Felder-Mappings, Aktionen, Bedingungen) bearbeiten.
Über den Button Aktionen hinzufügen kannst du eine Aktion hinzufügen. Für jede Aktion kannst du folgende Dinge festlegen:
- Beschreibung (optional): Hier kannst du beschreiben, was die Aktion macht.
- Aktions Feld: Wählt das Feld aus, auf dem die Aktion durchgeführt werden soll.
- Wert: Hier legst du fest, welchen Wert dein Feld bekommen soll.
Wähle den geeignetsten Typ für dein Zielfeld. Hier findest du eine Übersicht über alle Typen:
| Typ | Was passiert? | Input |
|---|---|---|
| String | Schreibt deinen Text ins Feld. | Text Input |
| Null | Setzt das Feld auf „no value“ | Es wird kein Input benötigt. |
| Boolean | Setzt das Feld auf True oder False. | Setze den Schalter auf den Wert, den du brauchst. |
| Integer | Setzt das Feld auf eine Ganzzahl. | Benötigt numerischen Input. |
| Feld des Quellsystems | Kopiert den Wert des gewählten Input Felds. | Input Feld aus der Liste wählen. |
| Feld des Zielsystems | Kopiert den Wert eines produzierten Output Feldes. | Output Feld aus der Liste wählen. |
| Entfernen | Löscht das Feld komplett. | Kein weiterer Input benötigt. |
| Fester Zeitpunkt | Schreibt ein bestimmtes Datum in das Feld. | Wähle „Nur Datum“ aus, falls du nur das Datum haben willst. |
| Relatives Datum/Uhrzeit | Berechnet ein/e Datum/Zeit basierend auf einem Anker (Now, Input/Output Field). | Erstelle das gewünschte Datum z. B. mit Offsets. „Berechnet“ zeigt dir das berechnete Datum an. |
Beispiel:
- Bei der Synchronisation soll der Vorname Hans im Zielsystem gesetzt werden.
- Wähle dafür als Aktions Feld forename und als Type String aus und setze für Wert Hans, siehe Screenshot.
Speichere deine Aktion, wenn du sie fertig konfiguriert hast. Du kannst Aktionen auch speichern, wenn sie noch nicht alle Informationen enthalten. Sie werden bei der Synchronisation nicht berücksichtigt. Um Aktionen zu entfernen, nutze dafür den orangenen Minus-Button.
Bedingte Aktionen
Du kannst auch bedingte Aktionen setzen, d. h. die Aktion wird nur ausgeführt, wenn die Bedingung zutrifft.
Mit Neue Regel fügst du eine Bedingung hinzu. Dann wählst du für Feld des Quellsystems das Feld aus, von dem die Bedingung abhängen soll.
Typische Bedingungs-Operatoren sind Is Empty, Is not Empty, Equals, not Equals, Greater than, Lesser than. Eine Liste mit allen Operatoren findest du hier.
Wähle je nach Bedingung den Operator aus, der zu deinem Fall passt. Die Operatoren Is Empty, Is not Empty funktionieren für alle Felder. Beachte: Operatoren, die numerische Vergleiche machen z. B. Greater Than, Lesser than funktionieren nur bei numerischen Feldern.
Du kannst verschiedene Bedingungen mit AND oder OR verknüpfen und damit Gruppen bilden.
Beispiele:
- Nur ausführen, wenn das Feld E-Mail leer ist.
- Nur ausführen, wenn das Land gleich „DE“ ist.
- Ausführen, wenn entweder Telefon oder Mobilfunknummer vorhanden ist (ODER-Gruppe).
- Nur ausführen, wenn kein Nachname gesetzt ist und wenn die E-Mail-Adresse einen bestimmten Wert hat, siehe Screenshot.
Validierung und Tipps
- Fehlende erforderliche Informationen: Wenn ein Feld und/oder Typ (oder ein erforderlicher Wert) fehlen, wird dir dies im Konfigurationsbereich mit einem Hinweis angezeigt. Du kannst die Bedingung/den Plan dennoch speichern. Die Ausführung erfolgt erst nach der Vervollständigung der Bedingung.
- Wertkonflikt: Gib einen Wert ein, der dem ausgewählten Typ entspricht (verwende z. B. Zahlen für Ganzzahlen und „True/False“ für Boolean). Wenn der Wert nicht passt, kann die Aktion zur Runtime übersprungen werden.
- Bedingungen: Das Frontend schränkt Operatoren nicht nach Feldern ein (außer bei Enums). Das Backend validiert und wendet die Bedingungen an. Wenn ein Operator zur Laufzeit nicht zum tatsächlichen Datentyp des Feldes passt, wird die Bedingung einfach nicht erfüllt.
- Aktionen für Ausgabefelder: Wenn zur Laufzeit kein Ausgabedatensatz verfügbar ist, werden Aktionen, die aus einem Ausgabefeld kopieren, übersprungen. Wenn du einen Wert erwartest, stelle sicher, dass der Ausgabedatensatz früher in deinem Ablauf vorhanden ist.
- Relative Datums- und Zeitangabe: Überprüfe in der Vorschau, ob das Ergebnis deinen Erwartungen entspricht (insbesondere bei mehreren Offsets – beachte, dass Offsets in der Reihenfolge verarbeitet werden).
Falls du noch mehr über Bedingungen lesen willst, sieh dir gern die dazugehörige Help Center Dokumentation an!
Du möchtest deine Systeme verbinden und brauchst unsere Hilfe oder Beratung? Dann kontaktiere uns einfach mit deinem Anliegen und wir helfen dir gerne weiter!