Profilaufruf

Ergebnis parsen

(Haken) truebzw.
leer oder nicht verwendet

(Haken) truebzw.
leer oder nicht verwendet

Aktualisierung
anhand der Zielstruktur

aktualisierte Entität (geparst)

(Fehler) false

Eingabewert unverändert

Zielstruktur (als Entität geparst)

(Fehler) false

unerheblich

Eingabewert unverändert

Ergebnis nicht parsen

(Haken) true

(Haken) true

Aktualisierung
anhand der Zielstruktur

Zielstruktur als Text(datei)
im body eines "Aktionsereignis-Inhalt"-Objekts

alle abweichenden Kombinationen

Eingabewert unverändert

Firma der Session

ID (id) des Firmenkontos

MSG_CALL_SCM_Company_id

BigInteger

Datenobjekt Firmenkontos als XML (Text)

MSG_CALL_SCM_Company_xml

String

Rolle der Session

ID (id) der Rolle

MSG_CALL_SCM_Role_id

BigInteger

Benutzer der Session

ID (id) des Benutzerkontos

MSG_CALL_SCM_User_id

BigInteger

Benutzername (username)

MSG_CALL_SCM_User_username

String

Datenobjekt des Benutzerkontos als XML (Text)

MSG_CALL_SCM_User_xml

String

Im Parameter Profilname muss das aufzurufende Profil durch eine statische Direkteingabe oder die Auswahl eines Eintrags aus der über die beim Eingeben per "Autovervollständigung" aktivierten Dropdown-Liste identifiziert werden.

 HINWEIS  Eine Zugriffskontrolle für Profile auf der Basis von Profilsicherheiten ist dabei im Unterschied zum Aufruf von Profilen im Kontext von Formularen nicht gewährleistet. Alle verfügbaren Profile können ausgewählt und ausgeführt werden.

Die Option Bei Profilfehler abbrechen? entscheidet, wie die Ereignisverarbeitung auf einen Fehler beim Ausführen des Profils reagiert:

• Wird die Option Bei Profilfehler abbrechen? ausgewählt, dann führt ein Fehler, der während der Profilausführung auftritt oder ausgelöst wird, zu einer ProcessException im Verarbeitungskontext des Wertauflösers. Innerhalb von Ereignisbehandlungen bewirkt das neben der Ausgabe einer Fehlermeldung immer auch einen Rollback für die aktuelle Transaktion, sofern im Kontext des Wertauflösers Fehler nicht gezielt abgefangen (Try-Catch-Aktion) oder pauschal ignoriert (z. B. bei der Definition von Anhängen in einer E-Mail-Versand-Ereignisaktion) werden.

• Ist die Option Bei Profilfehler abbrechen? abgewählt (Standard), dann führt das Auftreten bzw. Auslösen eines Fehlers im Zuge der Profilausführung nicht zu einem Abbruch.

• Der Rückgabewert des Wertauflösers im Fehlerfall hängt von der Herkunft des Fehlers (s. Hinweise rechts) und der Auswahl für die Optionen Ergebnis parsen und Als String verwenden ab.

Hinweise zur Fehlerbehandlung:

• Falls im Zuge eines Profilaufrufs eine ProcessException auftritt oder ausgelöst wird, lautet die Fehlermeldung immer "Failed to call Profile: (...)". Details zur Fehlerursache sind im erzeugten Fehlerbericht unter "Caused by (...)" nachzulesen

• Der Fehlerbericht für eine ProcessException kann im Meldungsdialog wahlweise heruntergeladen oder per Klick auf "Mehr" eingeblendet und ggf. mit der Browser-Suche ausgewertet werden.

Hinweise zur Fehlerbehandlung:

• Fehler während der Profilausführung werden ignoriert. Allerdings kann eine ProcessException (ggf. mit Rollback) auftreten, z. B. falls das adressierte Profil nicht existiert.

• Falls laut Konfiguration als Rückgabewert des Wertauflösers ein "Aktionsereignis-Inhalt" erwartet wird (Optionen Ergebnis parsen und Als String verwenden abgewählt), liefert der Wertauflöser im Fehlerfall ein "leeres" Datenobjekt dieses Typs, dessen Felder den Wert null ("kein Wert") enthalten aber nicht insgesamt "kein Wert" (null). Ein Standardwert-Wertauflöser kann daher nur mit Bezug zu einem Feld (z. B. body) eingesetzt werden, um einen Standard-Rückgabewert für den Fehlerfall zuzuweisen. Ist die Option Als String verwenden ausgewählt, liefert der Wertauflöser per Standard die String-Umwandlung des body-Werts, so dass im Fehlerfall "kein Wert" (null) zurückgegeben wird. Dann greift ein Standardwert-Wertauflöser auch ohne expliziten Bezug zu einem Feld des "Aktionsereignis-Inhalt"-Objekts.

