Adapterhandbuch EAI One V 2.7

Transkript

1 Adapterhandbuch EAI One V 2.7 EAI One Adapterhandbuch Version 2.7

2 Copyright Das Werk ist einschließlich aller seiner Teile urheberrechtlich geschützt. Jede Verwertung, die nicht ausdrücklich vom Urheberrechtsgesetz zugelassen ist, bedarf der vorherigen Zustimmung der EAI One Integration. Das gilt insbesondere für die Vervielfältigung, Bearbeitung, Übersetzungen, Mikroverfilmungen und die Einspeicherung und Verarbeitung in elektronischen Systemen. Die Marken EAI One Integration und EAI One sind Marken oder eingetragene Marken der EAI One Integration. Alle anderen Produktnamen oder Marken bzw. eingetragene Marken sind das Eigentum der jeweiligen Inhaber und als solche zu beachten. SAP und mysap.com sind Marken der SAP Aktiengesellschaft Systeme, Anwendungen, Produkte in der Datenverarbeitung, Neurottstraße 16, D Walldorf. Der Herausgeber bedankt sich für die freundliche Genehmigung der SAP Aktiengesellschaft, das Warenzeichen im Rahmen des vorliegenden Titels verwenden zu dürfen. Die SAP AG ist jedoch nicht Herausgeberin des vorliegenden Titels oder sonst dafür presserechtlich verantwortlich. EAI One Integration Alle Rechte vorbehalten.

3 Inhaltsverzeichnis Adapter-Handbuch EAI One Adapter...V-1 1 Kapitelaufbau...V-1 2 Fragen, Anmerkungen und Anregungen an das Redaktionsteam...V-2 Einführung in die EAI One Adapter...E-1 1 Adaptertypen...E Applikationsadapter...E Protokolladapter...E Transportadapter...E-1 2 Werkzeuge für den Administrator...E Editor...E Dialog-Editor...E Assistent...E Maschineneinstellungen, Startoptionen, Load- und Ausfall-Balancing...E-2 Kapitel 1 Physikalische Kommunikation der EAI One Adapter Allgemeine Systemarchitektur einer Fremdapplikation Systemarchitektur der Adapter Transport der Nachrichten Referenzinformationen Anwendung Virtuelle Maschine Eingang und Ausgang der virtuellen Maschine TCP/IP Server Statische Systemzugriffe Datenbank Kommunikation Kommunikation zwischen Adaptern Kommunikation mit Fremdapplikationen Parallele Datenverarbeitung Failover Load Balancing Adapter-Verhalten Asynchrones Verhalten Synchrones Verhalten Transaktionales Verhalten Adapter - EAI One V 2.7 IVZ - 1

4 Inhaltsverzeichnis Kapitel 2 Protokolladapter Protokolladapter unter EAI One Systemarchitektur Arbeitsrichtung Datenempfang Acknowledgement Konvertierung Einstellungen Protokollattribute XML Adapter Allgemeines Besondere Funktionalität Empfang von EAI One Standardobjekten Empfang von XML Daten Einstellungen Einstellungen für das Protokoll vornehmen Nachrichtenidentifikation Gültigkeitsprüfung Dynamische Gültigkeitsprüfung Transport Parametertabelle Nachrichtenidentifikation Applikationsselektor Standard-Validierungsschema (ValShema) Rückmeldung Adapterrückmeldungen Positive Rückmeldung Negative Rückmeldung Editor - XML Elementdefinition im Protokollattribut Syntax der Protokollattribute Fielditem Bezeichnung Wiederholbar Erforderlich Typ Index Referenzen SAP - RFC Adapter Allgemeines Besondere Funktionalität Empfang von EAI One Standardobjekten Empfang von Daten aus einem RFC-Funktionsbausteinaufruf IVZ - 2 Adapter - EAI One V 2.7

