Voraussetzungen für den SAP Connector

Einführung

Auf dieser Seite werden die Voraussetzungen für den SAP Connector dokumentiert und zusätzliche Voraussetzungen für die Aktivität „IDoc empfangen“.

Voraussetzungen für den SAP Connector

Es ist eine SAP Instanz mit ECC Version 6 oder höher oder SAP S/4HANA Single-Tenant erforderlich. SAP R/3 wird nicht unterstützt.

Zur Verwendung des SAP -Connectors ist Agent-Version 10.1 oder höher erforderlich. Diese Agent-Versionen laden automatisch die neueste Version des Connectors herunter.

Wenn private Agenten verwendet werden, müssen auf ihnen bestimmte von SAP bereitgestellte Bibliotheken installiert sein.

Voraussetzungen für die Aktivität „IDoc empfangen“

Die IDoc-Empfangsaktivität hat zusätzliche Voraussetzungen zusätzlich zu den SAP Connector-Voraussetzungen.

Um die Aktivität IDoc empfangen verwenden zu können, müssen die folgenden Voraussetzungen erfüllt sein:

Das SAP System muss mit den folgenden Elementen konfiguriert werden (die einzelnen Elemente werden weiter unten auf dieser Seite beschrieben):
- RFC-Destination anlegen (Transaktion SM59)
- Einen transaktionalen RFC (tRFC) Port erstellen (Transaktion WE21)
- Geben Sie ein logisches System an (Transaktion BD54)
- Partnerprofil einrichten (Transaktion WE20)
- Konfigurieren Sie das Verteilungsmodell (Transaktion BD64)
Es muss ein privater Agent der Version 11.37 oder höher verwendet werden. Um die Lastausgleichs- und Fehlertoleranzfunktionen des Listening-Dienstes voll nutzen zu können, wird empfohlen, mindestens zwei private Agenten in der Agentengruppe zu haben. Auf dem privaten Agenten müssen bestimmte von SAP bereitgestellte Bibliotheken installiert sein.
Der private Agent muss den Abhördienst aktiviert haben, wie unter Abhördienst auf dem Agenten aktivieren beschrieben.. Dies ist ein manueller Konfigurationsschritt und ist standardmäßig nicht aktiviert.
Sobald eine Operation bereitgestellt ist, muss im Integration Studio Projekt der Listening-Dienst sowohl auf Operation als auch auf Aktivitätsebene aktiviert sein, wie unter Aktivieren des Listening-Dienstes für Operation und Aktivität beschrieben. Dies ist ein manueller Schritt, der während der Projektplanung oder des Projektmanagements durchgeführt wird.

RFC-Destination anlegen

Am SAP Gateway-System muss eine RFC-Destination angelegt werden, damit diese an den transaktionalen RFC- Port(tRFC) angebunden werden kann.

Gehen Sie folgendermaßen vor, um eine RFC-Destination im SAP -System zu erstellen:

Melden Sie sich bei der SAP GUI an.
Geben Sie im Suchfeld den SAP Transaktionscode ein SM59.
Der Bildschirm Konfiguration von RFC-Verbindungen wird angezeigt. Klicken Sie auf die Schaltfläche „Erstellen“ , um ein neues RFC-Ziel zu erstellen:
Der Konfigurationsbildschirm RFC-Ziel wird angezeigt. Schließen Sie die Konfiguration wie folgt ab:
1. Geben Sie im Feld RFC-Ziel einen Namen für das RFC-Ziel ein, z. B. JITTERBIT.
2. Wählen Sie im Feld Verbindungstyp T für TCP/IP-Verbindung aus.
3. Geben Sie in der Beschreibung eine Beschreibung ein, z. B. SAP Destination for Jitterbit.
4. Auf der Tab Technische Einstellungen:
  1. Wählen Sie unter Aktivierungstyp Registriertes Serverprogramm aus.
  2. Geben Sie unter Registriertes Serverprogramm im Feld Programm-ID einen Namen für das Programm ein, das vom SAP -Event-Listener für die Verbindung mit dem SAP -Gateway verwendet werden soll, z. B. JITTERBIT.
