Konfigurieren der SOAP-Aktion für den SQL-Adapter

Artikel
07/21/2023

Zum Ausführen eines Beliebigen Vorgangs auf SQL Server mithilfe des WCF-basierten SQL-Adapters müssen Sie eine SOAP-Aktion angeben. Die SOAP-Aktion teilt dem Adapter mit, welche Aktion ausgeführt werden soll. Sie können die SOAP-Aktion entweder in Visual Studio oder in der BizTalk Server-Verwaltungskonsole angeben. Wenn Sie jedoch die SOAP-Aktion an beiden Speicherorten angeben, wird die von Ihnen in Visual Studio angegebene Aktion überschrieben.

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

Geben Sie die SOAP-Aktion in Visual Studio ein.

In Visual Studio müssen Sie die SOAP-Aktion als Teil der Orchestrierung angeben, indem Sie ein Ausdrucks-Shape verwenden.

Fügen Sie in die BizTalk-Orchestrierung ein Ausdrucks-Shape ein, indem Sie es aus der BizTalk Orchestration-Toolbox ziehen.
Doppelklicken Sie auf das Ausdrucks-Shape , um den BizTalk-Ausdrucks-Editor zu öffnen.
Geben Sie die Aktion im BizTalk-Ausdrucks-Editor an. Beispiel:
```
OutboundMessage(WCF.Action)="TableOp/Insert/dbo/Employee"  
```
Weitere Informationen zum Ausdrucks-Shape und zum BizTalk-Ausdrucks-Editor finden Sie unter Erstellen von Ausdrücken.

Geben Sie die SOAP-Aktion über die BizTalk Server-Verwaltungskonsole ein.

In der BizTalk Server-Verwaltungskonsole können Sie die SOAP-Aktion als Teil der WCF-Custom- oder WCF-SQL-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, 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-Benutzerdefinierte Transporteigenschaften auf die Registerkarte Allgemein .
Geben Sie im Textfeld Aktion die SOAP-Aktion für den Vorgang an. Sie können die Aktion wie folgt angeben:
- Mithilfe des einzelnen Aktionsformats. Verwenden Sie dieses Format, wenn der WCF-Custom Port Nachrichten für einen einzelnen Vorgang sendet und empfängt. Beispiel:
```
TableOp/Insert/dbo/Employee  
```
- 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 (zum Einfügen von Datensätzen in die Tabelle Mitarbeiter) und Op2 (zum Aktualisieren von Datensätzen in der Tabelle Mitarbeiter) sendet und empfängt, kann die SOAP-Aktion wie folgt angegeben werden:
```
<BtsActionMapping>  
  <Operation Name="Op1" Action="TableOp/Insert/dbo/Employee" />  
  <Operation Name="Op2" Action="TableOp/Update/dbo/Employee" />  
</BtsActionMapping>  
```
  Der Aktionszuordnungsansatz bietet mehr Flexibilität in Bezug auf die Angabe einer Reihe von Aktionen und ermöglicht daher nachrichten, die zu verschiedenen Aktionstypen gehören, denselben Port zu durchlaufen.
  
  Das Format für die SOAP-Aktion ist für jeden Vorgang unterschiedlich. Weitere Informationen zum Aktionsformat für die einzelnen Vorgänge finden Sie unter Nachrichten und Nachrichtenschemas.

Eingeben einer SOAP-Aktion für den WCF-SQL-Port

Starten Sie die BizTalk Server-Verwaltungskonsole.
Fügen Sie den WCF-SQL-Adapter zur BizTalk Server-Verwaltungskonsole hinzu. Anweisungen finden Sie unter Hinzufügen des SQL-Adapters zu BizTalk Server Verwaltungskonsole.
Erweitern Sie in der Konsolenstruktur Die BizTalk-Gruppe, 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-SQL-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 wie folgt angeben:
- Mithilfe des einzelnen Aktionsformats. Verwenden Sie dieses Format, wenn der WCF-SQL-Port Nachrichten für einen einzelnen Vorgang sendet und empfängt. Beispiel:
```
TableOp/Insert/dbo/Employee  
```
- Mithilfe des Aktionszuordnungsformats. Verwenden Sie dieses Format, wenn ein einzelner WCF-SQL-Port Nachrichten für mehrere Vorgänge sendet und empfängt. Wenn beispielsweise ein einzelner WCF-SQL-Port Nachrichten für Op1 (zum Einfügen von Datensätzen in die Tabelle Employee) und Op2 (zum Aktualisieren von Datensätzen in der Tabelle Employee) sendet und empfängt, kann die SOAP-Aktion wie folgt angegeben werden:
```
<BtsActionMapping>  
  <Operation Name="Op1" Action="TableOp/Insert/dbo/Employee" />  
  <Operation Name="Op2" Action="TableOp/Update/dbo/Employee" />  
</BtsActionMapping>  
```
  Der Aktionszuordnungsansatz bietet mehr Flexibilität in Bezug auf die Angabe einer Reihe von Aktionen und ermöglicht daher nachrichten, die zu verschiedenen Aktionstypen gehören, denselben Port zu durchlaufen.
  
  Das Format für die SOAP-Aktion ist für jeden Vorgang unterschiedlich. Weitere Informationen zum Aktionsformat für die einzelnen Vorgänge finden Sie unter Nachrichten und Nachrichtenschemas.

Weitere Informationen

Bausteine zum Entwickeln von BizTalk-Anwendungen mit dem SQL-Adapter

Freigeben über