5 Inhaltsverzeichnis 3 Einstellungen Einstellungen mit dem Assistenten bearbeiten - RFC Server RFC Aktion RFC Server Ein-/Ausgabeparameter Einstellungen mit dem Assistenten bearbeiten - RFC Client RFC Aktion Nachrichtenidentifikation Parametertabelle Klausel Funktionsbaustein RFC_READ_TABLE Erlaubte SAP Transaktionen Editor - RFC-Attribute im Protokollattribut Syntax der Protokollattribute Erforderlich Wiederholbar Typ Länge Offset Systemzugriffe Referenzen HL7 Adapter Allgemeines Besondere Funktionalität Empfang von EAI One Standardobjekten Empfang von HL/7 Daten Einstellungen Parametertabelle Ereignisgruppe Ereignis Editor - HL Syntax der HL7 Felddefinition, Komponenten oder Unterkomponenten Position Wiederholbar Erforderlich Referenzen SQL Adapter Allgemeines Besondere Funktionalität Empfang von EAI One Standardobjekten Einstellungen Aktion Klausel Adapter - EAI One V 2.7 IVZ - 3

6 Inhaltsverzeichnis 3.3 Bestätigung (Commit) Verbindung Trigger-Nachrichtenidentifikation Parametertabelle Automatisch generierte WHERE-Klausel Automatisch generierte Spaltenliste Automatisch generierte Tabellenliste Automatisch generierter SQL Befehl Editor - Tabellenspalten im Protokollattribut Syntax der Protokollattribute Erforderlich Wiederholbar Typ Länge Offset Systemzugriffe Referenzen SQL Trigger Adapter Allgemeines Die Funktionsweise des Datenbanktrigger Adapters Einstellung der Datenbank und Registrierung der DLL Einstellung des Oracle Listeners Registrieren der DLL und der externen Funktion Aufruf der externen Funktion aus einem Datenbanktrigger Einstellung der Kommunikationsparameter in der DLL Die Kommunikationsparameter und ihre Voreinstellungen Manuelle Veränderung der Parameter Zur Beachtung EDIFACT Adapter Allgemeines Besondere Funktionalität Empfang von EAI One Standardobjekten Empfang von EDIFACT Daten Einstellungen Nachrichtenidentifikation Sonderzeichen Parametertabelle Editor - EDIFACT Element-, oder Unterkomponentendefinition Syntax der Protokollattribute Position Wiederholbar Erforderlich IVZ - 4 Adapter - EAI One V 2.7

7 Inhaltsverzeichnis 6 Referenzen EDI Adapter Allgemeines Besondere Funktionalität Empfang von EAI One Standardobjekten Empfang von EDI Daten Einstellungen Nachrichtenidentifikation Parametertabelle Editor EDI Element-, oder Unterkomponentendefinition Syntax der Protokollattribute Fielditem Beschreibung Fielditem Protokollattribut Länge Index Offset Beschreibung Referenzen SAP - IDoc Adapter Allgemeines Besondere Funktionalität Empfang von EAI One Standardobjekten Empfang von IDoc Empfang von XML kodiertem IDoc Einstellungen Nachrichtenidentifikation Absender Empfänger Kundenerweiterung Bestätigung Parametertabelle Editor - IDoc Felddefinition im Protokollattribut Beschreibung Wiederholbar Erforderlich Adapter - EAI One V 2.7 IVZ - 5

8 Inhaltsverzeichnis 6 Systemzugriffe Referenzen SAP - BAPI Adapter Allgemeines Besondere Funktionalität Empfang von EAI One Standardobjekten Auslesen der BAPI Rückgabewerte Einstellungen Parametertabelle Editor - BAPI Übergabeparameterdefinition Syntax der BAPI Übergabeparameterdefinition Position Wiederholbar Erforderlich Typ Länge Index Offset Nachkommastellen Trenner Beschreibung Systemzugriffe Referenzen ANSI X12 Adapter Allgemeines Besondere Funktionalität Empfang von EAI One Standardobjekten Empfang von ANSI X12 Daten Einstellungen Editor - ANSI X12 Element- oder Unterkomponentendefinition im Protokollattribut Syntax der Protokollattribute Position Wiederholbar Erforderlich Referenzen Kapitel 3 Applikationsadapter Applikationsadapter unter EAI One Systemarchitektur Arbeitsrichtung IVZ - 6 Adapter - EAI One V 2.7

