Konfigurieren der SOAP-Aktion für das SAP-System

2025-06-05

Um jeden Vorgang auf dem SAP-System mithilfe des WCF-basierten SAP-Adapters auszuführen, müssen Adapterbenutzer eine SOAP-Aktion angeben. Die SOAP-Aktion kommuniziert mit dem Adapter, welche Aktion ausgeführt werden soll. Sie können die SOAP-Aktion entweder zur Entwurfszeit oder zur Laufzeit angeben. Wenn Sie jedoch die SOAP-Aktion sowohl zur Entwurfszeit als auch zur Laufzeit angeben, wird die aktion, die Sie zur Entwurfszeit angegeben haben, außer Kraft gesetzt.

Weitere Informationen zum Angeben der SOAP-Aktion finden Sie unter Angeben von SOAP-Aktionen für WCF-Sendeadapter.

SOAP-Aktion zur Designzeit eingeben

Zur Entwurfszeit müssen Sie die SOAP-Aktion als Teil der Orchestrierung angeben, indem Sie eine Ausdrucksform einfügen.

Fügen Sie in der BizTalk-Orchestrierung ein Ausdrucks-Shape ein, indem Sie es aus der BizTalk-Orchestration-Toolbox ziehen.
Doppelklicken Sie auf das Ausdruck-Element, um den BizTalk Ausdruckseditor zu öffnen.
Geben Sie die Aktion im BizTalk Expression Editor an. Beispiel:
```
OutboundMessage(WCF.Action)="http://Microsoft.LobServices.Sap/2007/03/Rfc/RFC_CUSTOMER_GET"  
```
Weitere Informationen zum Expression-Shape und dem BizTalk-Ausdrucks-Editor finden Sie unter Wie man Ausdrücke erstellt.

Die SOAP-Aktion zur Laufzeit eingeben

Zur Laufzeit können Sie die SOAP-Aktion als Teil der WCF-Custom- oder WCF-SAP Portkonfiguration angeben.

Geben Sie eine SOAP-Aktion für den WCF-Custom-Port ein.

Starten Sie die BizTalk Server-Verwaltungskonsole.
Erweitern Sie in der Konsolenstruktur die BizTalk-Gruppe, erweitern Sie dann "Anwendungen", und klicken Sie dann auf "Ports senden". Im rechten Bereich können Sie einen Port erstellen oder einen vorhandenen Port auswählen.
Wählen Sie im Dialogfeld "Porteigenschaften" in der Dropdownliste " Typ " die Option "WCF-Custom" aus, und klicken Sie dann auf "Konfigurieren".
Klicken Sie im Dialogfeld WCF-Custom Transporteigenschaften auf die Registerkarte " Allgemein ".
Geben Sie im Textfeld "Aktion " die SOAP-Aktion für den Vorgang an. Sie können die Aktion auf folgende Weise angeben:
- Mithilfe des einfachen Aktionsformats. Verwenden Sie dieses Format, wenn der WCF-Custom Port Nachrichten für einen einzelnen Vorgang sendet und empfängt. Beispiel:
```
http://Microsoft.LobServices.Sap/2007/03/Rfc/RFC_CUSTOMER_GET  
```
- Mithilfe des Aktionszuordnungsformats. Verwenden Sie dieses Format, wenn ein einzelner WCF-Custom Port Nachrichten für mehrere Vorgänge sendet und empfängt. Wenn beispielsweise ein einzelner WCF-Custom Port Nachrichten für Op1 sendet und empfängt (um RFC_CUSTOMER_GET RFC aufzurufen) und Op2 (um BAPI_SALESORDER_CREATEFROMDAT2 BAPI aufzurufen), kann die SOAP-Aktion folgendermaßen angegeben werden:
```
<BtsActionMapping>  
  <Operation Name="Op1" Action="http://Microsoft.LobServices.Sap/2007/03/Rfc/RFC_CUSTOMER_GET " />  
  <Operation Name="Op2" Action="http://Microsoft.LobServices.Sap/2007/03/Bapi/BUS2032/CREATEFROMDAT2/BAPI_SALESORDER_CREATEFROMDAT2" />  
</BtsActionMapping>  
```
  Dieser Ansatz bietet eine größere Flexibilität hinsichtlich der Angabe einer Gruppe von Aktionen und ermöglicht damit nachrichten, die zu verschiedenen Aktionstypen gehören, über denselben Port zu fließen.
  
  Das Format für die SOAP-Aktion unterscheidet sich für jeden Vorgang. Weitere Informationen zum Aktionsformat für jeden Vorgang finden Sie unter Nachrichten und Nachrichtenschemas.

Geben Sie eine SOAP-Aktion für den WCF-SAP-Port ein.

Starten Sie die BizTalk Server-Verwaltungskonsole.
Fügen Sie den WCF-SAP Adapter zur BizTalk Server-Verwaltungskonsole hinzu. Anweisungen finden Sie unter Hinzufügen des SAP-Adapters zur BizTalk Server-Verwaltungskonsole.
Erweitern Sie in der Konsolenstruktur die BizTalk-Gruppe, erweitern Sie dann "Anwendungen", und klicken Sie dann auf "Ports senden". Im rechten Bereich können Sie einen Port erstellen oder einen vorhandenen Port auswählen.
Wählen Sie im Dialogfeld "Porteigenschaften" in der Dropdownliste " Typ " den WCF-SAP Adapter aus, den Sie zuvor hinzugefügt haben, und klicken Sie dann auf "Konfigurieren".
Klicken Sie im Dialogfeld "Transporteigenschaften" auf die Registerkarte " Allgemein ".
Geben Sie im Textfeld "Aktion " die SOAP-Aktion für den Vorgang an. Sie können die Aktion auf folgende Weise angeben:
- Mithilfe des einfachen Aktionsformats. Verwenden Sie dieses Format, wenn der WCF-Custom Port Nachrichten für einen einzelnen Vorgang sendet und empfängt. Beispiel:
```
http://Microsoft.LobServices.Sap/2007/03/Rfc/RFC_CUSTOMER_GET  
```
- Mithilfe des Aktionszuordnungsformats. Verwenden Sie dieses Format, wenn ein einzelner WCF-Custom Port Nachrichten für mehrere Vorgänge sendet und empfängt. Wenn beispielsweise ein einzelner WCF-Custom Port Nachrichten für Op1 sendet und empfängt (um RFC_CUSTOMER_GET RFC aufzurufen) und Op2 (um BAPI_SALESORDER_CREATEFROMDAT2 BAPI aufzurufen), kann die SOAP-Aktion folgendermaßen angegeben werden:
```
<BtsActionMapping>  
  <Operation Name="Op1" Action="http://Microsoft.LobServices.Sap/2007/03/Rfc/RFC_CUSTOMER_GET " />  
  <Operation Name="Op2" Action="http://Microsoft.LobServices.Sap/2007/03/Bapi/BUS2032/CREATEFROMDAT2/BAPI_SALESORDER_CREATEFROMDAT2" />  
</BtsActionMapping>  
```
  Dieser Ansatz bietet eine größere Flexibilität hinsichtlich der Angabe einer Gruppe von Aktionen und ermöglicht damit nachrichten, die zu verschiedenen Aktionstypen gehören, über denselben Port zu fließen.
  
  Das Format für die SOAP-Aktion unterscheidet sich für jeden Vorgang. Weitere Informationen zum Aktionsformat für jeden Vorgang finden Sie unter Nachrichten und Nachrichtenschemas.

Siehe auch

Bausteine zum Erstellen von SAP-Anwendungen