Es muss zum Beispiel eine zusätzliche Information, wie der Dateiname an ein Fremdsystem (beispielsweise Microsoft Azure) übermittelt werden oder der Inhalt oder das Format soll verändert werden. Dazu wird eine Orchestration benötigt.
Meist sind zahlreiche solche Schnittstellenprobleme vorhanden, die identisch sind.
Damit nicht für jede Schnittstelle eine eigene Orchestration implementiert werden muss, entwickeln wir eine Generische pro Typ.
Problematik
Wir haben zum Beispiel einen Kunden mit 100 neu zu implementierenden Schnittstellen.
80 davon sollen mit Azure kommunizieren und den Inhalt als Base64 übermitteln. Die Zieldatei soll denselben Dateinamen wie die Quelldatei erhalten. Die Schnittstellen haben aber verschiedene Endpunkte, sowohl im Typ (SFTP/FTP/File Ablage) als auch in der Anbindung (anderer Server).
Lösungsansatz
Generische Orchestration
Wir erstellen uns also eine „generische“ Orchestration. Diese liest die Instanzen direkt aus der „MessageBox“. Das „Receive-Shape“ wird auf alle nötigen «ReceivePortNames» gefiltert.
SQL Datenbank
Damit wir die Informationen pro Schnittstelle variabel haben, lesen wir diese aus einer Datenbank. Selektionskriterium ist der „ReceivePortName“.
Generische Instanz generieren
Mit den ausgelesenen Informationen der Schnittstelle generieren wir die neue Instanz für das Zielsystem (Azure).
Dabei rufen wir eine Funktion in einer Helper-Klasse auf und lesen das Stream der Quell-Instanz ein. Dieses wiederum können wir mit nötigen Parametern ergänzen und als XML Instanz zurückgeben.
Wichtig: Damit auch ein XML übermittelt werden kann, sollte der Inhalt (FileContent) mit Base64 «encoded» werden.
Instanz an Endpunkt senden. Die generierte Instanz wird dann zurück in die MessageBox gesendet und kann dann per «SendPort» mit der nötigen Pipeline (JSON) an das Zielsystem (Azure) gesendet werden.
Wenn in der Datenbank der «TargetNamespace» und das «RootElement» verschieden angegeben werden, können auch verschiedene «SendPorts» verwendet werden. Diese wiederum einfach mit dem jeweiligen «MessageTypen» Filtern.
Fazit
Generische «Orchestrations» machen dann Sinn, wenn viele Schnittstellen fast identisch aufgebaut sind und in gleiche Typen eingeteilt werden können. Der Aufbau der jeweiligen Orchestration ist im Endeffekt jedoch immer spezifisch zu bestimmen. Entscheidend ist dabei, dass die nötigen Informationen, die pro Schnittstelle verschieden sind, in der Datenbank vorhanden sind und von dort ausgelesen werden.
Ergänzende Links
XLANGMessage to Stream examples:
https://csharp.hotexamples.com/de/examples/-/XLANGMessage/-/php-xlangmessage-class-examples.html