9 Inhaltsverzeichnis 2.2 Datenempfang Konvertierung Dialog-Erweiterungen SAP - C-API Adapter Allgemeines Besondere Funktionalität Empfang von EAI One Standardobjekten Dialogsprache Editor - C-API Dialoge Systemzugriffe Kapitel 4 Transportadapter Transportadapter unter EAI One Systemarchitektur Arbeitsrichtung Datenemfang Konvertierung File Adapter Allgemeines Besondere Funktionalität Empfang von Daten Lesen, Verarbeiten und/ oder Ändern von Dateien Einstellungen Dateien lesen Dateien schreiben Dateien lesen und schreiben Parametertabelle Ermitteln der Funktionsobjekt ID Nur Startzeichenfolge gesetzt - Startzeichenfolge gefunden Start-, Offset und Endezeichenfolge gesetzt - beide Muster gefunden Startzeichenfolge, Offset und Länge gesetzt - Startzeichenfolge gefunden Startzeichenfolge, Offset gesetzt - Startzeichenfolge gefunden Start- und Endezeichenfolge gesetzt - beide Muster gefunden Startzeichenfolge und Länge gesetzt - Startzeichenfolge gefunden Offset und Endezeichenfolge gesetzt - Endezeichenfolge gefunden Offset und Länge gesetzt Adapter - EAI One V 2.7 IVZ - 7

10 Inhaltsverzeichnis 6 Zeichenketten, die durch Zeitstempel ersetzt werden Systemzugriffe Referenzen HTTP Adapter Allgemeines Besondere Funktionalität Empfang von Applikationsdaten (Client Modus) Empfang von HTTP Daten (Server Modus) Einstellungen Systemzugriffe Referenzen SSL Adapter Allgemeines Besondere Funktionalität Empfang von unverschlüsselten Daten - SSL Client Empfang von SSL Daten - SSL Server Einstellungen Parametertabelle Referenzen Zip Adapter Allgemeines Besondere Funktionalität Einstellungen Daten komprimeren Daten dekomprimieren Parametertabelle Kapitel 5 EAI One Object Handler Allgemeines Besondere Funktionalität Empfang von EAI One Standardobjekten Dialogsprache Glossar...G-1 IVZ - 8 Adapter - EAI One V 2.7

11 EAI One Adapter In den folgenden Kapiteln erfahren Sie, wie Sie EAI One-Adaptern parametrieren können. 1 Kapitelaufbau Dieses Handbuch enthält folgende Kapitel: Einführung Einführung in die EAI One Adapter Hier finden Sie eine kurze Beschreibung, was Adapter sind und welche Typen es gibt. Außerdem finden Sie eine kurze Zusammenfassung, welche Werkzeuge Ihnen zur Parametrierung der Adapter zur Verfügung stehen und wo Sie Informationen dazu finden können. Kapitel 1 Physikalische Kommunikation der EAI One Adapter Hier finden Sie eine Beschreibung der Systemarchitektur der Adapter, der benötigten Referenzinformationen sowie Informationen über Kommunikation und Verhalten der Adapter. Kapitel 2 Protokolladapter Hier finden Sie eine der allgemeine Beschreibung des Aufbaus eines Protokolladapters Für jeden Adapter wird kurz das Protokoll beschrieben und eine Referenz auf die zugrundeliegende Spezifikation eingefügt. Außerdem finden Sie detaillierte Angaben zu Parametrierung und Einstellung, Verwendung der Editoren sowie der benötigten Maschineneinstellungen. Kapitel 3 Applikationsadapter Hier finden Sie eine der allgemeine Beschreibung des Aufbaus eines Applikationsadapters. Angaben zu Parametrierung und Verwendung der Editoren sowie der benötigten Maschineneinstellungen. Kapitel 4 Transportadapter Hier finden Sie eine der allgemeine Beschreibung des Aufbaus eines Transportadapters. Für jeden Adapter wird kurz das Protokoll beschrieben und eine Referenz auf die zugrundeliegende Spezifikation eingefügt. Außerdem finden Sie detaillierte Angaben zu Parametrierung und Einstellung sowie der benötigten Maschineneinstellungen. Adapter - EAI One V 2.7 V - 1

