Orchestration-Vorlagen

Beim Konfigurieren von Profilen ist das sogenannte "Mapping" (Phase 3) von zentraler Bedeutung für die Funktion der Profils, auch wenn dieser Schritt grundsätzlich optional ist, also auch übersprungen werden kann. Das Übertragen von Eingangsdaten ausgehend von einer Quellstruktur (links im Bild) auf eine bestimmte Zielstruktur (im Bild rechts vorgesehen aber noch nicht angelegt) definiert dabei mehr oder weniger komplexe Zuordnungen, Transformationen und Abhängigkeiten und kann auch das Nachschlagen von in den Eingangsdaten nicht vorliegenden Daten einbeziehen.

Der Aufbau von Quellstruktur und Zielstruktur folgt dabei demselben Bauprinzip, nämlich einer Baumstruktur, die streng hierarchische Anordnungsbeziehungen zwischen "Knoten" ("Ordner"-Symbol) und "Feldern" ("Kreis"-Symbol) einerseits festlegt und andererseits anschaulich beschreibt. Beiden Elementtypen sind Ankerpunkte für weitere mehr oder weniger komplexe Defintionen und - die für das "Mapping" maßgeblichen wechselseitigen Beziehungen zwischen Quellstruktur und Zielstruktur.

Dieselbe Datenstruktur kann mit dieser Technik prinzipiell auf vielen unterschiedlichen Wegen modelliert bzw. generiert werden. Der Aufbau kann dabei mit zunehmender Komplexität der Strukturen rasch zeitaufwändig werden, wenn dabei jedes Element individuell hinzugefügt und parametriert werden muss. Vordefinierte Vorlagen für systemseitig "bekannte" Datenstrukturen, die über das Menü am unteren Rand der Fenster für die Quell- und Zielstruktur per Kontextmenüfunktion Vorlage laden eingebunden werden können, beschleunigen solche Abläufe erheblich.

Das zugehörige Untermenü beinhaltet die Kategorie Orchestration, die Vorlage-Strukturen für sämtliche für in Lobster Data Platform / Orchestration definierte Datenobjekte anbietet.

images/download/attachments/201674281/image2020-7-15_12-55-55-version-1-modificationdate-1747055078797-api-v2.png

Bei Auswahl der Kategorie Orchestration, erscheint der folgende Dialog, der definiert welche Vorlage wie und wo eingefügt werden soll:

Ist die Option Struktur als Unterknoten einfügen nicht gesetzt (Standard), ersetzt die Struktur der Vorlage den gesamten bisherigen Inhalt der Quell- bzw. Zielstruktur.
ACHTUNG Alle nicht gespeicherten Eingaben für die betreffende Struktur gehen dann unwiderruflich verloren!
Ist die Option Struktur als Unterknoten einfügen gesetzt, dann wird die Vorlage unter Berücksichtigung der unter api.scm.appendToNode Auswahl für den Zielknoten in die bestehende Struktur eingefügt. Ist kein Zielknoten angegeben, erscheint ein zusätzlicher Knoten auf oberster Ebene.
Die Auswahl für die Entität bestimmt, welche Vorlage eingefügt wird. Zur Auswahl stehen hier neben echten "Entitäten" auch alle anderen als XML serialisierbaren Objekte.
Ist Option Keine Entity Attribute gesetzt, wird die unter Entität ausgewählte Vorlage ohne die für Entitäten und Attribute automatisch verwalteten XML-Attribute (id, ownerID, creatorId, lastModified, usw.) eingefügt. Dies ergibt eine schlankere, übersichtlichere Struktur und vor allem für eine Zielstruktur kann auf diese Merkmale oft pauschal verzichtet werden, da sie entweder schreibgeschützt sind oder automatisch befüllt werden sollen. Wird für eine Aktualisierung die ID(id_attr) benötigt oder soll der Besitzer (ownerId) gesetzt werden, ist es ggf. immer noch einfacher diese Merkmale gezielt zu ergänzen als nicht benötigte an vielen Stellen zu löschen.

images/download/attachments/201674281/image2020-7-15_14-51-19-version-1-modificationdate-1747055078801-api-v2.png

Ist die Option Typisierte Attribute expandieren gesetzt, dann werden auf der Grundlage der aktuellen Definition für die entsprechenden Dynamischen Aufzählungen für alle in der Struktur enthaltenen attributes-Knoten sämtliche theoretisch nutzbaren Ausprägungen von Typisierten Attribute als individuelle Knoten ausgeprägt.
Ist die Option Typisierte Attribute expandieren nicht gesetzt (Standard), dann findet man im attributes-Knoten nur einen Knoten für jeden Typ eines Typisierten Attributs (Textattribut, Kennzeichenattribut, Firmen- und Addressattribut), mit unbestimmten Typ (type_attr).

►ANMERKUNG◄ Das "Expandieren" der typisierten Attribute betrifft bei Vorlagen für Geschäftsobjekte immer mehrere Ebenen, da die enthaltenen Entitäten wie Positionen, Firmen, Produkte, Adressen usw. ebenfalls attributes-Knoten enthalten. Abhängig von der Vielfalt der Ausprägungen für die verschiedenen Typisierten Attribute erreicht die Anzahl der Elemente in der Struktur eines "voll expandierten" Geschäftsobjekts oft den fünfstelligen Bereich - selbst wenn die Option Keine Entity Attribute gesetzt wird, um systembedingten "Overhead", der auch jeden einzelnen Attributknoten der Struktur betrifft, zu unterdrücken.

Das Eingabefeld Xml/Json in statische Struktur erscheint nur im Kontext einer Zielstruktur. Es betrifft die separat dokumentierte Funktionalität zum Erstellen einer statischen Zielstruktur, die analog zu einer Vorlage als bzw. innerhalb einer Zielstruktur eingefügt werden kann.

Der Button Anwenden startet das Einfügen einer Vorlage-Struktur mit den vorgenommenen Einstellungen unmittelbar. Da das Generieren umfangreicherer Strukturen etwas Laufzeit benötigen kann, erscheint bis zum Abschluss der Aktion eine Fortschrittsanzeige.