Dieser Bereich beschreibt, wie Sie einen eigenen Adapter in Java mithilfe des Adapter-Frameworks von X4 ADK entwickeln.
Sie lernen die wichtigsten Bausteine der Adapterentwicklung kennen und erhalten Best Practices für robuste Implementierungen und Tipps zur Fehlerbehebung.
Einführung
Adapter sind Prozessbausteine, die grundlegende Funktionen bereitstellen, etwa Datenkonvertierungen oder Datenaustausch mit Drittsystemen. Da X4 ESB hauptsächlich mit XML-Daten arbeitet, werden in technischen Prozessen mit Adaptern meist XML-Dokumente erzeugt oder verändert. Ein Adapter benötigt in der Regel einen Input und gibt meist ein XML-Dokument aus, das im nächsten Prozessschritt weiterverarbeitet wird.
Eigene Adapter zu implementieren, ist die schnellste und einfachste Möglichkeit, verschiedene Anwendungen in die X4 BPMS zu integrieren und den Funktionsumfang der X4 BPMS zu erweitern. Die X4 BPMS stellt hierzu ein Framework bereit, das die Adapter-Entwicklung in vielerlei Hinsicht vereinfacht.
Mit dem Adapter Development Kit (ADK) können Sie eigene Adapter erstellen, die nahtlos in den X4 Designer eingebunden werden.
Ablauf der Adapterentwicklung
Der Entwicklungsprozess setzt sich aus folgenden Schritten zusammen:
-
Grundlagen verstehen (
BaseAdapter,X4Document) -
Adapter-Annotationen und Parameter definieren
-
Benötigte Runtime-Services über
Requires*-Interfaces anfordern -
Operationen implementieren
-
Status- und Fehlerbehandlung ergänzen
-
Testen, deployen, bereitstellen
-
Version pflegen und ggf.
.fa-Datei aktualisieren
Template mit Beispielen für Adapter
Die X4 BPMS enthält ein ESB-Template mit mehreren Beispielprozessen mit eingebauten ADK-Adaptern.
Hinweis:
Das ADK-Paket mit den Java-Dateien zu den im Template enthaltenen Adaptern (adk-example.zip) können Sie im Download-Bereich der SoftProject-Website herunterladen. Weitere Informationen finden Sie unter ADK-Umgebung einrichten.
So öffnen Sie das Template
-
Klicken Sie in der Sicht Projects mit der rechten Maustaste auf einen leeren Bereich.
-
Wählen Sie New aus.
-
Wählen Sie ESB Project aus.
Das Dialogfenster Project Creation Wizard wird geöffnet.
-
Wählen Sie Demo > ADK_Demo_2024 aus.
-
Geben Sie einen Namen in das Feld Project name ein.
-
Wählen Sie Finish aus.
Das Template enthält verschiedene reale und intuitive Beispielprozesse, die Sie als Grundlage für die Entwicklung eigener Adapter mit Java verwenden können.
Die Beispielprozesse enthalten ausführliche Erläuterungen und Hinweise.
Weitere Informationen