Bezugsobjekt ist eine Entität

Sofern es sich bei dem Bezugsobjekt um eine Entität - also eine Instanz eines serverseitig definierten konkreten Entitätstyps - handelt, erwartet Lobster Data Platform / Orchestration als Rückgabewert des Profils eine XML-Struktur, die analog zur Objektstruktur bei einem Import mit der Datenstruktur des Bezugsobjekts zusammengeführt werden kann, um dessen volatilen Datenstand zu aktualisieren.

• Wie beim Import sind Lobster_pro Vorlagen hilfreich für das Erstellen von Quell- und Zielstrukturen sofern das Profil die Daten der als Bezugsobjekt übergebenen Entität per Mapping (Phase 3/4) verändern soll.

• Sofern die XML-Struktur im Rückgabewert überhaupt eine ID (id) für die Entität spezifiziert, muss diese auf das Bezugsobjekt verweisen, sonst tritt beim Zusammenführen in Lobster Data Platform / Orchestration ein Fehler (mit Rollback) auf.

• Der Rückgabewert kann analog zum Import auch auf Steuerungsattribute und Knoten zurückgreifen, um Details zur Aktualisierung des Bezugsobjekts zu regeln.

• Typischerweise wird der Rückgabewert für Lobster Data Platform / Orchestration über einen Antwortweg mit dem CronPassBackDataResponseUTF8 (s. _data-Antwortwege (Basismodul)) bereitgestellt.

• Im Unterschied zum Import wird das über den Rückgabewert eines Profilaufrufs aktualisierte Bezugsobjekt nicht automatisch gespeichert. Sofern der Aufruf auf einen geeigneten interaktiven Kontext zurückgeht, kann ggf. der Benutzer also entscheiden, ob das geänderte Bezugsobjekt gespeichert wird oder nicht. Alternativ kann im Kontext der Ereignisbehandlung auch die Ereignisaktion Änderungen später speichern verwendet werden, um das Bezugsobjekt zum Speichern beim Abschluss der Transaktion vorzumerken. Letzteres ist essentiell, wenn Änderungen für ein Bezugsobjekt gespeichert werden sollen, das z. B. per Ausführen mit in Verbindung mit Eingabeobjekt (Typsicher) in eine Transaktion einbezogen wurde, die sich insgesamt auf ein anderes Bezugsobjekt (oder auch gar keines) bezieht.

►HINWEIS◄ Liefert das aufgerufene Profil keinen oder einen ungeeigneten Rückgabewert, etwa weil kein entsprechender Antwortweg konfiguriert oder aktiv ist oder der bereitgestellte Inhalt anstelle des erwarteten XML-Formats z. B. das JSON-Format verwendet, dann tritt ein Fehler auf, der einen Rollback der Transaktion in Lobster Data Platform / Orchestration bewirkt, während Lobster_data den Profil-Job als fehlerfrei abgearbeitet verzeichnet. Falls ein Profil nur mit den Daten einer Entität ausgeführt werden soll, ohne dass einen inhaltlich relevanten Rückgabewert erwartet wird, muss deshalb trotzdem immer ein Antwortweg angelegt werden, der - z. B. per CronPassBackDataResponseUTF8 - eine Datenstruktur zurückgibt, die per Zusammenführung verarbeitet werden kann aber keine Änderungen verursacht. Durch Auswählen der Option "wie empfangen" für Inhalt im Reiter Inhalts-Einstellungen kann z. B. einfach erreicht werden, dass der Rückgabewert die Eingangsdaten unverändert widerspiegelt, während andere Antwortwege sich auf abweichenden Inhalt aus den Phasen 3-5 beziehen können:

Bezugsobjekt ist keine Entität

Wenn das Bezugsobjekt keine Entität sondern z. B. ein simpler Wert, eine Liste (s. Beispiel) oder ein Client-Objekt ist, wird ebenfalls ein Server-XML der entsprechenden Datenstruktur erzeugt und an das Profil übergeben.

• Die Beispieldatei könnte z. B. dazu dienen, um die innerhalb einer Ereignisbehandlung in Lobster Data Platform / Orchestration (z. B. per Sammle Werte-Wertauflöser) generierte Liste von Referenzcodes an ein Profil weiterzugeben, das ausgehend von den übergeben Schlüsselwerten Daten aus anderen Datenquellen abfragt, um diese in aufbereiteter Form an ein spezifische Zielsysteme weiterzuleiten.

►WICHTIG◄ Für Datenobjekte, die keine Entitäten sind, sieht Lobster Data Platform / Orchestration keinen Aktualisierungsmechanismus in Zusammenhang mit einem Profilaufruf vor. Ein Rückgabewert vom Profil wir daher - im Unterschied zum Aufruf mit den Daten einer Entität - weder verarbeitet noch erwartet. Der Profilaufruf erfolgt allerdings trotzdem synchron, d. h. für die Laufzeit des Lobster_data-Profils wird die aufrufende Ereignisbehandlung in Lobster Data Platform / Orchestration unterbrochen. Danach wird sie fortgesetzt, wobei für das Bezugsobjekt selbst dann der Zustand beim Auslösen des Profils unverändert gilt, falls das Profil - z. B. per CronPassBackDataResponseUTF8 - einen Rückgabewert an Lobster Data Platform / Orchestration liefert.

►HINWEIS◄ Im Kontext eines Formulars kann alternativ die Verhaltensweise Profil aufrufen genutzt werden, um ein beliebiges Datenobjekt an ein Profil zu übergeben und den Rückgabewert des Profils anschließend wieder im Portal zu verarbeiten. Bei Bedarf sind dort auch alternative Formate für den Datenaustausch zwischen Lobster Data Platform / Orchestration und dem aufgerufenen Lobster_data-Profil auswählbar (z. B. JSON statt XML), mit denen nicht an Entitätstypen gebundene Datenstrukturen oft effizienter gehandhabt werden können.