12 Kapitel V Kapitel 5 EAI One Object Handler Hier finden Sie die kurze Beschreibung der Funktionalität des Object Handlers. Glossar für EAI One Adapter Das Glossar enthält Definitionen der wichtigsten Begriffe der EAI One Software und ihrer Adapter. Diese Begriffe und Definitionen stammen aus den Kapiteln 1 bis 5 sowie aus dem Projekt-Modul Handbuch. Sie wurden im Glossar nochmals zusammengefasst, damit sie leichter gefunden werden können. 2 Fragen, Anmerkungen und Anregungen an das Redaktionsteam Wir aktualisieren unsere Handbücher so oft wie möglich. Wie bei jeder Software entwickelt sich gelegentlich die Software schneller als die Dokumentation. Wenn Sie Fragen, Anmerkungen oder Anregungen für unsere Dokumentation haben, wenden Sie sich bitte an das Redaktionsteam. Senden Sie uns eine doku@eaione.com V - 2 Adapter - EAI One V 2.7

13 Einführung in die EAI One Adapter Adapter werden im Projekt-Modul über Einstellungen parametriert. Jeder Adapter läuft zu einer bestimmten Anwendung. Auch wenn mehrere Adapter des gleichen Typs zu einer Anwendung definiert wurden, muss nur ein Adapter ausgeführt werden, damit alle Adapter gestartet werden. Ein Adapter ist ein Programm, eine ausführbare Datei (.exe). Adapter arbeiten immer mit virtuellen Maschinen zusammen. Virtuelle Maschinen sind Parametrierungen in der Datenbank. Für alle virtuellen Maschinen einer Anwendung, denen der gleiche Adapter zugeordnet ist, wird nur ein Adapter gestartet. Der Adapter benutzt die Einstellungen dieser virtuellen Maschine, um zu kommunizieren. 1 Adaptertypen Adapter werden unterteilt in Applikationsadapter, Protokolladapter und Transportadapter. 1.1 Applikationsadapter Applikationsadapter führen Applikationsdialoge aus. Applikationsdialog umfassen Prozessschritte. Diese Prozessschritte benutzen API s, um über die EAI One Dialogsprache die Standardobjekte in der Fremdapplikation zu verarbeiten. 1.2 Protokolladapter Protokolladapter wandeln externe Nachrichtenformate in das interne EAI One-Nachrichtenformat um. Die Protokolle der Protokolladapter sind standardisierte Nachrichtenformate oder API s, welche für die Kommunikation zwischen Applikationen herangezogen werden. Die Nachrichtenformate basieren größtenteils auf internationalen Standards wie XML, EDIFact usw. Standardobjekten wird als EAI One-interne Protokoll OBJ zugeordnet. 1.3 Transportadapter Transportadapter transportieren Nachrichten ohne sie inhaltlich zu verändern (z.b. Mail, File, SSL). 2 Werkzeuge für den Administrator 2.1 Editor Die Attribute der folgenden Protokolle werden im Editor bearbeitet: XML, SAP RFC, HL/7, SQL, Edifact, SAP IDoc, SAP BAPI Abhängig vom Protokoll werden in den entsprechenden Editoren unterschiedliche Attribute bearbeitet. Weitere Informationen dazu finden Sie in diesem Adapter-Handbuch sowie in den entsprechenden Kapiteln des Projekt-Modul Handbuches. 2.2 Dialog-Editor Der C-API-Adapter und der EAI One-eigene Object Handler werden im Bildschirm AT- TRIBUTE\DIALOGE bearbeitet. Dort gibt es zur Bearbeitung der Dialoge und Prozess- Adapter - EAI One V 2.7 E - 1

14 Kapitel E schritte einen eigenen Editor. Weitere Informationen dazu finden Sie in diesem Adapter-Handbuch sowie EAI One-Handbuch für das Projekt-Modul im Kapitel "Definition von Dialogen". 2.3 Assistent Alle Adapter werden über Assistenten eingestellt, die Sie über die Schaltfläche EINSTEL- LUNGEN aufrufen. Diese Assistenten sollen Ihnen die Arbeit erleichtern, weil alle Möglichkeiten vorgegeben sind. Weitere Informationen dazu finden Sie in diesem Adapter- Handbuch. 2.4 Maschineneinstellungen, Startoptionen, Load- und Ausfall-Balancing Adapter, ihr Verhalten und ihre Beziehung zu den virtuellen Maschinen stellen Sie im Projekt-Modul ein. Weitere Informationen dazu finden Sie im EAI One-Handbuch für das Projekt-Modul. E - 2 Adapter - EAI One V 2.7