5. Speichern Sie die RFC-Destination.
  
  Notiz
  
  Die Schaltfläche Verbindungstest sollte an dieser Stelle der Konfiguration nicht verwendet werden. Bei Verwendung ist ein Fehler zu erwarten. Informationen zum Testen der Verbindung nach Abschluss der gesamten Konfiguration finden Sie unter Konnektivität mit dem SAP Gateway überprüfen am Ende dieser Seite.

Erstellen eines transaktionalen RFC- Port (tRFC)

Der transaktionale RFC- Port (tRFC) ist der logische Port, der von der RFC-Destination für den Informationsaustausch mit der Receive IDoc-Aktivität verwendet wird. Um mit dem SAP -Server kommunizieren zu können, muss auf dem SAP -System ein Port angelegt und mit der RFC-Destination verknüpft werden.

Notiz

Die Aktivität IDoc empfangen verwendet den tRFC- Port sowohl für tRFC- als auch für qRFC-Funktionsaufrufe.

Befolgen Sie diese Schritte, um einen tRFC Port zu erstellen:

Melden Sie sich bei der SAP GUI an.
Geben Sie im Suchfeld den SAP Transaktionscode ein WE21.
Der Bildschirm Ports in IDoc-Verarbeitung wird angezeigt. Wählen Sie den Ordner Transaktionaler RFC und klicken Sie dann auf die Schaltfläche Erstellen:
Der Dialog Ports in der IDoc-Verarbeitung wird angezeigt. Wählen Sie eigener Port und geben Sie den Port für das Programm an, z. B. JITTERBIT:
Vervollständigen Sie im Bildschirm Ports in der IDoc-Verarbeitung für den neuen Port die Konfiguration wie folgt:
1. Geben Sie im Feld Beschreibung eine Beschreibung ein, beispielsweise Jitterbit tRFC Port for Destination JITTERBIT.
2. Unter Version:
  1. Wählen Sie die Version der IDoc-Datensatztypen aus, die über diesen Port ausgetauscht werden sollen.
  2. Geben Sie im Feld RFC-Destination den Namen der RFC-Destination ein, die Sie zuvor definiert haben, z. B. JITTERBIT.
3. Speichern Sie den Port.

Geben Sie ein logisches System an

Vor dem Einrichten eines Partnerprofils muss ein logisches System angegeben werden. Gehen Sie folgendermaßen vor, um ein logisches System anzugeben:

Melden Sie sich bei der SAP GUI an.
Geben Sie im Suchfeld den SAP Transaktionscode ein BD54.
Der Bildschirm Ansicht „Logische Systeme“ ändern: Übersicht wird angezeigt. Klicken Sie auf die Schaltfläche Neue Einträge:
Geben Sie in der Tabelle Logische Systeme in den Tabellenspalten Log.System und Name einen Namen für das logische System ein, beispielsweise JITTERBIT.
Speichern Sie das logische System.

Einrichten eines Partnerprofils

Auf dem SAP -System muss ein Partnerprofil erstellt werden, um die Art der Informationen anzugeben, die mit Jitterbit ausgetauscht werden. Das Partnerprofil gibt die IDoc-Typen an, die von Jitterbit an das SAP -System gesendet werden können (Eingangsparameter) und die IDoc-Typen, die vom SAP System an Jitterbit gesendet werden.

Gehen Sie folgendermaßen vor, um ein Partnerprofil zu erstellen:

Melden Sie sich bei der SAP GUI an.
Geben Sie im Suchfeld den SAP Transaktionscode ein WE20.
Der Bildschirm Partnerprofile wird angezeigt. Klicken Sie auf die Schaltfläche Erstellen.
Schließen Sie im Bildschirm Partnerprofile für das neue Profil die Konfiguration wie folgt ab:
1. Geben Sie im Feld Partner-Nr. den Namen des logischen Systems ein, z. B. JITTERBIT.
2. Geben Sie im Feld Partn. Type ein LS.
3. Gehen Sie auf der Registerkarte Nachbearbeitung: Zugelassene Agenten wie Tab:
  1. Geben Sie im Feld Ty. ein US als Benutzertyp.
  2. Geben Sie im Feld Agent die ID des berechtigten Benutzers ein, z. B. JITTERBIT.
  3. Geben Sie im Feld Sprache ein EN um Englisch als Benachrichtigungssprache zu verwenden.
