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
- Erstellen oder öffnen Sie eine
Orchestrierung. Eine grafische Darstellung der Orchestrierung wird angezeigt.
- Wählen Sie die Registerkarte Aktivitäten aus und erweitern Sie den Ordner SAP.
- Ziehen Sie die SAP-Aktivität BAPI aufrufen auf die Orchestrierung.
- Wählen Sie die Aktivität aus. Die Prüfliste wird angezeigt.
SAP-Endpunkt erstellen, auswählen oder bearbeiten
- 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:
- Wählen Sie Durchsuchen aus. Der Projektexplorer wird angezeigt.
- 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:
- Wählen Sie Durchsuchen aus. Der Projektexplorer wird angezeigt.
- Wählen Sie einen vorhandenen Endpunkt aus und klicken Sie auf OK.
- 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.
- Erstellen oder bearbeiten Sie einen SAP-Endpunkt.
Aktivität konfigurieren
- Wählen Sie die Task Konfigurieren aus der Prüfliste aus.
Das Fenster Konfigurieren wird angezeigt.
- Klicken Sie im Feld Objektname auf Durchsuchen.
Das Dialogfenster BAPI-Liste wird angezeigt.
- 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.
- Erweitern Sie das Geschäftsobjekt, um die zugeordneten BAPI-Methoden anzuzeigen.
- Wählen Sie ein Geschäftsobjekt und eine Methode aus und klicken Sie auf OK.
- 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
- Wählen Sie die Task Wiederholung in der Prüfliste aus.
Das Fenster Wiederholung wird angezeigt.
- 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
- 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.
- 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
- 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.
- 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.