15 Physikalische Kommunikation der EAI One Adapter 1 Allgemeine Systemarchitektur einer Fremdapplikation Abbildung 1-1: Schichten zwischen Außenwelt und Fremdapplikation Die EAI One-Adapter kommunizieren direkt mit den Standardschichten einer Fremdapplikation. Sie können direkt auf die Protokollschicht, die Applikationsschicht oder beispielsweise auch auf die Transportschicht zugreifen. 2 Systemarchitektur der Adapter Ein EAI One Adapter ist eine ausführbare Datei. Nach dem Start verbindet sich der Adapter anhand der EAI One Systemeinstellungen mit der EAI One Datenbank. Anhand der übergebenen Referenzinformationen ermittelt der Adapter seine anwendungsspezifische Konfiguration aus der Datenbank. Die Konfiguration bestimmt, welche Kommunikationsein- und -ausgänge der Adapter zur Verfügung stellt und wie er eingehende Daten verarbeiten und weiterversenden soll. 3 Transport der Nachrichten via TCP/IP Socket

16 Kapitel 1 Physikalische Kommunikation der EAI One Adapter 4 Referenzinformationen Die wichtigsten Referenzinformationen, die dem Adapter übergeben werden, sind die Anwendung und die virtuelle Maschine. Damit wird sichergestellt, dass ein Adapter nur einer Anwendung zugeordnet wird. 4.1 Anwendung Der Adapter benutzt die zu seiner Anwendung definierte Parametrierung, um Nachrichten zu verarbeiten. 4.2 Virtuelle Maschine Die virtuelle Maschine des Adapters bestimmt sein Kommunikationsverhalten. Der Adapter stellt die für diese Maschine definierten TCP/IP Serverports zur Verfügung und sendet Daten an die für diese Maschine definierten Ausgangsadressen weiter. Wenn Sie keine Ausgangadresse definieren, wird das Ergebnis des Adapters an den Absender zurückgesendet. Einige Adapter bieten die Möglichkeit, mehrere virtuelle Maschinen parallel laufen zu lassen (Mehrfachausführung). Dabei werden auf dem gewählten Adapter gleichzeitig mehrere virtuelle Maschinen ausgeführt. Durch diese Funktion wird die Speichernutzung optimiert, weil die Parametrierungsdaten nur einmal aufgerufen werden. Nur die virtuellen Maschinen, die zu derselben Anwendung definiert wurden, können auf einem Adapter mehrfach ausgeführt werden. Wieviele Maschinen gleichzeitig auf diesem Adapter gestartet werden können, wird nur durch die Rechnerkapazität begrenzt. 4.3 Eingang und Ausgang der virtuellen Maschine In der Maske VIRTUELLE MASCHINEN werden die physikalischen Eigenschaften, wie z.b. Eingangs- und Ausgangsadresse, Eingangs- und Ausgangsport der Schnittstelle, festgelegt. Die Einstellungen für Eingang und der Ausgang der dem Adapter zugewiesenen virtuellen Maschine bestimmen, von woher der Adapter Daten empfängt und wohin er sie sendet. Dabei können die Adapter sowohl auf demselben physikalischen Rechner laufen als auch verteilt auf unterschiedlichen Rechnern (Intra-/Inter-/Extranet). 4.4 TCP/IP Server Die virtuelle Maschine eines Adapters muss als Server gekennzeichnet sein, damit der Adapter Daten empfangen kann. Dem Adapter muss ein freier TCP/IP Port auf dem Rechner zugewiesen werden, auf dem er ausgeführt werden soll. 4.5 Statische Systemzugriffe Folgende Adapter müssen sich an eine Fremdapplikation anmelden: File, SQL, HTTP, SAP RFC, SAP C-API, SAP BAPI, SAP IDoc. In der Maske VIRTUELLE MASCHINEN\SYSTEMZUGRIFFE werden die Daten festgelegt, die zum Anmelden an eine Fremdapplikation notwendig sind. Die genaue Bedeutung der einzelnen Felder wird in der Beschreibung des Adapters erläutert. 4.6 Datenbank Der Adapter benötigt eine Verbindung zur EAI One Datenbank. 1-2 Adapter - EAI One V 2.7

