SAP-Aktivität 'BAPI aufrufen'

Mithilfe der SAP-Aktivität BAPI aufrufen können Sie während der Ausführung eine Geschäftsobjektmethode (BAPI, Business Object Method) aufrufen, die fern am angegebenen SAP-Endpunkt aktiviert wird.

Anmerkung: Zur Einrichtung einer Verbindung von Studio zum SAP-System müssen Sie die SAP-JAR-Dateien und SAP-DLLs herunterladen und auf Ihrem Windows-Entwicklungssystem installieren. Weitere Informationen finden Sie in SAP-JAR-Dateien und DLLs herunterladen und installieren.

SAP-Aktivität 'BAPI aufrufen' in der Orchestrierung hinzufügen

  1. Erstellen oder öffnen Sie eine Orchestrierung. Eine grafische Darstellung der Orchestrierung wird angezeigt.
  2. Wählen Sie die Registerkarte Aktivitäten aus und erweitern Sie den Ordner SAP.
  3. Ziehen Sie die SAP-Aktivität BAPI aufrufen auf die Orchestrierung.
  4. Wählen Sie die Aktivität aus. Die Prüfliste wird angezeigt.

SAP-Endpunkt erstellen, auswählen oder bearbeiten

  1. Klicken Sie auf die Task Endpunkt auswählen in der Prüfliste und wählen Sie eine der folgenden Aktionen aus:
    • Wählen Sie einen vorhandenen Endpunkt aus:
      1. Wählen Sie Durchsuchen aus. Der Projektexplorer wird angezeigt.
      2. Wählen Sie einen vorhandenen Endpunkt aus und klicken Sie auf OK. Fahren Sie mit der Prozedur 'Aktivität konfigurieren' fort.
    • Wählen Sie einen vorhandenen Endpunkt aus und bearbeiten Sie den Endpunkt:
      1. Wählen Sie Durchsuchen aus. Der Projektexplorer wird angezeigt.
      2. Wählen Sie einen vorhandenen Endpunkt aus und klicken Sie auf OK.
      3. Klicken Sie auf Bearbeiten. Das Fenster Endpunkt bearbeiten wird angezeigt.
    • Erstellen Sie einen neuen Endpunkt: Wählen Sie Neu aus. Das Fenster Endpunkt erstellen wird angezeigt.
  2. Erstellen oder bearbeiten Sie einen SAP-Endpunkt.

Aktivität konfigurieren

  1. Wählen Sie die Task Konfigurieren aus der Prüfliste aus. Das Fenster Konfigurieren wird angezeigt.
  2. Klicken Sie im Feld Objektname auf Durchsuchen. Das Dialogfenster BAPI-Liste wird angezeigt.
  3. Suchen Sie nach einem Geschäftsobjekt. Klicken Sie auf ein Geschäftsobjekt in der Liste und geben Sie die Anfangszeichen des Namens des Geschäftsobjekts ein.
  4. Erweitern Sie das Geschäftsobjekt, um die zugeordneten BAPI-Methoden anzuzeigen.
  5. Wählen Sie ein Geschäftsobjekt und eine Methode aus und klicken Sie auf OK.
  6. Wählen Sie eine der folgenden Transaktionsoptionen aus:
    • Keine Aktion ausführen (Transaktion wird von der BAPI direkt verarbeitet): Während der Ausführung führt die Integrationseinheit, die die BAPI aufruft, keine Transaktionsverarbeitung aus. Wenn einer Transaktion eine BAPI zugeordnet ist, muss die BAPI die Transaktion vollständig ausführen.
    • Transaktion nach Beendigung festschreiben: Bei der Ausführung ruft die Integrationseinheit die BAPI auf und wartet auf eine Antwortnachricht vom SAP-System. Der Rückkehrcode der Nachricht, die vom SAP-System zurückgegeben wird, bestimmt, ob die Integrationseinheit eine weitere Nachricht sendet, um anzufordern, dass das SAP-System die Transaktion festschreibt oder rückgängig macht.
      • Wenn der von der BAPI zurückgegebene Rückkehrcode einen Erfolg angibt, sendet die Integrationseinheit eine weitere Nachricht, die anfordert, dass das SAP-System die Transaktion festschreiben soll, und beginnt unverzüglich mit der Verarbeitung der nächsten Aktivität in der Orchestrierung.
      • Wenn der von der BAPI zurückgegebene Rückkehrcode einen Fehler angibt, sendet die Integrationseinheit eine Anforderung zum Rückgängigmachen (Rollback) an das SAP-System und beginnt unverzüglich mit der Verarbeitung der nächsten Aktivität in der Orchestrierung.
    • Transaktion festschreiben und nach Beendigung warten: Während der Ausführung ruft die Integrationseinheit die BAPI auf und wartet auf eine Antwortnachricht vom SAP-System. Der Rückkehrcode der Nachricht, die vom SAP-System zurückgegeben wird, bestimmt, ob die Integrationseinheit eine weitere Nachricht sendet, um anzufordern, dass das SAP-System die Transaktion festschreibt oder rückgängig macht.
      • Wenn der von der BAPI zurückgegebene Rückkehrcode einen Erfolg angibt, sendet die Integrationseinheit eine weitere Nachricht, die anfordert, dass das SAP-System die Transaktion festschreiben soll. Die Orchestrierung wartet, bis das SAP-System eine zweite Nachricht sendet, die angibt, dass die Transaktion festgeschrieben wurde, bevor sie mit der Verarbeitung der nächsten Aktivität in der Orchestrierung beginnt.
      • Wenn der von der BAPI zurückgegebene Rückkehrcode einen Fehler angibt, sendet die Integrationseinheit eine Anforderung zum Rückgängigmachen (Rollback) an das SAP-System. Die Orchestrierung wartet, bis das SAP-System eine zweite Nachricht sendet, die angibt, dass die Transaktion rückgängig gemacht wurde, bevor sie mit der Verarbeitung der nächsten Aktivität in der Orchestrierung beginnt.