• Falls als Rückgabewert ein "Objekt" erwartet wird (Option Ergebnis parsen ausgewählt), dann hängt der Typ des Rückgabewerts davon ab, wie der Fehler während der Profilausführung zustande kam:

  • Tritt in einer der Phasen beim Ausführen des Profils ein für Lobster Data Platform / Integration definierter Fehler auf oder wird im Mapping eine Funktion wie throw exception ausgeführt, dann wird ein spezifisches Fehlerobjekt an Lobster Data Platform / Orchestration zurückgegeben. Lobster Data Platform / Orchestration identifiziert diesen Fehlertyp nach dem Parsen zwar per entityClass-Variable. Eine spezifische Typprüfung wird für die betreffenden Objekttypen allerdings nicht unterstützt.

  • Ein Profilabbruch kann allerdings auch ausgelöst werden, indem die XML-Struktur eines "Fehlerreaktion"-Objekts (ErrorResponse) der Profilvariablen VAR_ERROR_RESPONSE zugewiesen wird. Dann gibt der Parser im Wertauflöser dieses Objekt zurück, was per Typprüfung festgestellt werden kann.

Die Option Ergebnis parsen legt fest, dass als Rückgabewert des Profils ein Text im XML-Format erwartet wird, der in Lobster Data Platform / Orchestration als "Server XML" eines Objekts interpretiert werden kann.

• Sofern sich die Eingangsdaten für das Profil auf eine in Lobster Data Platform / Orchestration definierte Entität beziehen, kann die Zielstruktur des Profils als Aktualisierung für die volatilen Daten dieser Entität interpretiert werden. Wie in der schematischen Tabelle oben unter "Besonderer Anwendungsfall" ersichtlich, kann eine Aktualisierung mit und ohne Auswahl der Option Ergebnis parsen genutzt werden. Die Option Ergebnis parsen wird allerdings typischerweise ausgewählt, so dass die aktualisierte Entität als Rückgabewert des Wertauflösers unmittelbar zur Verfügung steht.

• Ist die Option Ergebnis parsen abgewählt (Standard), dann wird der Rückgabewert des Profils vom Wertauflöser wahlweise als "Aktionsereignis-Inhalt" oder als Text (s. Als String verwenden) zurückgegeben.

• Wenn die Option Ergebnis parsen ausgewählt wird, sollte das Profil bei fehlerfreiem Verlauf eine XML-Zielstruktur zurückgeben, die als "Server XML" lesbar ist. Zum Aufbau einer geeigneten Zielstruktur stehen Orchestration-Vorlagen (z. B. DEFAULT:list für eine "Liste") bereit. Außerdem spiegeln die Eingangsdaten eines per Profilaufruf adressierten Profils die "Server XML"-Struktur des zugehörigen Eingabewerts wider.

• Liefert das aufgerufene Profil Binärdaten (z. B. den Inhalt einer Grafik oder einer spezifischen Anwendungsdatei), sollte die Option Ergebnis parsen abgewählt sein.

Die Option Als String verwenden entscheidet darüber, ob der Rückgabewert des Wertauflösers die aus dem Profilaufruf gewonnenen Daten direkt oder als Text aufbereitet zurückgeben soll.

• Wird die Option Als String verwenden ausgewählt, gibt der Wertauflöser die String-Umwandlung des eigentlichen Rückgabewerts zurück.

• Ist die Option Als String verwenden abgewählt (Standard), werden die Daten (ein geparstes Datenobjekt oder die Binärdaten aus dem Profil als body eines "Aktionsereignis Inhalt"-Objekts) direkt als Rückgabewert verwendet.

• Wird die Option Als String verwenden ausgewählt, können Daten aus dem Profil in Lobster Data Platform / Orchestration als Textwert angezeigt, zugewiesen oder z. B. per Verkettung mit anderen Wertauflösern weiter verarbeitet werden.

• Liefert das aufgerufene Profil Binärdaten (z. B. den Inhalt einer Grafik oder einer spezifischen Anwendungsdatei), sollte die Option Als String verwenden abgewählt sein.

Im Bereich Variablen können über die Symbole und Zuweisungen von Werten an Profilvariablen hinzugefügt oder entfernt werden. Je Variable sind folgende Angaben vorgesehen:

• Ein Variablenname (Pflichtfeld) muss angegeben werden. Dem angegebenen Namen wird im Profil das Präfix MSG_CALL_ vorangestellt. Entsprechende Variablen (im abgebildeten Fall z. B. MSG_CALL_FILENAME_PREFIX) müssen im aufgerufenen Profil explizit angelegt sein, damit ein Wert zugewiesen wird.

• Als Wert (Pflichtfeld) muss ein Wertauflöser konfiguriert werden, dessen Auswertung zur Laufzeit den Wert für die adressierte Profilvariable bestimmt.

• Die Option Als Datei übergeben erscheint, falls sich die Konfiguration für den Wert auf einen Datentyp (wie "Aktionsereignis-Inhalt") bezieht, für den anstelle einer direkten Zuweisung wahlweise eine Referenz auf eine Temporärdatei übergeben werden kann, die nach dem Profilaufruf automatisch gelöscht wird.