17 5 Kommunikation Kommunikation findet zwischen Adaptern via TCP/IP-Socket statt. Die Kommunikation zwischen Adaptern und Fremdapplikation richtet sich nach dem jeweiligen Adapter und kann in der Spezifikation des Systemherstellers (z.b. SAP RFC) nachgelesen werden. 5.1 Kommunikation zwischen Adaptern Ein Adapter kann Daten von einem anderen, vorgeschalteten Adapter empfangen. Der Ausgang der virtuellen Maschine des vorgeschalteten Adapters muss entsprechend eingestellt werden. Die IP-Adresse des Rechners, auf dem der empfangende Adapter ausgeführt wird, wird als Adresse angegeben. Der Eingangsport der empfangenden Adapters muss als Ausgangsport des vorgeschalteten Adapters eingestellt werden. 5.2 Kommunikation mit Fremdapplikationen Transport, Protokoll, und Applikationsadapter kommunizieren mit der Fremdapplikation. Abbildung 1-2: Adapter, Protokolle, Fremdapplikation und EAI One 1. Schicht In der 1. Schicht werden die Daten im anwendungsspezifischen Format verarbeitet. Transportadapter steuern den Datenaustausch über besondere Applikations- und Transportprotokolle und leiten die Daten über TCP/IP an Protokolladapter weiter. Die Protokoll- und Applikationsadapter erzeugen aus den Daten Standardobjekte. Diese werden über TCP/IP an den Object Handler kommuniziert. Die Adapter empfangen Standardobjekte über TCP/IP vom Object Handler und kodieren sie wieder in anwendungsspezifische Daten. Adapter - EAI One V

18 Kapitel 1 Physikalische Kommunikation der EAI One Adapter 2.Schicht Der Object Handler verarbeitet EAI One-Standardobjekte, erzeugt Vorgabewerte, nimmt Konvertierungen von Dateninhalten vor und führt besondere Aktionen mit den Daten des Standardobjekts aus. Dabei sollen nicht nur Attribute, sondern auch deren Inhalt standardisiert werden. Aus dem gesamten Prozess ergibt sich das Mapping. Die Daten werden dann über TCP/IP an die Protokoll- und Applikationsadapter weitergeleitet. 6 Parallele Datenverarbeitung Die parallele Datenverarbeitung bestimmt die Anzahl paralleler Prozesse innerhalb eines Adapters, d.h. falls Transaktionen noch nicht abgearbeitet sind, beginnt der Adapter automatisch einen neuen Abarbeitungsprozess. Ist die maximale Anzahl von Verbindungen erreicht, wird jede weitere Verbindungsanfrage so lange abgelehnt bis die maximale Anzahl wieder unterschritten wird. Weitere Informationen dazu finden Sie im EAI One-Handbuch für das Projekt-Modul im Kapitel "Definition von virtuellen Maschinen", Abschnitt "Virtuelle Maschinen definieren" auf Seite Im Bildschirm VIRTUELLE MASCHINEN können Sie die maximale Anzahl von Verbindungen einstellen. 6.1 Failover Failover (Ausfallbalancing) wird ausgeführt, wenn für eine virtuelle Maschine das Failover eingestellt ist und eine technische Kommunikation mit dem nächsten Adapter bzw. der Zieladresse nicht möglich ist. In diesem Fall wird der Verbindungsaufbau zu den zuvor festgelegten Alternativadressen aufgenommen. Bei jeder weiteren Transaktion wird überprüft, ob die Ursprungsadresse wieder verfügbar ist. Weitere Informationen dazu finden Sie im EAI One-Handbuch für das Projekt-Modul im Kapitel "Load Balancing". Sie stellen das Failover mit dem Kontrollkästchen AUSFALL- BALANCING ein. 6.2 Load Balancing Das Load Balancing betrifft die Verbindung zwischen virtuellen Maschinen (Ports), die im Projekt-Modul im LOAD BALANCING-Bildschirm definiert wurden. Wenn Nachrichten bei einer virtuellen Maschine eingehen und abgearbeitet werden müssen, wird dafür eine Verbindung zu der virtuellen Maschine aufgebaut, die die geringste Anzahl von Verbindungen aufweist. Bei gleicher Verbindungsanzahl aller virtuellen Maschinen wird die virtuelle Maschinen gewählt, die im Projekt-Modul entsprechend ihrer Priorität festgelegt ist. 7 Adapter-Verhalten Bei Adaptern unterscheidet man zwischen synchronem und asynchronem Verhalten als technischem Verhalten der Adapter und transaktionalem Verhalten als Prozess-Verhalten. 7.1 Asynchrones Verhalten Für asynchrones Verhalten wird der Adapter zum Zwischenspeichern konfiguriert. Sobald ein Absender eine Nachricht sendet, wird die Nachricht in die EAI One Datenbank gespeichert. Der Absender erhält eine Bestätigung. 1-4 Adapter - EAI One V 2.7

