Hinweis: Inhalte zur früheren Open-Source-basierten Java-8-Version wurden entfernt und sind für die aktuelle Version nicht mehr gültig.
Public API und Erweiterungsmöglichkeiten
Die AEP.B2B stellt dokumentierte Schnittstellen und APIs zur Verfügung, die für Integrationen und Erweiterungen genutzt werden können.
Die Public API wurde im Rahmen des Java-25-Upgrades überarbeitet und stellt die für Eigenentwicklungen vorgesehenen Schnittstellen, Basisklassen und Datenobjekte der AEP.B2B bereit. Sie umfasst insbesondere die für die Nachrichtenverarbeitung erforderlichen Interfaces und Objekte und bildet die Grundlage für die Entwicklung eigener Erweiterungen, wie z. B. Actions oder ChannelDistributions.
Erweiterung über die Public API
Die Erweiterung der AEP.B2B erfolgt über die bereitgestellte Public API.
Die hierfür vorgesehenen Schnittstellen werden über das Artefakt b2b.api bereitgestellt und bilden den zentralen Erweiterungspunkt der Software.
Zulässig sind insbesondere:
- Entwicklung kundenspezifischer Erweiterungen auf Basis der freigegebenen API
- Einbindung eigener Komponenten oder Bibliotheken, die über die API integriert werden
- Nutzung der API zur Integration in bestehende Systemlandschaften
Abgrenzung
Eigenentwicklungen auf Basis der Public API sind ausdrücklich vorgesehen und unterstützt. Die Abgrenzung betrifft nicht die Möglichkeit zur kundenspezifischen Erweiterung, sondern den Umgang mit den ausgelieferten Softwareartefakten selbst.
Nicht vorgesehen sind insbesondere:
- Direkte Änderungen an den ausgelieferten Softwareartefakten der AEP.B2B
- Eingriffe in nicht dokumentierte oder interne Bestandteile der Software
- Nutzung nicht freigegebener Schnittstellen oder Erweiterungsmöglichkeiten
Die Public API stellt keinen Zugriff auf alle internen Funktionalitäten der AEP.B2B dar. Eigene Erweiterungen werden als eigenständige Artefakte außerhalb der ausgelieferten Software bereitgestellt.
Kompatibilität und Wartung
Die AEP.B2B wird kontinuierlich weiterentwickelt. Änderungen an APIs können im Rahmen von Releases erfolgen.
Kundenspezifische Erweiterungen sollten daher:
- regelmäßig auf Kompatibilität mit neuen Versionen geprüft werden
- bei Versionswechseln angepasst und getestet werden
Support und Verantwortung
Kundenspezifische Erweiterungen oder eigene Komponenten sind nicht Bestandteil der ausgelieferten AEP.B2B und liegen in der Verantwortung des Lizenznehmers.
Für solche Erweiterungen übernehmen wir keine Gewährleistung und keinen Support.
Bei Bedarf unterstützen wir im Rahmen individueller Vereinbarungen bei der Analyse oder Anpassung kundenspezifischer Erweiterungen.
Hinweis zu früheren Versionen
Frühere Versionen der AEP.B2B (insbesondere auf Basis von Java 8) boten in Einzelfällen weitergehende Möglichkeiten zur direkten Einbindung eigener Code-Erweiterungen oder zur Erstellung kundenspezifischer Deployments (z. B. durch eigene WAR-Deployments).
Diese Ansätze waren nicht Bestandteil eines standardisierten Erweiterungsmodells. Für die aktuelle Java-25-Version ist ein eigenes kundenspezifisches WAR-Deployment nicht mehr vorgesehen.
Stattdessen können kundenspezifische Erweiterungen als eigenständige JAR-Dateien bereitgestellt und über das tomcat/lib-Verzeichnis eingebunden werden. Dieser Ansatz löst die bisherige Vorgehensweise ab und bildet den empfohlenen Integrationsweg für eigene Erweiterungen.
Eigenentwicklungen mit nicht vollständig abgedeckten Anwendungsfällen
Uns ist bewusst, dass in bestehenden Installationen vereinzelt kundenspezifische Erweiterungen im Einsatz sein können, die nicht ausschließlich auf der Public API basieren. Solche Erweiterungen werden von der aktuellen Public API möglicherweise nicht vollständig abgedeckt.
Sofern Sie entsprechende Eigenentwicklungen einsetzen, sprechen Sie uns gerne mit den konkreten Anforderungen an. Gemeinsam prüfen wir den jeweiligen Anwendungsfall und erarbeiten eine geeignete Lösung. Je nach Szenario kann dies beispielsweise sein:
- eine Erweiterung der Public API
- die Aufnahme zusätzlicher Funktionalitäten in die AEP.B2B
- ein anderer technisch geeigneter Lösungsansatz