Datenstruktur Validierung

Zweck

Das Validation-Element (Validierung) überprüft eine Liste von Datensätzen anhand eines vordefinierten Regelwerks, um sicherzustellen, dass die Daten korrekt und richtig formatiert sind. Es fungiert als Filter, der die gültigen von den ungültigen Datensätzen trennt.

Dieses Element ist unerlässlich für die Aufrechterhaltung der Datenqualität und für die Fehlerbehandlung, bevor Daten an ein anderes System gesendet oder in einer Datenbank gespeichert werden.

Anwendungsfälle:

• Validierung einer Liste importierter Benutzerdatensätze, um sicherzustellen, dass jeder eine gültige E-Mail-Adresse und einen nicht leeren Namen hat.

• Überprüfung eingehender Bestelldaten, um zu bestätigen, dass Produktmengen positive Zahlen und Preise korrekt formatiert sind.

• Filtern eines Datensatzes, um vollständige von unvollständigen Datensätzen für unterschiedliche Verarbeitungspfade zu trennen.

---

Praktische Anwendungshinweise

• Zentralisierte Regeln: Die Validierungslogik wird zentral in DataStructures verwaltet. Dies ermöglicht die Wiederverwendung desselben Regelwerks in vielen verschiedenen Flows. Bei einer Regeländerung muss diese nur an einem Ort aktualisiert werden.

• Fehlerbehandlungspfad: Ein gängiges Muster ist die Verbindung dieses Elements mit einem Branch. Dort kannst du prüfen, ob die Ausgabe Invalide Einträge nicht leer ist. Ist sie nicht leer, kann ein separater Pfad zur Fehlerprotokollierung oder zur Benachrichtigung eines Administrators verfolgt werden.

• Daten überschreiben: Achte auf die Einstellung „Alte Daten überschreiben“. Das Deaktivieren dieses Kontrollkästchens ist wichtig, wenn du die ursprüngliche vollständige Liste unverändert beibehalten musst.

---

Konfigurationsoptionen

Option	Beschreibung	Eingabeformat	Beispielwert
DataStructure	Die DataStructure, die das Regelwerk enthält, das angewendet werden soll. Die Regeln selbst (z.B. Feld erforderlich, E-Mail-Format) werden innerhalb der ausgewählten DataStructure definiert.	Auswahl aus der Liste der verfügbaren Datenstrukturen.	Neue Benutzer Validierungsregeln
Daten	Die Liste (JSON-Array) von Datensätzen, die validiert werden sollen. Jedes Objekt im Array wird gegen die Regeln geprüft.	JSON-Array.	{{trigger.neue_benutzer}}
Alte Daten überschreiben	(Entscheidende Einstellung) Steuert, wie die Liste der gültigen Einträge ausgegeben wird.	Checkbox (Boolean).	–
	Aktiviert (Standard): Die ursprüngliche Eingabe-Daten-Variable wird mit nur den Datensätzen überschrieben, die die Validierung bestanden haben.
	Nicht aktiviert: Die ursprüngliche Eingabe-Daten-Variable bleibt unverändert. Die validierten Datensätze werden in eine separate Ausgabe Valide Einträge geschrieben.

---

Eingabe-/Ausgabe-Erwartungen

• Eingabe: Das Element benötigt die zu validierenden Daten (als Array) und eine DataStructure, die die Validierungsregeln enthält.

• Ausgabe: Das Element erzeugt mehrere Ausgaben zur Trennung der Daten:

  Ausgabevariable	Inhalt	Hinweis
  Valide Einträge	Das Array der Datensätze, die die Validierung bestanden haben.	Erscheint nur, wenn „Alte Daten überschreiben“ nicht aktiviert ist.
  Invalide Einträge	Ein Array, das nur die Datensätze enthält, die die Validierung nicht bestanden haben.
  Validierungsfehler	Ein Array, das die spezifischen Fehlermeldungen für jeden ungültigen Datensatz enthält, nützlich für Protokollierung oder Benachrichtigungen.

---