19 Asynchrones Verhalten wird beispielsweise dann eingesetzt, wenn Übertragungs- oder Leitungskosten sehr hoch sind. Weitere Informationen dazu finden Sie EAI One-Handbuch für das Projekt-Modul im Kapitel "Definition von virtuellen Maschinen", Abschnitt "Virtuelle Maschinen definieren" auf Seite Sie stellen das asynchrone Verhalten mit dem Kontrollkästchen ZWISCHENSPEICHERN ein. 7.2 Synchrones Verhalten Das synchrone Verhalten eines Adapters ist als Standard voreingestellt. Sobald ein Absender eine Nachricht sendet, wird diese Nachricht über die Ausgangsadresse an einen weiteren Adapter oder ein Fremdsystem gesendet. Währenddesen wartet der Absender auf eine Antwort. 7.3 Transaktionales Verhalten Mit dem transaktionalem Verhalten wird die Abarbeitung eines Teilprozesses festgelegt. Dazu werden mehrere Adapter synchron hintereinander geschaltet. Bei diesem Verhalten wird nach dem Senden einer Nachricht auf die Antwort des letzten synchron definierten Adapters gewartet. Adapter - EAI One V

20 Kapitel 1 Physikalische Kommunikation der EAI One Adapter 1-6 Adapter - EAI One V 2.7

21 Protokolladapter 1 Protokolladapter unter EAI One EAI One enthält folgende Protokolladapter: XML SAP RFC HL7 SQL EDIFACT EDI SAP IDoc SAP BAPI ASC X12N 2 Systemarchitektur Abbildung 2-1: Protokolladapter - Systemarchitektur Alle Adapter bauen auf der gleichen Adapter-Basisklasse auf. Diese Basisklasse umfasst die gesamte Kommunikation der Adapter. Dabei wird der TCP/IP-Socket als Kommunikationsprotokoll definiert, über das Daten ausgetauscht werden. Außerdem sind Queuing, Retrieval, Scheduling, Load-Balancing und Fail Over-Verhalten sowie Startund Stopp-Prozeduren festgelegt. Diese sieben Vorgänge regeln das Kommunikationsverhalten der Adapter für die jeweilige Situation. Je nach Adaptertyp gehört zu dieser Basisklasse eine andere Adaptertypbasis. Für den Protokolladapter besteht diese Adaptertypbasis aus der Definition der Standardobjekte und Protokolle. Auf Adapter-Basisklasse und Adaptertypbasis setzt eine Ableitung auf, die für den jeweiligen Adapter, z.b. den XML-Protokolladapter, spezifisch ist. Hier werden Standardobjekte und Protokolle empfangen, konvertiert und verarbeitet. Die Kommunikation Adapter - EAI One V

