Beispielcode 'SAP call out to a synchronous system' einrichten

Der Beispielcode '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 Beispielcodes Probleme auftreten, stellen Sie sicher, dass die Definitionen korrekt sind, indem Sie diese Objekte für das lokale SAP-System, auf dem der Beispielcode ausgeführt wird, neu generieren. Sie können diese Aktion ausführen, indem Sie in der Perspektive 'Integrationsentwicklung' den Adapterverbindungsassistenten aufrufen:

1. Klicken Sie auf Datei > Neu > Adapteranschluss und wählen Sie REPLYSAMPLE_SAPAdapter_Tx aus.
2. Anweisungen zur weiteren Verwendung des Assistenten finden Sie im Abschnitt Beispielcode 'SAP call out to a synchronous system' erstellen.

In den folgenden Abschnitten wird die Konfigurationseinrichtung beschrieben, die für die Ausführung der Beispielcodes erforderlich ist, mit denen die Funktionsweise des SAPInput-Knotens veranschaulicht wird.

• Suche nach SAP-JCo-Bibliotheken sowie nach der JAR-Datei mit dem Adapteranschlussprojekt ermöglichen
• Beispielcode 'SAP system for the SAP Inbound' konfigurieren
• Integrationsknotenlaufzeit mit SAP-JCo-Bibliotheken konfigurieren
• Verbindungsdetails für SAP-Eingangsadapter konfigurieren

Suche nach SAP-JCo-Bibliotheken sowie nach der JAR-Datei und der SAP IDoc-JAR-Datei mit dem Adapteranschlussprojekt ermöglichen

1. 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-Beispielcodes erfolgreich erstellt werden können:
   • Unter Windows:
     1. Kopieren Sie die Abhängigkeitsbibliothek sapjco3.dll in das lokale Unterverzeichnis C:\SAP_JARS.
     2. 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.
     3. 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:
     1. Kopieren Sie die Abhängigkeitsbibliothek libsapjco3.so in das lokale Unterverzeichnis /opt/SAP_JARS.
     2. Kopieren Sie die Datei sapjco3.jar in dasselbe lokale Unterverzeichnis /opt/SAP_JARS.
     3. Kopieren Sie die Datei sapidoc3.jar in dasselbe lokale Unterverzeichnis /opt/SAP_JARS.
     4. Ändern Sie die Dateiattribute dahingehend, dass Sie Lese- und Ausführungszugriff auf die Dateien erhalten.
2. Optional: Aktualisieren Sie die SAP-JCo- und die IDoc-JAR-Position:
   1. Importieren Sie den Beispielcode.
   2. 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.

Beispielcode 'SAP system for the SAP Inbound' konfigurieren

Bei Verwendung des eingehenden Messaging des Integrationsknotens müssen Sie das SAP-System so konfigurieren, dass es den Integrationsknoten auf eindeutige Weise als Zieladresse identifizieren kann.

Erstellen der RFC-Verbindung zwischen SAP-System und Integrationsknoten:

1. Melden Sie sich bei Ihrem SAP-System an.
2. Wechseln Sie zur Transaktion SM59: Configuration of RFC connections (Konfiguration von RFC-Verbindungen).
3. Klicken Sie auf TCP/IP connections (TCP/IP-Verbindungen) und auf Create (Erstellen).
4. Vergewissern Sie sich, dass der Verbindungstyp auf T gesetzt ist.
5. Setzen Sie RFC Destination name (RFC-Zielname) auf einen geeigneten Wert; beispielsweise auf SAMPSCI. Stellen Sie sicher, dass der Name des RFC-Ziels nicht mehr als acht Zeichen umfasst und verwenden Sie diesen Namen überall dort, wo in diesem Beispielcode 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 Beispielcode sollten Sie jedoch für alle erstellten Objekte denselben Namen verwenden.
6. Klicken Sie auf der Registerkarte Technical Settings (Technische Einstellungen) auf Registered Server Program (Registriertes Serverprogramm).
7. Setzen Sie Program ID (Programm-ID) auf den Wert, der im Integrationsknotenadapter als Programm-ID angegeben ist, z. B. SAMPSCI.
8. Klicken Sie auf Save (Speichern), um die Einstellungen zu speichern.
9. Geben Sie im Feld Description 1 (Beschreibung 1) eine Beschreibung ein. Beispiel: RFC für Beispielcode.
10. Geben Sie im Feld Description 2 (Beschreibung 2) eine Beschreibung ein. Beispiel: Ihr Name.
11. Klicken Sie auf MDMP & Unicode.
12. Wählen Sie Unicode aus.
13. Klicken Sie im angezeigten Fenster auf das grüne Häkchen.
14. Klicken Sie auf Save (Speichern).

Integrationsknotenlaufzeit mit SAP-JCo-Bibliotheken konfigurieren

Für die Implementierung von Nachrichtenflüssen mit SAP-Knoten müssen Sie die Integrationsknotenlaufzeit 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.

1. Führen Sie die folgenden Befehle aus und ändern Sie dabei das SAP-Clientverzeichnis entsprechend des verwendeten Betriebssystems und der verwendeten Speicherposition:

   mqsichangeproperties  IB9NODE -c EISProviders -o SAP -n jarsURL -v C:\SAP_JARS

   mqsichangeproperties IB9NODE -c EISProviders -o SAP -n nativeLibs -v C:\SAP_JARS

2. Führen Sie folgenden Befehl aus, um zu prüfen, ob die Eigenschaften richtig konfiguriert sind:

   mqsireportproperties IB9NODE -c EISProviders -o SAP -r

3. Stoppen Sie den Integrationsknoten und starten Sie ihn erneut, indem Sie folgende Befehle verwenden:

   mqsistop IB9NODE

   mqsistart IB9NODE

Verbindungsdetails für SAP-Eingangsadapter konfigurieren

1. Importieren Sie den SAP-Beispielcode in Ihren Arbeitsbereich.
2. Erweitern Sie das Nachrichtengruppenprojekt 'SapInboundSyncCustomerSampleMessageSet'.
3. Klicken Sie auf Adapter > Eingehend > SAP.
4. 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.
5. Geben Sie die folgenden Einstellungen im Editor ein:
   1. Hostname oder IP-Adresse des Gateways.
   2. 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.
   3. RFC-Programm-ID, beispielsweise SAMPSCI.
   4. SAP Client ID (SAP-Client-ID) (aus SAP txn SCC4).
   5. Benutzername. Der Benutzername für das SAP-System.
   6. Kennwort. Das Kennwort, das dem Benutzernamen zugeordnet ist.
   7. Sprachencode. Der Sprachencode bei anderen Sprachen als Englisch.
   8. Hostname oder IP-Adresse. Der Hostname oder die IP-Adresse des SAP-Anwendungsservers.
   9. SAP-Systemnummer.
6. Speichern Sie den aktualisierten Adapter.
7. Erweitern Sie das Integrationsprojekt 'SapInboundSyncCustomerSampleMFlow'.
8. Zum Öffnen des Brokerarchiveditors klicken Sie doppelt auf SapInboundSyncCustomerSample.bar.
9. Klicken Sie auf die Registerkarte Vorbereiten.
10. Klicken Sie auf Brokerarchiv erstellen.
11. Speichern Sie das Brokerarchiv.
12. Implementieren Sie die BAR-Datei SapInboundSyncCustomerSample.bar auf dem Integrationsserver SapSample: Klicken Sie mit der rechten Maustaste auf die BAR-Datei und wählen Sie die Implementierungsoption aus oder ziehen Sie die Datei auf den Integrationsserver.

Zurück zum Beginn des Beispielcodes