DispatchProEventPreParser - Ereignis auslösen (Vorbearbeitung)

Siehe auch: DispatchProEventPostExecuter - Ereignis auslösen (Phase 5), DispatchProEventResponse - Ereignis auslösen (Responder)

Beim Ausführen eines Profils können die empfangenen Daten, über die Vorbearbeitung (Erweiterung), direkt via Ereignis an Lobster Data Platform / Orchestration übergeben werden. Dort können die Daten weiter manipuliert oder gänzlich andere Daten an die Antwortwege zurückgegeben werden.
Das Ereignis wird im Kontext eines Benutzers ausgeführt, der in der Konfiguration angegeben werden muss.

Definieren die Eingangsdaten eine existierende Entität, wird diese geladen und als Eingabedaten an die Ereignisbehandlungen übergeben. Ansonsten werden die Daten in die Variable data geschrieben.

Daten, die an das Mapping oder die Antwortwege übergeben werden sollen, müssen in eine Variable result geschrieben werden.

Ergebnistypen werden wie folgt behandelt:

String - Gibt diesen im Textformat weiter
Inhalt (Content) - Gibt diesen im Binärformat weiter
Andere - Serialisieren als XML oder JSON (soweit möglich). Das Format hängt dabei von der Integration Unit oder dem targetFormat-Parameter (siehe Konfiguration) ab.

Im Feld "Konfigurationsdatei" kann sowohl der Pfad zu einer Datei als auch direkt die Konfiguration in "Name=Wert"-Paaren, separiert durch Strichpunkte (Name1=Wert1;Name2=Wert2), angegeben werden.
Folgende Konfigurationsparameter werden unterstützt:

Parametername	Optional?	Beschreibung
`eventName`	nein (Pflichtangabe)	Name des Ereignisses (Eigenes Aktionsevent), das ausgelöst werden soll.
`userName`	nein (Pflichtangabe)	Name des Benutzers, in dessen Kontext das Ereignis verarbeitet werden soll.
`selectedRole`	Wenn dem Benutzer genau eine Rolle zugeordnet ist.	ID (`id`) für eine der Rollen, die dem Benutzer per Feld "Rollen" (`roles`) zugeordnet ist.
`selectedCompany`	Wenn dem Benutzer genau eine Firma zugeordnet ist.	ID (`id`) für eine der Firmen/Mandanten, die dem Benutzer per Feld "Firmen" (`companies`) zugeordnet ist.
`locale`	ja (optional)	Der Locale Code für eine Sprache (z. B. `de_CH`); Standard: Die für den Benutzer im Feld "Sprache" (`locale`) ausgewählte Sprache.
`useRaw`	ja (optional)	`true` oder `false` (Standard): Wenn `true`, werden die Daten direkt in Rohform (Binär, als "Inhalt" (`Content`)-Objekt) an die Ereignisbehandlungen übergeben. ►HINWEIS◄ Ein "Inhalt" (`content`)-Objekt kann von Wertauflösern und Aktionen auch direkt als String gelesen werden (z. B. setze Wert zu String Variable). Wenn `false`, wird versucht, die Daten als Text zu lesen und diese als Objekt zu lesen. Unterstützt wird dabei JSON und XML.
`charSet`	ja (optional)	Das Character Encoding für die Integration Unit und das Ausgabeformat. Ist `useRaw=true`, wird das Character Encoding beim Einlesen der Daten ignoriert. Wird ein "Inhalt" (`Content`)-Objekt von den Ereignisbehandlungen zurückgeben, wird das Encoding für die Ausgabedaten ignoriert.
`targetFormat`	ja (optional)	xml oder json Gibt an, in welchem Format Ausgabedaten, die nicht vom Typ `String` oder "Inhalt" (`Content`) sind, geschrieben werden.