Wiederholungsoptionen angeben

  1. Wählen Sie die Task Wiederholung in der Prüfliste aus. Das Fenster Wiederholung wird angezeigt.
  2. Konfigurieren Sie die Wiederholungsoptionen für das Herstellen einer Verbindung zu einem SAP-System. In der folgenden Tabelle werden die Wiederholungsoptionen für die Verbindung zu einem SAP-System beschrieben:
    Wiederholungsoptionen Beschreibung
    1) ___ Sekunden zwischen den einzelnen Wiederholungen warten. Gibt die Dauer (in Sekunden) an, die die Integrationseinheit wartet, bevor sie versucht, eine Verbindung zum SAP-System herzustellen.
    2) Verbindungsherstellung ___ mal versuchen, bevor ein Fehler zurückgegeben wird. Gibt die maximale Anzahl der Male an, die die Integrationseinheit versucht, eine Verbindung zum SAP-System herzustellen, bevor sie einen Fehler ausgibt und die Verarbeitung des aktuellen Orchestrierungsjobs stoppt. Wenn Sie eine Orchestrierung implementieren, die eine SAP-Aktivität BAPI aufrufen enthält, und die Integrationseinheit keine Verbindung zum angegebenen SAP-System herstellen kann, protokolliert die Integrationseinheit die Verbindungsfehler als Warnungen im System- und Orchestrierungsprotokoll, bis die maximale Wiederholungsanzahl erreicht wird. Wenn die Wiederholungsanzahl erreicht wird, protokolliert die Integrationseinheit einen Fehler im System- und Orchestrierungsprotokoll und stoppt die Verarbeitung des aktuellen Orchestrierungsjobs. Wenn Sie zum Beispiel die Wiederholungsanzahl auf den Wert 3 setzen, werden der erste, zweite und dritte Verbindungsfehler als Warnung im Systemprotokoll aufgezeichnet. Die Integrationseinheit protokolliert den vierten Verbindungsfehler als Fehler und stoppt die Verarbeitung des aktuellen Orchestrierungsjobs.

Eingaben der Aktivität zuordnen

  1. Wählen Sie die Task Eingaben zuordnen in der Prüfliste aus. Die aus den Eingabeparametern der BAPI generierten XML-Schemata werden als Knoten unter dem Eingabeparameter request (Anforderung) im Fenster An Aktivität angezeigt. Wenn die BAPI Tabellen enthält, werden außerdem die XML-Schemata, die die Tabellen der BAPI darstellen, als Knoten unter dem Eingabeparameter request (Anforderung) im Fenster An Aktivität angezeigt.
  2. Erstellen Sie eine Zuordnung zwischen Orchestrierungsvariablen und den BAPI-Eingabeparametern und BAPI-Tabellen. Allgemeine Anweisungen zur Zuordnung finden Sie in Zuordnung erstellen.

    Während der Ausführung müssen Werte für obligatorische Elemente der BAPI-Eingabeparameter bzw. -Tabellen angegeben werden. Ein Wert kann angegeben werden, indem ein Standardwert für ein Element eingegeben wird oder indem das Element mit einem Eingabeknoten verknüpft wird. Wenn während der Ausführung kein Wert für ein obligatorisches Element angegeben wird, löst die Aktivität eine Ausnahmebedingung aus, die von der Web Management Console (WMC, Webmanagementkonsole) gemeldet wird. Wenn während der Ausführung kein Wert für ein optionales Element der BAPI-Eingabeparameter oder -Tabellen angegeben wird, wird keine Ausnahmebedingung ausgelöst.

Ausgaben der Aktivität zuordnen

  1. Wählen Sie die Task Ausgaben zuordnen in der Prüfliste aus. Das XML-Schema, das aus den Rückgabetypen der BAPI generiert wird, wird in Form von Knoten unter dem Ausgabeparameter response (Antwort) im Fenster Von Aktivität angezeigt. Wenn die BAPI Tabellen enthält, werden außerdem die XML-Schemata, die die Tabellen darstellen, als Knoten unter dem Knoten response (Antwort) im Fenster Von Aktivität angezeigt.
  2. Erstellen Sie eine Zuordnung zwischen den BAPI-Ausgabeparametern und BAPI-Tabellen und den Orchestrierungsvariablen. Allgemeine Anweisungen zur Zuordnung finden Sie in Zuordnung erstellen.

Anmerkung zur Implementierung einer SAP-Orchestrierung

Bevor Sie eine Orchestrierung mit SAP-Aktivitäten über die Web Management Console (WMC) implementieren können, muss die Integrationseinheit zuerst so eingerichtet werden, dass sie eine Verbindung zum SAP-System herstellen kann. Wenn die Integrationseinheit die Verbindung zum SAP-System nicht herstellen kann, wird die Orchestrierung nicht implementiert.