SAP-Connector in Jitterbit Studio

Zusammenfassung

Der SAP-Connector ermöglicht den Zugriff auf SAP ECC Version 6 und höher oder SAP S/4HANA Single-Tenant. SAP R/3 wird nicht unterstützt.

Der SAP-Connector bietet eine Schnittstelle zum Erstellen einer SAP-Verbindung, die als Grundlage für die Generierung von SAP-Aktivitätsinstanzen dient. Diese Aktivitäten interagieren nach der Konfiguration mit SAP über die Verbindung.

Der SAP-Connector wird über die Registerkarte Projektendpunkte und Connectors der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer SAP-Verbindung verwendet. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann zum Erstellen von Aktivitätsinstanzen verwendet, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) dienen sollen.

Zusammen werden eine bestimmte SAP-Verbindung und ihre Aktivitäten als SAP-Endpunkt bezeichnet:

• BAPI: Führt eine Business Application Programming Interface (BAPI)-Funktion in SAP aus und wird als Ziel in einem Vorgang verwendet.

• Receive IDoc: Empfängt ein ausgehendes Intermediate Document (IDoc) von SAP und soll als Quelle in einem Vorgang verwendet werden.

• RFC: Führt einen Remote Function Call (RFC) in SAP aus und soll als Ziel in einem Vorgang verwendet werden.

• IDoc: Sendet ein eingehendes Intermediate Document (IDoc) an SAP und soll als Ziel in einem Vorgang verwendet werden.

Die Lizenzklasse dieses Connectors ist Enterprise, verfügbar als Add-on für Ihr Harmony iPaaS-Abonnement. Um diese zu aktivieren, kontaktieren Sie Ihren Customer Success Manager. Mit diesem Connector erstellte Endpunkte sind in der Endpunktnutzungsberichterstellung enthalten und werden auf Ihre Lizenz angerechnet.

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Bei privaten Agenten können Sie diese Updates mit der Organisationsrichtlinie Disable Auto Connector Update aussetzen.

Die Voraussetzungen für die Verwendung des Connectors und zusätzliche Voraussetzungen für die Verwendung seiner Receive IDoc-Aktivität werden in SAP-Connector-Voraussetzungen beschrieben.

Informationen zu BAPI-, RFC- und IDoc-Schemafeldern finden Sie im SAP-Hilfeportal oder wenden Sie sich an Ihren SAP-Administrator oder SAP-Berater.

Bekannte Probleme

Bei der Konfiguration einer SAP-Aktivität sollten Sie sich dieses aktuellen bekannten Problems bewusst sein:

• Die Bereitstellung ungültiger SAP-Vorgänge ist zulässig

• Zusammenfassung: Operationen, die mehr als eine SAP-Aktivität oder eine SAP-Aktivität zusammen mit einer NetSuite-, Salesforce-, Salesforce Service Cloud-, ServiceMax- oder SOAP-Aktivität enthalten, erscheinen gültig und können ohne Fehler bereitgestellt werden.

• Zusätzliche Informationen: Die Operation schlägt zur Laufzeit fehl.

• Workaround: Befolgen Sie ein gültiges Operationsmuster und verwenden Sie nicht mehr als eine SAP-, NetSuite-, Salesforce-, Salesforce Service Cloud-, ServiceMax- oder SOAP-Aktivität in derselben Operation.

Fehlerbehebung

Falls Probleme mit dem SAP-Connector auftreten, werden folgende Schritte zur Fehlerbehebung empfohlen:

1. Klicken Sie auf die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agent heruntergeladen wird (sofern die Organisationsrichtlinie Disable Auto Connector Update nicht aktiviert ist).

2. Überprüfen Sie die Operationsprotokolle auf Informationen, die während der Ausführung der Operation geschrieben wurden.

3. Aktivieren Sie das Debug-Logging für Operationen (für Cloud-Agents oder für private Agents), um zusätzliche Protokolldateien und Daten zu generieren.

4. Bei Verwendung von privaten Agents können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

5. Aktivieren Sie das ausführliche Logging für Connectors für diesen Connector, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agents einfügen:

   <logger name="org.jitterbit.connector.sap" level="DEBUG"/>

6. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung für Operationen.

   Weitere Informationen zum ausführlichen Logging für Connectors finden Sie unter Ausführliches Logging für Connectors mit privaten Jitterbit-Agents.

7. Informationen zu Problemen und Lösungen speziell für den SAP-Connector finden Sie im Leitfaden Fehlerbehebung für Connectors:

   • Mehrere SAP-Aktivitäten in einer Operation schlagen zur Laufzeit fehl
   • SAP RFC: „Keine RFC-Berechtigung für Funktionsmodul BAPI_TRANSACTION_COMMIT"
   • SAP-Verbindung schlägt mit „Invalid language key" fehl

8. RFC-Aktivität: Falls Sie beim Ausführen einer benutzerdefinierten RFC-Aktivität die Fehlermeldung JCoException occurred No RFC authorization for function module BAPI_TRANSACTION_COMMIT erhalten, führen Sie folgende Schritte aus:

   1. Stellen Sie sicher, dass das RFC-Funktionsmodul BAPI_TRANSACTION_COMMIT remote-aktiviert ist.
   2. Legen Sie in einer der Aktivität vorgelagerten Request-Transformation das Feld BAPI_COMMIT auf true fest.
   3. Überprüfen Sie, dass der in der SAP-Verbindung verwendete SAP-Benutzer die Berechtigung S_RFC für alle zugehörigen Funktionsgruppen hat.

9. IDoc empfangen-Aktivität: Falls Probleme auftreten, werden folgende Schritte zur Fehlerbehebung empfohlen:

   1. Bestätigen Sie, dass die Werte für die Verbindungsfelder Listener Count, Destination und Gateway Service gültig sind, da ungültige Werte für diese Felder zu einem Fehler beim Bereitstellen der Operation oder beim Aktivieren des Listeners führen können.

   2. Deaktivieren Sie den Listener für die Operation, starten Sie die privaten Agents neu und aktivieren Sie den Listener für die Operation erneut.

   Weitere Schritte zur Fehlerbehebung finden Sie unter Fehlerbehebung für Listening-Services.