Daten-Profil erzeugen/einbinden/triggern

Quellstruktur des Daten-Profils



Wenn Sie das Daten-Profil erzeugen, muss dessen Quellstruktur prinzipiell so aufgebaut sein, wie die Quellstruktur des Formular-Profils (selbe hierarchische Struktur). Es muss den selben Knoten enthalten, der das Daten-Profil zugeordnet hat (hier order), es müssen aber nicht alle Felder und alle Unterknoten verwendet werden. Die Namen der verwendeten Felder und Unterknoten müssen aber identisch sein (Groß- und Kleinschreibung werden unterschieden). Suffixe #xxx werden ignoriert, ein gültiger Knotenname wäre also z. B. auch order_number#2.


images/download/attachments/137300231/14-version-1-modificationdate-1733119268278-api-v2.png


Die vom Formular stammenden Daten landen zuerst im Formular-Profil (als JSON-Datei), also in unserem Knoten order und allem, was darunter liegt. Diese Daten werden 1:1 an das Daten-Profil weitergeleitet (ebenfalls als JSON-Datei).

Zielstruktur des Daten-Profils


In der Zielstruktur des Daten-Profils gelten die selben Regeln, die für die Quellstruktur beschrieben wurden. Es gibt aber zwei kleine Unterschiede. Der Knoten, der die Daten enthält, muss immer data heißen (genau so) und bei der Knoten-Eigenschaft "Maximum" den Wert 1 haben.


images/download/attachments/137300231/15-version-1-modificationdate-1733119268280-api-v2.png


Die Daten der Zielstruktur landen wieder im Formular-Profil (als JSON-Datei) in unserem Knoten order und allem, was darunter liegt und somit letztlich auf der Formular-Seite. Es handelt sich bei dem gesamten Mechanismus also lediglich um den Austausch der JSON-Daten eines bestimmten Knotens. Deshalb ist auch die identische hierarchische Struktur nötig und die exakt geschriebenen Namen der Felder und Knoten.


  • Wählen Sie bei der Integration Unit den Wert ExtendedJsonCreationUnit aus. Sie können dort die Default-Einstellungen verwenden.

  • Erzeugen Sie einen Antwortweg vom Typ Eigene Klasse mit Klasse PassBackDataResponse und stellen Sie den Inhalt auf Ausgabe von IU. Diese Klasse liefert die Daten zurück an das Formular-Profil.

  • Setzen Sie das Daten-Profil aktiv und speichern Sie es. Nur so kann es im Formular-Profil ausgewählt werden und später Daten liefern!

Daten-Profil im Formular-Profil einbinden und triggern


  • Das Daten-Profil muss einem Quellstruktur-Knoten im Formular-Profil (hier order) zugeordnet werden über die Eigenschaft "Daten-Profil". Das Daten-Profil kann nur ausgewählt werden, wenn es aktiv und korrekt aufgebaut ist (→ Siehe Beispiele).

  • Zum Starten eines Datenprofils im Formular gibt es zwei Möglichkeiten (→ Siehe Beispiele).

    • Über ein Quellstruktur-Feld, dessen Eigenschaft "Portalsteuerung" den Wert _submitButton_ hat. Das Feld wird dann im Formular in einen Sende-Button umgewandelt.

    • Über ein Quellstruktur-Feld, dessen Eigenschaft "Daten-Event" einen der Werte Bei Änderung, Initial oder Initial & Änderung hat. Im Eingangsagenten Portal kann die Eingabeverzögerung gesetzt werden, die bestimmt, wie schnell der eingegebene Wert übergeben wird.

Eingehende und ausgehende Daten


Während der Entwicklungsphase kann es interessant sein zu sehen, welche Daten "unter der Haube" wirklich in das Daten-Profil gehen und zurück an das Formular-Profil. Dazu haben Sie folgende Möglichkeiten, um diese Daten im Control Center zu sehen (→ Siehe Beispiele).


  • Die JSON-Eingangsdaten können Sie im für das Daten-Profil erzeugten Job sehen, wenn Sie in Phase 1 des Profil-Loggings die Trace-Meldungen aktivieren für das Daten-Profil.

  • Wenn Sie die JSON-Ausgangsdaten betrachten möchten, die vom Daten-Profil an das Formular-Profil zurückgeschickt werden, können Sie einen zusätzlichen Antwortweg vom Typ Datei mit gesetzter Option Ist Backup der Zieldaten im Datenprofil anlegen. Stellen Sie hier den Inhalt auf Ausgabe von IU.