Mustercode 'SAP call out to a synchronous system' einrichten
Der Mustercode 'SAP call out to a synchronous system' wurde für eine SAP-Ebene mit einer vorhandenen Definition verschiedener SAP-Objekte entwickelt.
Sollten bei der Ausführung des Mustercodes Probleme auftreten, stellen Sie sicher, dass die Definitionen korrekt sind, indem Sie diese Objekte für das lokale SAP-System, auf dem der Mustercode ausgeführt wird, neu generieren.
Sie können diese Aktion ausführen, indem Sie in der Perspektive 'Brokeranwendungsentwicklung' den Adapterverbindungsassistenten verwenden:
- Klicken Sie auf
Datei > Neu > Adapteranschluss und wählen Sie REPLYSAMPLE_SAPAdapter_Tx aus.
- Anweisungen zur weiteren Verwendung des Assistenten finden Sie im Abschnitt
Mustercode 'SAP call out to a synchronous system' erstellen.
In den folgenden Abschnitten wird die Konfigurationseinrichtung beschrieben, die für die Ausführung der Mustercodes erforderlich ist, mit denen die Funktionsweise des SAPInput-Knotens veranschaulicht wird.
- Sie müssen die SAP-Java-Connector-Schnittstellenbibliotheken (SAP-JCo-Schnittstellenbibliotheken) und die JAR-Datei sowie die SAP-IDoc-JAR-Datei für das Adapteranschlussprojekt verfügbar machen, damit die importierten SAP-Mustercodes erfolgreich erstellt werden können:
- Unter Windows:
- Kopieren Sie die Abhängigkeitsbibliothek sapjco3.dll in das lokale Unterverzeichnis C:\SAP_JARS.
- Kopieren Sie die JAR-Datei sapjco3.jar in dasselbe lokale Unterverzeichnis C:\SAP_JARS (die Beispielverweise in diesem Unterverzeichnis).
Zur Verwendung einer anderen Speicherposition lesen Sie Schritt 2.
- Kopieren Sie die JAR-Datei sapidoc3.jar in dasselbe lokale Unterverzeichnis C:\SAP_JARS (die Beispielverweise in diesem Unterverzeichnis).
Zur Verwendung einer anderen Speicherposition lesen Sie Schritt 2.
- Unter Linux:
- Kopieren Sie die Abhängigkeitsbibliothek libsapjco3.so in das lokale Unterverzeichnis /opt/SAP_JARS.
- Kopieren Sie die Datei sapjco3.jar in dasselbe
lokale Unterverzeichnis /opt/SAP_JARS.
- Kopieren Sie die Datei sapidoc3.jar in dasselbe
lokale Unterverzeichnis /opt/SAP_JARS.
- Ändern Sie die Dateiattribute dahingehend, dass Sie Lese- und
Ausführungszugriff auf die Dateien erhalten.
- Optional: Aktualisieren Sie die SAP-JCo- und die IDoc-JAR-Position:
- Importieren Sie den Mustercode.
- Klicken Sie mit der rechten Maustaste auf das Adapteranschlussprojekt 'REPLYSAMPLE_SAPAdapter_Tx', wählen Sie
Eigenschaften > Java Build Path (Java-Erstellungspfad) > Library Tab (Registerkarte 'Bibliothek' aus und geben Sie die korrekte Speicherposition der Datei sapjco3.jar und sapidoc3.jar für das entsprechende Betriebssystem an.
Bei Verwendung des eingehenden Messaging von WebSphere Message Broker müssen Sie das SAP-System so konfigurieren, dass es den Broker auf eindeutige Weise als Zieladresse identifizieren kann.
Erstellen der RFC-Verbindung zwischen SAP-System und Broker:
- Melden Sie sich bei Ihrem SAP-System an.
- Wechseln Sie zur Transaktion SM59: Configuration of RFC connections (Konfiguration von RFC-Verbindungen).
- Klicken Sie auf TCP/IP connections (TCP/IP-Verbindungen) und auf Create (Erstellen).
- Vergewissern Sie sich, dass der Verbindungstyp auf T
gesetzt ist.
- Setzen Sie RFC Destination name (RFC-Zielname) auf
einen geeigneten Wert; beispielsweise auf SAMPSCI. Stellen Sie sicher, dass der Name des RFC-Ziels maximal acht Zeichen umfasst und verwenden Sie diesen Namen überall dort, wo in diesem Mustercode der Name SAMPSCI angegeben ist. Informationen zur Verwendung unterschiedlicher Namen für die folgenden Schritte finden Sie in der Dokumentation zu Ihrem SAP-System. In diesem Mustercode sollten Sie jedoch für alle erstellten Objekte denselben Namen
verwenden.
- Klicken Sie auf der Registerkarte Technical
Settings (Technische Einstellungen) auf
Registered Server Program (Registriertes Serverprogramm).
- Setzen Sie Program ID (Programm-ID) auf denselben
Wert, der im Brokeradapter als Programm-ID angegeben ist. Beispiel:
SAMPSCI.
- Klicken Sie auf Save (Speichern), um die Einstellungen zu speichern.
- Geben Sie im Feld Description 1 (Beschreibung 1)
eine Beschreibung ein. Beispiel: RFC für Mustercode.
- Geben Sie im Feld Description 2 (Beschreibung 2) eine Beschreibung ein. Beispiel:
Ihr Name.
- Klicken Sie auf MDMP & Unicode.
- Wählen Sie Unicode aus.
- Klicken Sie im angezeigten Fenster auf das grüne Häkchen.
- Klicken Sie auf Save (Speichern).
Für die Implementierung von Nachrichtenflüssen mit SAP-Knoten müssen Sie die Laufzeit von WebSphere Message Broker mit den vorausgesetzten SAP-JCo-Bibliotheken konfigurieren. Diese Bibliotheken werden von der zugrunde liegenden SAP-Adapterkomponente verwendet, um Verbindungen zum SAP-System herzustellen.
Sie müssen die folgenden mqsichangeproperties-Befehle in einer Befehlsumgebung
ausführen, um die Adresse der Verzeichnisse festzulegen, die SAP-JCo-Bibliotheken enthalten.
- Führen Sie die folgenden Befehle aus und ändern Sie dabei das
SAP-Clientverzeichnis entsprechend des verwendeten Betriebssystems und der verwendeten Speicherposition:
mqsichangeproperties MB8BROKER -c EISProviders -o SAP -n jarsURL -v C:\SAP_JARS
mqsichangeproperties MB8BROKER -c EISProviders -o SAP -n nativeLibs -v C:\SAP_JARS
- Führen Sie folgenden Befehl aus, um zu prüfen, ob die Eigenschaften richtig konfiguriert sind:
mqsireportproperties MB8BROKER -c EISProviders -o SAP -r
- Stoppen und starten Sie den Broker erneut, indem Sie folgende Befehle verwenden:
mqsistop MB8BROKER
mqsistart MB8BROKER
- Importieren Sie den SAP-Mustercode in Ihren Arbeitsbereich.
- Erweitern Sie das Nachrichtensatzprojekt 'SapInboundSyncCustomerSampleMessageSet'.
- Klicken Sie auf Adapter > Eingehend > SAP.
- Zum Öffnen eines Editors, in dem Sie die erforderlichen Verbindungsparameter für den Zugriff auf Ihr SAP-System angeben können, klicken Sie doppelt auf sapinboundsync.inadapter.
- Geben Sie die folgenden Einstellungen im Editor ein:
- Hostname oder IP-Adresse des Gateways.
- Gateway-Service; beispielsweise sapgw00.
Der Gateway-Service ist mithilfe des Transaktionscodes SMGW (Gateway-Monitor) in der Spalte Remote TP Name (Ferner TP-Name) zu finden.
- RFC-Programm-ID, beispielsweise
SAMPSCI.
- SAP Client ID (SAP-Client-ID) (aus SAP txn
SCC4).
- Benutzername. Der Benutzername für das SAP-System.
- Kennwort. Das Kennwort, das dem Benutzernamen zugeordnet ist.
- Sprachencode. Der Sprachencode bei anderen Sprachen als Englisch.
- Hostname oder IP-Adresse. Der Hostname oder die IP-Adresse des SAP-Anwendungsservers.
- SAP-Systemnummer.
- Speichern Sie den aktualisierten Adapter.
- Erweitern Sie das Nachrichtenbrokerprojekt 'SapInboundSyncCustomerSampleMFlow'.
- Zum Öffnen des Brokerarchiveditors klicken Sie doppelt auf SapInboundSyncCustomerSample.bar.
- Klicken Sie auf die Registerkarte Vorbereiten.
- Klicken Sie auf Brokerarchiv erstellen.
- Speichern Sie das Brokerarchiv.
- Implementieren Sie die BAR-Datei SapInboundSyncCustomerSample.bar in der Brokerausführungsgruppe
SapSample: Klicken Sie mit der rechten Maustaste auf die BAR-Datei und wählen Sie die Implementierungsoption aus oder ziehen Sie die Datei auf die Ausführungsgruppe.
Zurück zum Beginn des
Mustercodes