Klicken Sie unter Outbound Paramtrs. auf die Schaltfläche „Parameter erstellen“ , um so viele Ausgangsparameter wie nötig hinzuzufügen. Der Bildschirm Partnerprofile: Ausgangsparameter wird geöffnet. Führen Sie die Konfiguration für jeden Ausgangsparameter wie folgt durch:
1. Geben Sie im Feld Nachrichtentyp den Typ der zu sendenden Nachricht ein.
2. Gehen Sie auf der Tab Ausgehende Optionen wie folgt vor:
  1. Geben Sie im Feld Port den zuvor definierten Port ein, beispielsweise JITTERBIT.
  2. Wählen Sie unter Ausgabemodus für die meisten Anwendungsfälle IDoc sofort übertragen aus. Wählen Sie je nach Anwendungsfall weitere Optionen aus.
  3. Geben Sie unter IDoc-Typ die Informationen für den zu sendenden IDoc-Typ ein.
3. Speichern Sie den Ausgangsparameter.
Klicken Sie unter Eingehende Parameter auf die Schaltfläche „Parameter erstellen“ , um so viele eingehende Parameter wie nötig hinzuzufügen. Der Bildschirm Partnerprofile: Eingehende Parameter wird geöffnet. Führen Sie die Konfiguration für jeden eingehenden Parameter wie folgt durch:
1. Geben Sie im Feld Partnerrolle ein LS für logisches System.
2. Geben Sie im Feld Nachrichtentyp den Typ der Nachricht ein, die empfangen werden soll.
3. Geben Sie auf der Tab Eingangsoptionen den Prozesscode für den Funktionsbaustein ein, der das empfangene IDoc verarbeiten soll.
4. Speichern Sie die eingehenden Parameter.

Konfigurieren des Verteilungsmodells

Das Verteilungsmodell muss für den IDoc-Nachrichtentyp konfiguriert werden, der von der IDoc empfangen-Aktivität empfangen wird.

Befolgen Sie diese Schritte, um das Verteilungsmodell zu konfigurieren:

Melden Sie sich bei der SAP GUI an.
Geben Sie im Suchfeld den SAP Transaktionscode ein BD64.
Wählen Sie das zentrale logische System aus.
Klicken Sie auf Nachrichtentyp hinzufügen und geben Sie den Nachrichtentyp ein, der empfangen werden soll. Speichern Sie anschließend.
Wiederholen Sie den Vorgang bei Bedarf, um alle Nachrichtentypen hinzuzufügen:

Überprüfen der Konnektivität mit dem SAP Gateway

Die Konnektivität wird voraussichtlich erst hergestellt, wenn alle Konfigurationsschritte sowohl im SAP System (auf dieser Seite beschrieben), als auch in der SAP Connector-Verbindung und IDoc empfangen Aktivität.

Sobald diese Konfigurationsschritte abgeschlossen sind, kann ein SAP Administrator die Verbindung des konfigurierten RFC-Ziels im SAP -System testen, um zu überprüfen, ob die Konnektivität zwischen dem SAP -Gateway und dem Listening-Dienst von Jitterbit hergestellt wurde.

So testen Sie die Verbindung der RFC-Destination:

Melden Sie sich bei der SAP GUI an.
Geben Sie im Suchfeld den SAP Transaktionscode ein SM59.
Erweitern Sie in der Spalte RFC-Verbindungen die Option TCP/IP-Verbindungen und doppelklicken Sie, um den RFC-Zielnamen zu öffnen.
Klicken Sie auf die Schaltfläche Verbindungstest, um die Verbindung zwischen dem SAP Gateway und dem Listening-Dienst von Jitterbit zu überprüfen: