Anforderungen an Adapter 

Verwendung

Adapter, die Sie  für die SAP Exchange Infrastructure entwickeln, müssen bestimmte Anforderungen erfüllen. SAP legt diese Anforderungen fest, um Kunden leicht einzusetzende, einfach konfigurierbare und leicht zu verwaltende Adapter zur Verfügung zu stellen.

Integration

Die Anforderungen, die als zwingend erfüllbar definiert sind, werden auch im SAP Zertifizierungsprozess untersucht.

Funktionsumfang

Richtlinien für das Adapter-Design

●      Cluster-enabled

Der AS Java ermöglicht das Clustering von vielen J2EE Application Servern. Sie müssen beim Adapterdesign die Nebeneffekte des Clustering berücksichtigen.

Verlassen Sie sich für die Verarbeitung im Adapter nicht darauf, dass ein spezieller Cluster-Knoten der J2EE-Engine zur Verfügung steht. Die Verarbeitung im Adapter sollte auf alle verfügbaren Cluster-Knoten verteilt werden. Vermeiden Sie es, die Verarbeitung im Adapter auf einen speziellen Knoten (beispielsweise über die Cluster-ID) zu beschränken.

Verwenden Sie für die Cluster-Synchronisierung oder eine globales Sperren Funktionen, die vom Enqueue-Server bereitgestellt werden. Sie erhalten Zugirff auf diese Funktionen über Enqueue-Client APIs, beispielsweise LogicalLocking API für cluster-weite Locks.

Weitere Informationen: Sperren

Falls Qualitiy-of-Service in Ihrem Adapter die Ausprägung ExactlyOnceInOrder haben soll, dann muss der Adapter Überholvorgänge, die aufgrund der parallelen Abarbeitung mehrerer Cluster derselben physischen Verbindung möglich sind, verhindern.

●      Spezialisierung

Ihr Adapter muss die Verbindung zu genau einem Typ von Business-System oder Industrie-Transportprotokoll, wie z.B. UCCnet, EDI oder CIDX aufbauen.

●      Direkte Verbindung

Ihr Adapter muss die Verbindung zu einem Business-System oder einem Industrie-Transportprotokoll direkt, d.h. ohne den Einsatz weiterer Software herstellen.

●      Leichtgewichtig

Ihr Adapter muss „leichtgewichtig“ sein. Vermeiden Sie unnötige und zu häufige Änderungen (z.B. viele neue oder geänderte System-DLLs, etc.).

Verwendung von Adapter-Framework-Interfaces

Ihr Adapter muss oder sollte die folgenden Adapter-Framework-Interfaces verwenden:

Interface	Anmerkung	Verwendung obligatorisch
JCA 1.0-konform Siehe auch: Einsatz der Java Connector Architecture 1.0	Ihr Adapter muss die JCA 1.0 SPI-Anforderungen (z.B. Deployment, Server Contracts) und die optionalen JCA 1.0-Anforderungen, die von der SAP Exchange Infrastructure (z.B. CCI) verwendet werden, erfüllen. Die JCA 1.0-Anforderungen, die von SAP XI nicht benötigt werden, können ignoriert werden.	Ja
Adapter-Framework Message-Austausch Siehe auch: Message-Austausch	Die Verbindungsfähigkeit (Connectivity) ist die Mindestanforderung an Ihren Adapter. Er muss dazu in der Lage sein, Messages vom Adapter-Framework zu empfangen und an das angeschlossene Business-System weiterzuleiten und umgekehrt.	Ja
Adapter-Framework adapterspezifische Module Siehe auch: Message-Austausch	Programmieren Sie die XI-spezifische Message- und Protokollkonvertierung entweder komplett innerhalb des Adapters oder implementieren Sie sie in adapterspezifischen Modulen. Diese Module werden dann im Modul-Prozessor aufgerufen.	Nein
Konfigurations-Services Siehe auch: Adapterkonfiguration im Integration Builder	Ohne eine einheitliche Adapterkonfiguration haben Kunden, Berater und der technische Support Schwierigkeiten, Adapter zu verwalten.	Ja
Administrational Services Siehe auch: Administration	Die Verwendung dieses API ist nicht obligatorisch. Eine Einbindung in die einheitliche Verwaltungs- und Überwachungsbenutzerschnittstelle von SAP XI ist wünschenswert.	Nein
Utility Services Siehe auch: J2EE Resource-Zugriff	Der Adapter-Framework Utility-Service stellt den Zugang zu grundlegenden J2EE Server Ressourcen zur Verfügung, hauptsächlich zu Transactions und Threads. Diese müssen unter der Kontrolle des J2EE Server stehen. Multi-Threading und die Verwendung von Transactions werden in den Adaptern gebraucht.	Ja
Logging API Siehe auch: Tracing, Protokollierung und Monitoring	Sie können für Ihren Adapter eigene Protokollmechanismen verwenden.	Nein
Message Data Exchange Siehe auch: Message-Metadaten	Message-Metadaten liefern die Strukturdefinition der XI-Message. Die Definition von Message-Typen kann auch im Integration Repository des Integration Server vorgenommen werden. Siehe auch: Externe Definitionen	Nein