SQL アダプターの SOAP アクションを構成する

2025-06-05

WCF ベースの SQL アダプターを使用して SQL Server で操作を実行するには、SOAP アクションを指定する必要があります。 SOAP アクションは、実行する必要があるアクションをアダプターと通信します。 SOAP アクションは、Visual Studio または BizTalk Server 管理コンソールから指定できます。ただし、両方の場所から SOAP アクションを指定すると、Visual Studio から指定したアクションがオーバーライドされます。

SOAP アクションの指定の詳細については、「 WCF 送信アダプターの SOAP アクションの指定」を参照してください。

Visual Studio で SOAP アクションを入力する

Visual Studio から、式図形を使用してオーケストレーションの一部として SOAP アクションを指定する必要があります。

BizTalk オーケストレーション内で、BizTalk オーケストレーション ツールボックスから式図形をドラッグして含めます。
[式] 図形をダブルクリックして、BizTalk 式エディターを開きます。
BizTalk の式エディターでアクションを指定してください。例えば次が挙げられます。
```
OutboundMessage(WCF.Action)="TableOp/Insert/dbo/Employee"  
```
式図形と BizTalk 式エディターの詳細については、「式を作成する方法」を参照してください。

BizTalk Server 管理コンソールから SOAP アクションを入力する

BizTalk Server 管理コンソールから、WCF-Custom または WCF-SQL ポート構成の一部として SOAP アクションを指定できます。

WCF-Custom ポートの SOAP アクションを入力する

BizTalk Server 管理コンソールを起動します。
コンソールツリーで、[ BizTalk グループ] を展開し、[ アプリケーション] を展開し、[ 送信ポート] をクリックします。右側のウィンドウで、ポートの作成または既存のポートの選択を選択できます。
[ポートのプロパティ] ダイアログボックスの [ 種類 ] ドロップダウンリストから [ WCF-Custom] を選択し、[ 構成] をクリックします。
[ トランスポートのプロパティのWCF-Custom ] ダイアログボックスで、[ 全般 ] タブをクリックします。
[ アクション ] テキストボックスで、操作の SOAP アクションを指定します。アクションは、次の方法で指定できます。
- 単一アクション形式を使用する。 WCF-Custom ポートが 1 回の操作でメッセージを送受信する場合は、この形式を使用します。例えば次が挙げられます。
```
TableOp/Insert/dbo/Employee  
```
- アクションマッピング形式を使用する。 1 つの WCF-Custom ポートが複数の操作のメッセージを送受信する場合は、この形式を使用します。たとえば、1 つの WCF-Custom ポートが Op1 (Employee テーブルにレコードを挿入する) と Op2 (Employee テーブルのレコードを更新する) のメッセージを送受信する場合、SOAP アクションは次のように指定できます。
```
<BtsActionMapping>  
  <Operation Name="Op1" Action="TableOp/Insert/dbo/Employee" />  
  <Operation Name="Op2" Action="TableOp/Update/dbo/Employee" />  
</BtsActionMapping>  
```
  アクションマッピングアプローチでは、一連のアクションを指定する点で柔軟性が高まるため、異なるアクションの種類に属するメッセージが同じポートを通過できるようになります。
  
  SOAP アクションの形式は、操作ごとに異なります。各操作のアクション形式の詳細については、「メッセージとメッセージスキーマ」を参照してください。

WCF-SQL ポートの SOAP アクションを入力する

BizTalk Server 管理コンソールを起動します。
WCF-SQL アダプターを BizTalk Server 管理コンソールに追加します。手順については、「 BizTalk Server 管理コンソールへの SQL アダプターの追加」を参照してください。
コンソールツリーで、[ BizTalk グループ] を展開し、[ アプリケーション] を展開し、[ 送信ポート] をクリックします。右側のウィンドウで、ポートの作成または既存のポートの選択を選択できます。
[ポートのプロパティ] ダイアログボックスの [ 種類 ] ドロップダウンリストから、先ほど追加した WCF-SQL アダプターを選択し、[ 構成] をクリックします。
[トランスポートのプロパティ] ダイアログボックスで、[ 全般 ] タブをクリックします。
[ アクション ] テキストボックスで、操作の SOAP アクションを指定します。アクションは、次の方法で指定できます。
- 単一アクション形式を使用する。 WCF-SQL ポートが 1 回の操作でメッセージを送受信する場合は、この形式を使用します。例えば次が挙げられます。
```
TableOp/Insert/dbo/Employee  
```
- アクションマッピング形式を使用する。 1 つの WCF-SQL ポートが複数の操作のメッセージを送受信する場合は、この形式を使用します。たとえば、1 つの WCF-SQL ポートが Op1 (Employee テーブルにレコードを挿入する) と Op2 (Employee テーブルのレコードを更新する) のメッセージを送受信する場合、SOAP アクションは次のように指定できます。
```
<BtsActionMapping>  
  <Operation Name="Op1" Action="TableOp/Insert/dbo/Employee" />  
  <Operation Name="Op2" Action="TableOp/Update/dbo/Employee" />  
</BtsActionMapping>  
```
  アクションマッピングアプローチでは、一連のアクションを指定する点で柔軟性が高まるため、異なるアクションの種類に属するメッセージが同じポートを通過できるようになります。
  
  SOAP アクションの形式は、操作ごとに異なります。各操作のアクション形式の詳細については、「メッセージとメッセージスキーマ」を参照してください。

こちらもご覧ください

SQL アダプターを使用して BizTalk アプリケーションを開発するための構成要素