22 Kapitel 2 Protokolladapter erfolgt über TCP/IP. Die Festlegung des Protokolls entscheidet darüber, ob es sich um einen XML-Adapter, einen HL7-Adapter usw. handelt. Die Darstellung der Protokolle, d.h. der Syntaxregeln, ist in den jeweiligen Normen festgelegt. Diese Syntaxregeln und alle weiteren Parameter müssen in EAI One definiert werden. 2.1 Arbeitsrichtung Ein Protokolladapter arbeitet bidirektional. 2.2 Datenempfang Ein Protokolladapter kann EAI One-Standardobjekte oder Nachrichten im eigenen Protokollformat an seinem Eingangsport empfangen und verarbeiten. 2.3 Acknowledgement Empfängt der Adapter ein EAI One-Standardobjekt, dann sendet er als Acknowledgement ein EAI One-Standardobjekt an den Absender zurück. Empfängt der Adapter eine Nachricht im eigenen Protokollformat, dann sendet er als Acknowledgement eine Nachricht im eigenen Protokollformat an den Absender zurück. 2.4 Konvertierung Jeder Protokolladapter hat ein eigenes Protokollformat, z.b. XML. Empfängt der Adapter ein EAI One-Standardobjekt, wandelt er es in Daten seines Protokollformates um und sendet diese an seinen Ausgangsport weiter. Er erwartet eine Nachricht im eigenen Protokollformat als Antwort. Empfängt der Adapter Daten im eigenen Protokollformat, wandelt er sie in ein EAI One- Standardobjekt, um und sendet dieses an seinen Ausgangsport weiter. Er erwartet ein EAI One-Standardobjekt als Antwort Diese Konvertierung erfolgt mittels der Einstellungen und Protokollattribute, die für die Methoden einer Anwendung des Adapters definiert wurden. 2.5 Einstellungen Über die Einstellungen identifiziert der Adapter Nachrichten, die in seinem Protokollformat gesendet werden. Nachdem Nachrichten eingegangen sind, ermittelt der Adapter zuerst das Funktionsobjekt, das der Nachricht zugeordnet ist. Die Einstellungen dieses Funktionsobjekts legen fest, wie der Adapter mit der Nachricht verfahren soll. 2.6 Protokollattribute Die Protokollattribute legen fest, wie die Felder im EAI One-Standardobjekt in das adaptereigene Protokoll gekapselt werden müssen und umgekehrt. Protokollattribute werden im Editor bearbeitet. 2-2 Adapter - EAI One V 2.7

23 1 Allgemeines XML Adapter Standard-Protokolladapter für EAI One Die Extensible Markup Language, abgekürzt XML, beschreibt eine Klasse von Datenobjekten, genannt XML-Dokumente, und teilweise das Verhalten von Computer-Programmen, die solche Dokumente verarbeiten. XML ist ein Anwendungsprofil (application profile) oder eine eingeschränkte Form von SGML, der Standard Generalized Markup Language [ISO 8879]. Durch ihre Konstruktion sind XML-Dokumente konforme SGML-Dokumente. XML-Dokumente sind aus Speicherungseinheiten aufgebaut, genannt Entities, die entweder analysierte (parsed) oder nicht analysierte (unparsed) Daten enthalten. Analysierte Daten bestehen aus Zeichen, von denen einige Zeichendaten und andere Markups darstellen. Markup ist eine Beschreibung der Aufteilung auf Speicherungseinheiten und der logischen Struktur des Dokuments. XML bietet einen Mechanismus an, um Beschränkungen der Aufteilung und logischen Struktur zu formulieren. Ein Software-Modul, genannt XML-Prozessor, dient dazu, XML-Dokumente zu lesen und den Zugriff auf ihren Inhalt und ihre Struktur zu erlauben. Es wird angenommen, dass ein XML-Prozessor seine Arbeit als Teil eines anderen Moduls, genannt Anwendung, erledigt. Diese Spezifikation beschreibt das notwendige Verhalten eines XML- Prozessors soweit es die Frage betrifft, wie er XML-Daten einlesen muss und welche Informationen er an die Anwendung weiterreichen muss. 2 Besondere Funktionalität Jede Prozessor-Definition referenziert ein EAI One Funktionsobjekt. Der Adapter kann in zwei Richtungen arbeiten: 1. Er empfängt EAI One-Standardobjekte und kodiert diese in eine XML-Struktur, die durch das EAI One Funktionsobjekt festgelegt ist. 2. Er empfängt XML-Daten und legt diese in einem EAI One-Standardobjekt ab. Das EAI One-Funktionsobjekt, das den Daten zugeordnet ist, legt das dafür verwendete XML-Standard-Parsing fest. 2.1 Empfang von EAI One Standardobjekten Der Adapter kann aus mehreren Wiederholungen des EAI One-Standardobjekts eine XML-Nachricht mit sich wiederholenden Elementen erzeugen. Nur Elemente, die in den Protokollattributen als wiederholbare Elemente gekennzeichnet sind, werden wiederholt. Einige Daten können nur dann in der XML-Nachricht kodiert werden, wenn die erforderlichen Elemente wiederholbar sind. Daten gehen verloren, wenn die erforderlichen Elemente nicht wiederholbar sind. 2.2 Empfang von XML Daten Der Parser stoppt beim ersten Fehler und bestätigt die Nachricht mit einer Fehlermeldung, wenn die eingehenden XML-Daten nicht wohlgeformt sind. Nicht-wohlgeformte Daten sind keine XML-Daten. Adapter - EAI One V