Wie funktioniert die e-Ident Workflow Action?
Die Workflow Action nutzt die e-Ident-API der Global Group TDA Germany GmbH als Schnittstelle, um eine Anfrage an den Micro_Data-Service zur Anreicherung von Daten aus dem mikrogeograpischen Datensystem Micro_Data zu senden.
Die eigentliche Datenanreicherung – also die mikrogeografischen und soziodemografischen Merkmale – erfolgt auf Basis einer Adressreferenzierung. Das Ergebnis wird als vollständiges JSON-Objekt in ein von dir definiertes Zielfeld geschrieben.
In diesem Beitrag erfährst du wie du die Workflow Action „e-Ident“ innerhalb eines Workflows einrichtest und verwendest.
Voraussetzungen
Bevor die Workflow Action genutzt werden kann, müssen folgende Schritte abgeschlossen sein:
1. Installation des e-Ident-Pakets (stellt die technische API-Anbindung bereit)
2. Konfiguration des externen Services e-Ident
Alle Details dazu findest du im Help-Center-Beitrag Micro_Data (e-Ident). Erst nach Abschluss dieser technischen Einrichtung steht die e-Ident Workflow Action im Workflow-Editor zur Verfügung.
Konfiguration
Die Datenabfrage erfolgt über den Workflow-Action-Typ „eIdent Daten abrufen“.
Du findest diesen Action-Typ innerhalb der Workflow-Konfiguration im Bereich Aktionen im Dropdown „Aktionen auswählen“.
Mapping der Felder
Nach Auswahl des Action-Typs musst du festlegen, welche Daten aus dem Datensatz an den Micro_Data-Service übertragen werden.
Folgende Felder sind erforderlich bzw. optional zuzuordnen:
Pflichtfelder für die Datenanreicherung:
- Postleitzahl
- Stadt
- Straße (inkl. Hausnummer)
Optionale Zusatzfelder (falls vorhanden):
- Vorname
- Nachname
- E-Mail-Adresse
- Telefonnummer
- Geburtsdatum
Zusätzlich definierst du ein Zielfeld, in dem das vollständige JSON-Ergebnis des Micro_Data-Service gespeichert wird.
Hinweise und Tipps
- Die Workflow Action funktioniert nur, wenn die gesamte e-Ident-Schnittstelle korrekt eingerichtet wurde, siehe Help-Center-Beitrag Micro_Data (e-Ident).
- Die Struktur und Qualität der Micro_Data-Ergebnisse hängen von den gelieferten Adress- und Personendaten ab.
- Weitere Informationen zur allgemeinen Workflow-Einrichtung findest du auch im entsprechenden Help-Center-Artikel.