Der Beispielcode 'SAP Connectivity' 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 verwenden: Klicken Sie auf Datei > Neu
> Adapteranschluss und wählen Sie Sample_SAPAdapter_Tx aus.
In den folgenden Abschnitten wird die Konfigurationseinrichtung beschrieben, die für die
Ausführung der Beispielcodes erforderlich ist, mit denen die Funktionsweise des
SAPInput- und SAPRequest-Knotens veranschaulicht wird.
Die importierten SAP-Beispielcodes können erst erfolgreich erstellt werden, wenn die SAP-Java-Connector-Schnittstellenbibliotheken (SAP-JCo-Schnittstellenbibliotheken) und die JAR-Datei sowie die SAP IDoc-JAR-Datei dem Adapteranschlussprojekt zur Verfügung gestellt wurden:
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).
Kopieren Sie die JAR-Datei sapidoc3.jar in dasselbe lokale Unterverzeichnis C:\SAP_JARS (die Beispielverweise in diesem Unterverzeichnis).
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 Speicherposition von SAP JCo und IDoc JAR:
Importieren Sie den Beispielcode.
Klicken Sie mit der rechten Maustaste auf das Adapteranschlussprojekt 'CWYAP_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 die entsprechende Plattform an.
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. SAP erstellt zur Konfiguration dieser Verbindung mehrere Komponenten (RFC-Zieladressen, Ports, Logische Systeme, Verteilungsmodelle und Partnerprofile).
Erstellen der RFC-Verbindung zwischen SAP-System und Integrationsknoten:
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, z. B. SAMPRFC. 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 SAMPRFC angegeben ist. Wenn Sie für die folgenden Schritte unterschiedliche Namen verwenden möchten, finden Sie in der Dokumentation zu Ihrem SAP-System weiter Informationen zur Verwendung unterschiedlicher Namen.
In diesem Beispielcode sollten Sie jedoch für alle erstellten Objekte denselben Namen
verwenden.
Wählen Sie auf der Registerkarte Technical Settings (Technische Einstellungen) die Option
Registered Server Program (Registriertes Serverprogramm) aus.
Setzen Sie Program ID (Programm-ID) auf den Wert, der im
Integrationsknotenadapter als Programm-ID angegeben ist, z. B. SAMPRFC.
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 Beispielcode.
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).
Erstellen eines logischen Systems:
Wechseln Sie zur Transaktion BD54: Change/View
Logical Systems (Logische Systeme ändern/anzeigen).
Klicken Sie im angezeigten Fenster auf das grüne Häkchen, mit der Warnung, dass die Tabelle clientübergreifend ist.
Klicken Sie auf New Entries (Neue Einträge).
Geben Sie im ersten Feld einen Namen für das logische System ein. Beispiel: SAMPRFC.
Geben Sie im zweiten Feld eine Beschreibung für das logische System ein. Beispiel: Logisches System für Beispielcode.
Klicken Sie auf Save (Speichern).
Es wird ein Fenster angezeigt:
Wenn eine Workbench-Anforderungsnummer angezeigt wird, klicken Sie auf das grüne Häkchen.
Wenn keine Nummer angezeigt wird:
Klicken Sie auf Neue Anforderung und geben Sie im Fenster für die Erstellung einer Anforderung eine Beschreibung ein.
Zur Generierung einer Anforderungsnummer klicken Sie auf Speichern.
Klicken Sie auf das grüne Häkchen, um den Vorgang fortzusetzen.
Wechseln Sie zur Transaktion SCC4: Display/view Clients Overview (Client-Übersicht anzeigen/aufrufen)
Klicken Sie doppelt auf den verwendeten Client; beispielsweise auf 001.
Notieren Sie sich auf der nächsten Seite den Eintrag im Feld Logical System (Logisches System). Beispiel: CLNT001.
Erstellen eines Verteilungsmodells:
Wechseln Sie zur Transaktion BD64: Maintenance of Distribution Model (Verwaltung des Verteilungsmodells)
Wechseln Sie durch Drücken der Funktionstaste F9 in den Bearbeitungsmodus.
Klicken Sie auf Create model view (Modellansicht erstellen).
Geben Sie im Feld Short Text (Kurzer Text) eine
Beschreibung ein. Beispiel: Modell für Beispielcode.
Geben Sie einen technischen Namen ein, z. B. SAMPRFC.
Klicken Sie auf das grüne Häkchen.
Wählen Sie den erstellten Eintrag aus und klicken Sie auf Add message type (Nachrichtentyp hinzufügen).
Wählen Sie im Fenster das Feld Absender aus und klicken auf das Symbol neben dem Feld
Absender.
Daraufhin wird ein Fenster mit einer Auswahl logischer Systeme angezeigt. Wählen Sie den Clientnamen aus, den Sie im Schritt 2j in der Transaktion SCC4 notiert haben, z. B. CLNT001.
Klicken Sie auf das grüne Häkchen.
Wählen Sie das Feld Receiver (Empfänger) aus und klicken Sie auf das Symbol neben dem Feld Receiver.
Wählen Sie das logische System aus; das Sie erstellt haben. Beispiel: SAMPRFC. Klicken Sie auf das grüne Häkchen.
Geben Sie im Feld Nachrichtentyp den Nachrichtentyp MATMAS ein (der
IDoc-Typ, der im Beispielcode verwendet wird) und klicken Sie auf das grüne Häkchen.
Klicken Sie im Fenster 'Distribution Model' (Verteilungsmodell) auf Speichern.
Erweitern Sie das erstellte Modell, um Modell, Absender, Empfänger und Nachrichtentyp anzuzeigen.
Wählen Sie den Nachrichtentyp MATMAS aus.
Klicken Sie auf Environment >Generate Partner Profiles (Umgebung > Partnerprofile generieren).
Klicken Sie unter Generate Partner Profile
(Partnerprofil generieren) auf Execute (Ausführen), um
eine Ergebnisanzeige zu generieren.
Überprüfen Sie die generierten Punkte.
Wechseln Sie zur Transaktion WE21: Ports in IDoc processing (Ports in IDoc-Verarbeitung).
Erweitern Sie den Eintrag Ports/Transactional RFC
(Ports/Transaktionsbezogener RFC).
Der neue Port wird am Ende der Liste angezeigt.
Das
Namensformat des Ports lautet ungefähr A0000000xx.
Klicken Sie auf den Port und geben Sie eine Beschreibung ein.
Klicken Sie auf Save (Speichern).
Überprüfen des Partnerprofils:
Wechseln Sie zur Transaktion WE20: Partner profiles (Partnerprofile).
Erweitern Sie den Eintrag Partner Profiles/Partner Type LS (Partnerprofile/Partnertyp LS) und klicken Sie auf den erstellten Partner. Beispiel: SAMPRFC.
Klicken Sie in der Tabelle für abgehende Parameter doppelt auf den Nachrichtentyp
MATMAS.
Ein Fenster mit dem generierten Portnamen (beispielsweise A0000000xx) und dem Basistyp MATMAS05 wird angezeigt.
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.
Führen Sie die folgenden Befehle aus und ändern Sie dabei das
SAP-Clientverzeichnis entsprechend der verwendeten Plattform und 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
Führen Sie folgenden Befehl aus, um zu prüfen, ob die Eigenschaften richtig konfiguriert sind:
mqsireportproperties IB9NODE -c EISProviders -o SAP -r
Stoppen Sie den Integrationsknoten und starten Sie ihn erneut, indem Sie folgende Befehle
verwenden:
Importieren Sie den SAP-Beispielcode in Ihren Arbeitsbereich.
Erweitern Sie das Nachrichtengruppenprojekt 'SapInboundMatMasSampleMSet'.
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 SapMatMasInbound.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 SAMPRFC.
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 Integrationsprojekt 'SapInboundMatMasSampleMFlow'.
Zum Öffnen des Brokerarchiveditors klicken Sie doppelt auf SapInboundMatMasSample.bar.
Klicken Sie auf die Registerkarte Vorbereiten.
Klicken Sie auf Brokerarchiv erstellen.
Speichern Sie das Brokerarchiv.
Implementieren Sie die BAR-Datei SapInboundMatMasSample.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.
Importieren Sie den SAP-Beispielcode in Ihren Arbeitsbereich.
Erweitern Sie das Nachrichtengruppenprojekt 'SapOutboundCustomerMSet'.
Klicken Sie auf Adapter > Abgehend > 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 SapCustomerOutbound.outadapter.
Geben Sie die folgenden Einstellungen im Editor ein:
Benutzername für SAP-System.
Kennwort. Das Kennwort, das dem Benutzernamen zugeordnet ist.
SAP Client ID (SAP-Client-ID).
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 Integrationsprojekt 'SapOutboundCustomerSampleMFlow'.
Zum Öffnen des Brokerarchiveditors klicken Sie doppelt auf SapOutboundCustomerSample.bar.
Klicken Sie auf die Registerkarte Vorbereiten.
Klicken Sie auf Brokerarchiv erstellen.
Speichern Sie das Brokerarchiv.
Implementieren Sie die BAR-Datei SapOutboundCustomerSample.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.