次の方法で共有

受信場所または送信ポートをプログラムによって作成する

  • [アーティクル]

WCF-BasicHttp 受信場所と送信ポートをプログラムで構成します。 BizTalk 管理コンソールを使用するには、「 WCF-BasicHttp アダプター」を参照してください。

プログラムで受信場所を構成する

BizTalk エクスプローラー オブジェクト モデルにより、プログラムから受信場所を作成および構成することができます。 BizTalk エクスプローラー オブジェクト モデルは、TransportTypeData の読み取り/書き込みプロパティを持つIReceiveLocation 受信場所構成インターフェイスを公開します。 このプロパティでは、名前と値の組の XML 文字列の形式で WCF-BasicHttp 受信場所の構成プロパティ バッグを指定できます。 BizTalk エクスプローラー オブジェクト モデルでこのプロパティを設定するには、IReceiveLocation インターフェイスの InboundTransportLocation プロパティを設定する必要があります。

IReceiveLocation インターフェイスの TransportTypeData プロパティを設定する必要はありません。 このプロパティを設定しない場合、WCF-BasicHttp アダプタでは、次の表に記載されている WCF-BasicHttp 受信場所の構成の既定値が使用されます。

次のコード フラグメントは、BizTalk エクスプローラー オブジェクト モデルを使用して WCF-BasicHttp 受信場所を作成する方法を示しています。

// Use BizTalk Explorer object model to create new WCF-BasicHttp receive location
string server = System.Environment.MachineName;
string database = "BizTalkMgmtDb";
string connectionString = string.Format("Server={0};Database={1};Integrated Security=true", server, database);
string transportConfigData = @"<CustomProps>
  <InboundBodyLocation vt=""8"">UseBodyElement</InboundBodyLocation>
  <UseSSO vt=""11"">0</UseSSO>
  <Identity vt=""8"">
    <identity>
    <userPrincipalName value=""username@contoso.com"" />
    </identity>
  </Identity>
</CustomProps>";
//requires project reference to \Program Files\Microsoft BizTalk Server 2009\Developer Tools\Microsoft.BizTalk.ExplorerOM.dll
BtsCatalogExplorer explorer = new Microsoft.BizTalk.ExplorerOM.BtsCatalogExplorer();
explorer.ConnectionString = connectionString;
// Add a new BizTalk application
Application application = explorer.AddNewApplication();
application.Name = "SampleBizTalkApplication";
// Save
explorer.SaveChanges();
// Add a new one-way receive port
IReceivePort receivePort = application.AddNewReceivePort(false);
receivePort.Name = "SampleReceivePort";
// Add a new one-way receive location
IReceiveLocation receiveLocation = receivePort.AddNewReceiveLocation();
receiveLocation.Name = "SampleReceiveLocation";
// Find a receive handler for WCF-BasicHttp
int i = 0;
for(i=0; i < explorer.ReceiveHandlers.Count; ++i)
{
    if("WCF-BasicHttp" == explorer.ReceiveHandlers[i].TransportType.Name)
        break;
}
receiveLocation.ReceiveHandler = explorer.ReceiveHandlers[i];
receiveLocation.Address = "/samplepath/sampleservice.svc";
receiveLocation.ReceivePipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruReceive"];
receiveLocation.TransportType = explorer.ProtocolTypes["WCF-BasicHttp"];
receiveLocation.TransportTypeData = transportConfigData;
// Save
explorer.SaveChanges();

次の形式を使用して、 で <CustomProps>プロパティを設定できます。

<CustomProps>
  <ServiceCertificate vt="8" />
  <InboundBodyLocation vt="8">UseBodyElement</InboundBodyLocation>
  <UseSSO vt="11">0</UseSSO>
  <MessageClientCredentialType vt="8">UserName</MessageClientCredentialType>
  <InboundBodyPathExpression vt="8" />
  <SendTimeout vt="8">00:01:00</SendTimeout>
  <OutboundXmlTemplate vt="8"><bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/></OutboundXmlTemplate>
  <OpenTimeout vt="8">00:01:00</OpenTimeout>
  <Identity vt="8">
    <identity>
    <userPrincipalName value="username@contoso.com" />
    </identity>
  </Identity>
  <AlgorithmSuite vt="8">Basic256</AlgorithmSuite>
  <SecurityMode vt="8">None</SecurityMode>
  <TransportClientCredentialType vt="8">None</TransportClientCredentialType>
  <MaxReceivedMessageSize vt="3">2097152</MaxReceivedMessageSize>
  <TextEncoding vt="8">utf-8</TextEncoding>
  <CloseTimeout vt="8">00:01:00</CloseTimeout>
  <SuspendMessageOnFailure vt="11">0</SuspendMessageOnFailure>
  <InboundNodeEncoding vt="8">Xml</InboundNodeEncoding>
  <IncludeExceptionDetailInFaults vt="11">0</IncludeExceptionDetailInFaults>
  <MaxConcurrentCalls vt="3">16</MaxConcurrentCalls>
  <MessageEncoding vt="8">Text</MessageEncoding>
  <OutboundBodyLocation vt="8">UseBodyElement</OutboundBodyLocation>
</CustomProps>

次の表に、受信場所に設定できる構成プロパティを示します。

プロパティ名 Type 説明
ID XML Blob

例:

<identity>

<userPrincipalName value="username@contoso.com" />

</Id>		 この受信場所が提供するサービスの ID を指定します。 Identity プロパティに指定できる値は、セキュリティ構成によって異なります。 これらの設定により、クライアントはこの受信場所を認証できます。 クライアントとサービスの間のハンドシェイク プロセスでは、Windows Communication Foundation (WCF) インフラストラクチャによって、この要素の値と予期されるサービスの ID が照合されます。

既定値は空の文字列です。
OpenTimeout System.TimeSpan チャネルを開く操作が完了するまでの間隔を示す期間値を指定します。

既定値:00:01:00
SendTimeout System.TimeSpan 送信操作が完了するまでの間隔を示す期間値を指定します。 要求 - 応答受信ポートを使用する場合、この値は、対話処理がすべて完了するまでの時間を指定します。これは、クライアントが大きなメッセージを返した場合にも適用されます。

既定値:00:01:00
CloseTimeout System.TimeSpan チャネルを閉じる操作が完了するまでの間隔を示す期間値を指定します。

既定値:00:01:00
MaxReceivedMessageSize 整数型 有線ネットワーク上で受信できる、ヘッダーを含むメッセージの最大サイズをバイト単位で指定します。 メッセージのサイズは、各メッセージに割り当てられているメモリの量に制限されます。 このプロパティを使用して、サービス拒否 (DoS) 攻撃にさらされる危険性を制限できます。

WCF-BasicHttp アダプターは、バッファー転送モードの BasicHttpBinding クラスを 利用してエンドポイントと通信します。 バッファーされたトランスポート モードの場合、 BasicHttpBinding.MaxBufferSize プロパティは常にこのプロパティの値と等しくなります。

既定値:65536
MessageEncoding 列挙型

- テキスト - テキスト メッセージ エンコーダーを使用します。
- Mtom - メッセージ送信最適化メカニズム 1.0 (MTOM) エンコーダーを使用します。		 SOAP メッセージをエンコードするために使用されるエンコーダーを指定します。

既定値: Text
TextEncoding 列挙型

- unicodeFFF - Unicode BigEndian エンコード。
- utf-16 - 16 ビット エンコード。
- utf-8 - 8 ビット エンコード		 MessageEncoding プロパティが Text に設定されている場合に、バインディングでメッセージを出力するために使用する文字セット エンコードを指定します。

既定値: utf-8
MaxConcurrentCalls 整数型 単一のサービス インスタンスに対する同時呼び出しの数を指定します。 制限を超える呼び出しはキューに格納されます。 このプロパティの範囲は 1 から Int32.MaxValue です。

既定値:200
SecurityMode 列挙型

- なし
- メッセージ
- トランスポート
- TransportWithMessageCredential
- TransportCredentialOnly

SecurityMode プロパティのメンバー名の詳細については、UI ガイダンスと開発者 API 名前空間リファレンスの「WCF-BasicHttp トランスポート プロパティ] ダイアログ ボックスの [セキュリティ モード] プロパティ、受信、セキュリティ タブを参照してください。		 使用するセキュリティの種類を指定します。

既定値: なし
TransportClientCredentialType TransportClientCredentialType プロパティのメンバー名の詳細については、「UI ガイダンスと開発者 API 名前空間リファレンス」の「WCF-BasicHttp トランスポート プロパティ] ダイアログ ボックスのトランスポート クライアント資格情報の種類プロパティ、受信、セキュリティ タブ」を参照してください。 クライアント認証の実行時に使用する資格情報の種類を指定します。

既定値: なし
MessageClientCredentialType 列挙型

- 名
- 証明 書

MessageClientCredentialType プロパティのメンバー名の詳細については、「UI ガイダンスと開発者 API 名前空間リファレンス」の「WCF-BasicHttp トランスポート プロパティ] ダイアログ ボックスのメッセージ クライアント資格情報の種類プロパティ、受信、セキュリティ タブ」を参照してください。		 メッセージ ベースのセキュリティを使用してクライアント認証を実行するときに使用する、資格情報の種類を指定します。

既定値: UserName
AlgorithmSuite 列挙型

AlgorithmSuite プロパティのメンバー名の詳細については、UI ガイダンスと開発者 API 名前空間リファレンスの「[WCF-BasicHttp トランスポート プロパティ] ダイアログ ボックスの[アルゴリズム スイート] プロパティ、[受信]、[セキュリティ] タブ」を参照してください。		 メッセージの暗号化とキー ラップのアルゴリズムを指定します。 これらのアルゴリズムは、セキュリティ ポリシー言語 (WS-SecurityPolicy) 仕様で指定されたアルゴリズムにマップされます。

既定値: Basic256
ServiceCertificate String クライアントがサービスの認証に使用する、この受信場所に対する X.509 証明書の拇印を指定します。 このプロパティに使用する証明書は、現在のユーザーの場所にある My ストアにインストールする必要があります。 メモ： この受信場所をホストする受信ハンドラーのユーザー アカウントの 現在 のユーザーの場所にサービス証明書をインストールする必要があります。

既定値は空の文字列です。
UseSSO Boolean エンタープライズ シングル サインオン (SSO) を使用して SSO チケットを発行するためにクライアントの資格情報を取得するかどうかを指定します。 SSO をサポートするセキュリティ構成の詳細については、UI ガイダンスと開発者 API 名前空間リファレンスの「WCF-BasicHttp トランスポートのプロパティ] ダイアログ ボックスの「WCF-BasicHttp 受信アダプターのエンタープライズ シングル Sign-On のサポート可能性」、受信、セキュリティ タブのセクションを参照してください。

既定値: False
InboundBodyLocation 列挙型

- UseBodyElement - 受信メッセージの SOAP Body 要素の内容を使用して、BizTalk メッセージ本文パーツを作成します。 Body 要素に複数の子要素がある場合、最初の要素のみが BizTalk メッセージ本文パーツになります。
- UseEnvelope - 受信メッセージの SOAP エンベロープ 全体から BizTalk メッセージ本文部分を作成します。
- UseBodyPath - InboundBodyPathExpression プロパティの本文パス式を使用して、BizTalk メッセージ本文パーツを作成します。 本文パス式は、受信メッセージの SOAP Body 要素の直接の子要素に対して評価されます。 このプロパティは、送信請求 - 応答のポートに対してのみ有効です。

InboundBodyLocation プロパティの使用方法の詳細については、「WCF アダプターのメッセージ本文の指定」を参照してください。		 受信 WCF メッセージの SOAP Body 要素のデータ選択を指定します。

既定値: UseBodyElement
InboundBodyPathExpression String

InboundBodyPathExpression プロパティの使用方法の詳細については、「WCF アダプター のプロパティ スキーマとプロパティ」を参照してください。		 BizTalk メッセージのボディ部を作成するために使用する受信メッセージの特定の部分を示すボディ パス式を指定します。 この本文パス式は、受信メッセージの SOAP Body ノードの直接の子要素に対して評価されます。 このボディ パス式で複数のノードが返される場合は、最初のノードのみが BizTalk メッセージのボディ部に対して選択されます。 InboundBodyLocation プロパティが UseBodyPath に設定されている場合、このプロパティは必須です。

既定値は空の文字列です。
InboundNodeEncoding 列挙型

- Base64 - Base64 エンコード。
- 16 進数 - 16 進エンコード。
- 文字列 - テキスト エンコード - UTF-8
- XML - WCF アダプターは、 InboundBodyPathExpression の本文パス式によって選択されたノードの外部 XML を使用して BizTalk メッセージ本文を作成します。		 inboundBodyPathExpression で指定された本文パス式で識別されるノードをデコードするために、WCF-BasicHttp 受信アダプターが使用するエンコードの種類を指定します。 InboundBodyLocation プロパティが UseBodyPath に設定されている場合、このプロパティは必須です。

既定値: XML
OutboundBodyLocation 列挙型

- UseBodyElement - BizTalk メッセージ本文パーツを使用して、送信応答メッセージの SOAP Body 要素のコンテンツを作成します。
- UseTemplate - OutboundXMLTemplate プロパティで指定されたテンプレートを使用して、送信応答メッセージの SOAP Body 要素のコンテンツを作成します。

OutboundBodyLocation プロパティの使用方法の詳細については、「WCF アダプターのメッセージ本文の指定」を参照してください。		 送信 WCF メッセージの SOAP Body 要素のデータ選択を指定します。 このプロパティは、要求 - 応答の受信場所に対してのみ有効です。

既定値: UseBodyElement
OutboundXMLTemplate String

OutboundXMLTemplate プロパティの使用方法の詳細については、「WCF アダプターのメッセージ本文の指定」を参照してください。		 送信応答メッセージの SOAP Body 要素の内容に XML 形式のテンプレートを指定します。 OutboundBodyLocation プロパティが UseTemplate に設定されている場合は、このプロパティが必要です。 このプロパティは、要求 - 応答の受信場所に対してのみ有効です。

既定値は空の文字列です。
SuspendMessageOnFailure Boolean 受信パイプラインまたはルーティングの障害によって受信処理に失敗した要求メッセージを保留するかどうかを指定します。

既定値: False
IncludeExceptionDetailInFaults Boolean デバッグの目的でクライアントに返される SOAP エラーの詳細にマネージド例外情報を含めるかどうかを指定します。

既定値: False

プログラムで送信ポートを構成する

次のコード フラグメントは、BizTalk エクスプローラー オブジェクト モデルを使用して WCF-BasicHttp 送信ポートを作成する方法を示しています。

// Use BizTalk Explorer object model to create new WCF-BasicHttp send port.
string server = System.Environment.MachineName;
string database = "BizTalkMgmtDb";
string connectionString = string.Format("Server={0};Database={1};Integrated Security=true", server, database);
string transportConfigData = @"<CustomProps>
                                 <StaticAction vt=""8"">http://www.northwindtraders.com/Service/Operation</StaticAction>
                                 <MessageEncoding vt=""8"">Text</MessageEncoding>
                                 <TextEncoding vt=""8"">utf-8</TextEncoding>
                                 <OpenTimeout vt=""8"">00:01:00</OpenTimeout>
                               </CustomProps>";
//requires project reference to \Program Files\Microsoft BizTalk Server 2009\Developer Tools\Microsoft.BizTalk.ExplorerOM.dll
BtsCatalogExplorer explorer = new Microsoft.BizTalk.ExplorerOM.BtsCatalogExplorer();
explorer.ConnectionString = connectionString;
// Add a new BizTalk application
Application application = explorer.AddNewApplication();
application.Name = "SampleBizTalkApplication";
// Save
explorer.SaveChanges();

// Add a new static one-way send port
SendPort sendPort = application.AddNewSendPort(false, false);
sendPort.Name = "SampleSendPort";
sendPort.PrimaryTransport.TransportType = explorer.ProtocolTypes["WCF-BasicHttp"];
sendPort.PrimaryTransport.Address = "http://mycomputer/samplepath";
sendPort.PrimaryTransport.TransportTypeData = transportConfigData; // propertyData; // need to change
sendPort.SendPipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruTransmit"];
// Save
explorer.SaveChanges();

次の形式を使用して、 の <CustomProps>プロパティを設定できます。

<CustomProps>
  <ServiceCertificate vt="8" />
  <InboundBodyLocation vt="8">UseBodyElement</InboundBodyLocation>
  <UseSSO vt="11">0</UseSSO>
  <MessageClientCredentialType vt="8">UserName</MessageClientCredentialType>
  <InboundBodyPathExpression vt="8" />
  <SendTimeout vt="8">00:01:00</SendTimeout>
  <OutboundXmlTemplate vt="8"><bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/></OutboundXmlTemplate>
  <OpenTimeout vt="8">00:01:00</OpenTimeout>
  <AlgorithmSuite vt="8">Basic256</AlgorithmSuite>
  <SecurityMode vt="8">None</SecurityMode>
  <TransportClientCredentialType vt="8">None</TransportClientCredentialType>
  <ClientCertificate vt="8" />
  <ProxyUserName vt="8" />
  <MaxReceivedMessageSize vt="3">2097152</MaxReceivedMessageSize>
  <TextEncoding vt="8">utf-8</TextEncoding>
  <StaticAction vt="8">http://www.northwindtraders.com/Service/Operation</StaticAction>
  <CloseTimeout vt="8">00:01:00</CloseTimeout>
  <ProxyToUse vt="8">Default</ProxyToUse>
  <InboundNodeEncoding vt="8">Xml</InboundNodeEncoding>
  <PropagateFaultMessage vt="11">-1</PropagateFaultMessage>
  <ProxyAddress vt="8" />
  <MessageEncoding vt="8">Text</MessageEncoding>
  <OutboundBodyLocation vt="8">UseBodyElement</OutboundBodyLocation>
</CustomProps>

次の表に、送信ポートに設定できる構成プロパティを示します。

プロパティ名 Type 説明
SecurityMode 列挙型

- なし
- メッセージ
- トランスポート
- TransportWithMessageCredential
- TransportCredentialOnly

SecurityMode プロパティのメンバー名の詳細については、UI ガイダンスと開発者 API 名前空間リファレンスの「WCF-BasicHttp トランスポート プロパティ ダイアログ ボックスのセキュリティ モード プロパティ」の「Send, Security」タブを参照してください。		 使用するセキュリティの種類を指定します。

既定値: なし
MessageClientCredentialType 列挙型

- 名
- 証明 書

MessageClientCredentialType プロパティのメンバー名の詳細については、「UI ガイダンスと開発者 API 名前空間リファレンス」の「WCF-BasicHttp トランスポートプロパティ ダイアログ ボックスのメッセージ クライアント資格情報の種類プロパティ、送信、セキュリティ」タブを参照してください。		 メッセージ ベースのセキュリティを使用してクライアント認証を実行するときに使用する、資格情報の種類を指定します。

既定値: UserName
TransportClientCredentialType 列挙型

- なし
- 基本的な
- Windows
- 証明 書
- ダイジェスト
- Ntlm

TransportClientCredentialType プロパティのメンバー名の詳細については、UI ガイダンスと開発者 API 名前空間リファレンスの「WCF-BasicHttp トランスポートプロパティ ダイアログ ボックスのトランスポート クライアント資格情報の種類プロパティ」を参照してください。		 送信ポート認証の実行時に使用する資格情報の種類を指定します。

既定値: なし
UserName String UseSSO プロパティが False に設定されている場合に、移行先サーバーでの認証に使用するユーザー名を指定します。 このプロパティでは domain\user 形式は使用できません。

既定値は空の文字列です。
パスワード String UseSSO プロパティが False に設定されている場合に、移行先サーバーでの認証に使用するパスワードを指定します。

既定値は空の文字列です。
AffiliateApplicationName String エンタープライズ シングル サインオン (SSO) に使用する関連アプリケーションを指定します。

既定値は空の文字列です。
UseSSO Boolean 接続先のサーバーでの認証でクライアントの資格情報を取得する際に、シングル サインオンを使用するかどうかを指定します。

既定値: False
ClientCertificate String この送信ポートをサービスに対して認証する際に使用する X.509 証明書の拇印を指定します。 ClientCredentialsType プロパティが Certificate に設定されている場合、このプロパティは必須です。 このプロパティに使用する証明書は、現在のユーザーの場所にあるマイ ストアにインストールする必要があります。

既定値は空の文字列です。
ServiceCertificate String この送信ポートのメッセージ送信先のサービスを認証する際に使用する X.509 証明書の拇印を指定します。 このプロパティに使用する証明書は、ローカル コンピューターの場所にある Other People ストアにインストールする必要があります。

既定値は空の文字列です。
ProxyToUse 列挙型

- なし - この送信ポートにはプロキシ サーバーを使用しないでください。
- 既定値 - この送信ポートをホストする送信ハンドラーでプロキシ設定を使用します。
- UserSpecified - ProxyAddress プロパティで指定されたプロキシ サーバーを使用します		 送信 HTTP トラフィックに使用するプロキシ サーバーを指定します。

既定値: なし
ProxyAddress String プロキシ サーバーのアドレスを指定します。 セキュリティ構成に応じて、 https または http スキームを使用します。 このアドレスの後に、コロンとポート番号を指定します。 たとえば、「 http://127.0.0.1:8080 」のように入力します。

既定値は空の文字列です。
ProxyUserName String プロキシに使用するユーザー名を指定します。 WCF-BasicHttp アダプターは、バッファー転送モードの BasicHttpBinding を 利用してエンドポイントと通信します。 BasicHttpBinding のプロキシ資格情報は、セキュリティ モードが Transport、None、または TransportCredentialOnly の場合にのみ適用されます。 SecurityMode プロパティを Message または TransportWithMessageCredential に設定した場合、WCF-BasicHttp アダプターはプロキシに対する認証に ProxyUserName プロパティと ProxyPassword プロパティで指定された資格情報を使用しません。 メモ： WCF-BasicHttp 送信アダプターは、プロキシの基本認証を使用します。

既定値は空の文字列です。
ProxyPassword String プロキシに使用するパスワードを指定します。

既定値は空の文字列です。
InboundBodyLocation 列挙型

- UseBodyElement - 受信メッセージの SOAP Body 要素の内容を使用して、BizTalk メッセージ本文パーツを作成します。 Body 要素に複数の子要素がある場合、最初の要素のみが BizTalk メッセージ本文パーツになります。 このプロパティは、送信請求 - 応答のポートに対してのみ有効です。
- UseEnvelope - 受信メッセージの SOAP エンベロープ 全体から BizTalk メッセージ本文部分を作成します。
- UseBodyPath - InboundBodyPathExpression プロパティの本文パス式を使用して、BizTalk メッセージ本文パーツを作成します。 本文パス式は、受信メッセージの SOAP Body 要素の直接の子要素に対して評価されます。 このプロパティは、送信請求 - 応答のポートに対してのみ有効です。

InboundBodyLocation プロパティの使用方法の詳細については、「WCF アダプターのメッセージ本文の指定」を参照してください。		 受信 WCF メッセージの SOAP Body 要素のデータ選択を指定します。

既定値: UseBodyElement
OutboundBodyLocation 列挙型

- UseBodyElement - BizTalk メッセージ本文パーツを使用して、送信メッセージの SOAP Body 要素のコンテンツを作成します。
- UseTemplate - OutboundXMLTemplate プロパティで指定されたテンプレートを使用して、送信メッセージの SOAP Body 要素のコンテンツを作成します。

OutboundBodyLocation プロパティの使用方法の詳細については、「WCF アダプターのメッセージ本文の指定」を参照してください。		 送信 WCF メッセージの SOAP Body 要素のデータ選択を指定します。

既定値: UseBodyElement
InboundBodyPathExpression String

InboundBodyPathExpression プロパティの使用方法の詳細については、「WCF アダプター のプロパティ スキーマとプロパティ」を参照してください。		 BizTalk メッセージのボディ部を作成するために使用する受信メッセージの特定の部分を示すボディ パス式を指定します。 この本文パス式は、受信メッセージの SOAP Body ノードの直接の子要素に対して評価されます。 このボディ パス式で複数のノードが返される場合は、最初のノードのみが BizTalk メッセージのボディ部に対して選択されます。 InboundBodyLocation プロパティが UseBodyPath に設定されている場合、このプロパティは必須です。 このプロパティは、送信請求 - 応答のポートに対してのみ有効です。

既定値は空の文字列です。
OutboundXMLTemplate String

OutboundXMLTemplate プロパティの使用方法の詳細については、「WCF アダプターのメッセージ本文の指定」を参照してください。		 送信メッセージの SOAP Body 要素のコンテンツに XML 形式のテンプレートを指定します。 OutboundBodyLocation プロパティが UseTemplate に設定されている場合は、このプロパティが必要です。

既定値は空の文字列です。
InboundNodeEncoding 列挙型

- Base64 - Base64 エンコード。
- 16 進数 - 16 進エンコード。
- 文字列 - テキスト エンコード - UTF-8
- XML - WCF アダプターは、 InboundBodyPathExpression の本文パス式によって選択されたノードの外部 XML を使用して BizTalk メッセージ本文を作成します。		 WCF-BasicHttp 送信アダプターが InboundBodyPathExpression で指定された本文パス式で識別されるノードをデコードするために使用するエンコードの種類を指定します。 InboundBodyLocation プロパティが UseBodyPath に設定されている場合、このプロパティは必須です。 このプロパティは、送信請求 - 応答のポートに対してのみ有効です。

既定値: XML
StaticAction String 送信メッセージの SOAPAction HTTP ヘッダー フィールドを指定します。 このプロパティは、メッセージ コンテキスト プロパティ WCF を使用して設定することもできます 。 パイプラインまたはオーケストレーションでのアクション。 この値は、単一アクション形式とアクション マッピング形式の 2 つの異なる方法で指定できます。 このプロパティを 1 つのアクション形式 (例: ) で設定した場合、 http://contoso.com/Svc/Op1送信メッセージの SOAPAction ヘッダーは常に、このプロパティで指定された値に設定されます。

このプロパティをアクション マッピング形式で設定した場合、送信 SOAPAction ヘッダーは BTS によって決定されます 。操作 コンテキスト プロパティ。 たとえば、このプロパティが次の XML 形式と BTS に設定されている場合です。Operation プロパティは Op1 に設定され、WCF 送信アダプターは送信 SOAPAction ヘッダーにを使用http://contoso.com/Svc/Op1します。

<BtsActionMapping>

<Operation Name="Op1" Action="http://contoso.com/Svc/Op1" />

<Operation Name="Op2" Action="http://contoso.com/Svc/Op2" />

</BtsActionMapping>

送信メッセージがオーケストレーション ポートから送信される場合、オーケストレーション インスタンスは BTS を動的に設定します 。ポートの操作 名を持つ Operation プロパティ。 送信メッセージがコンテンツ ベースのルーティングでルーティングされる場合は、BTS を設定できます 。 パイプライン コンポーネントの Operation プロパティ。

既定値は空の文字列です。
MaxReceivedMessageSize 整数型 有線ネットワーク上で受信できる、ヘッダーを含むメッセージの最大サイズをバイト単位で指定します。 メッセージのサイズは、各メッセージに割り当てられているメモリの量に制限されます。 このプロパティを使用して、サービス拒否 (DoS) 攻撃にさらされる危険性を制限できます。

WCF-BasicHttp アダプターは、バッファー転送モードの BasicHttpBinding クラスを 利用してエンドポイントと通信します。 バッファー転送モードの場合、 BasicHttpBinding.MaxBufferSize プロパティは常にこのプロパティの値と等しくなります。

既定値: 65,536
MessageEncoding 列挙型

- テキスト - テキスト メッセージ エンコーダーを使用します。
- Mtom - メッセージ送信組織メカニズム 1.0 (MTOM) エンコーダーを使用します。		 SOAP メッセージをエンコードするために使用されるエンコーダーを指定します。

既定値: Text
TextEncoding 列挙型

- unicodeFFF - Unicode BigEndian エンコード。
- utf-16 - 16 ビット エンコード。
- utf-8 - 8 ビット エンコード		 MessageEncoding プロパティが Text に設定されている場合に、バインディングでメッセージを出力するために使用する文字セット エンコードを指定します。

既定値: utf-8
SendTimeout System.TimeSpan 送信操作が完了するまでの間隔を示す期間値を指定します。 送信請求 - 応答の送信ポートを使用する場合は、サービスから大きいメッセージが返される場合でも、この値には対話処理がすべて完了するまでの時間を指定します。

既定値:00:01:00
OpenTimeout System.TimeSpan チャネルを開く操作が完了するまでの間隔を示す期間値を指定します。

既定値:00:01:00
CloseTimeout System.TimeSpan チャネルを閉じる操作が完了するまでの間隔を示す期間値を指定します。

既定値:00:01:00
AlgorithmSuite 列挙型

AlgorithmSuite プロパティのメンバー名の詳細については、UI ガイダンスと開発者 API 名前空間リファレンスの「[WCF-BasicHttp トランスポート プロパティ] ダイアログ ボックスの [Algorithm suite]\(アルゴリズム スイート\) プロパティ」を参照してください。		 メッセージの暗号化とキー ラップのアルゴリズムを指定します。 これらのアルゴリズムは、セキュリティ ポリシー言語 (WS-SecurityPolicy) 仕様で指定されたアルゴリズムにマップされます。

既定値: Basic256
ID XML Blob

例:

<identity>

<userPrincipalName value="username@contoso.com" />

</Id>		 この送信ポートが必要とするサービスの ID を指定します。 これらの設定により、この送信ポートでサービスを認証できます。 クライアントとサービスの間のハンドシェイク プロセスでは、Windows Communication Foundation (WCF) インフラストラクチャによって、この要素の値と予期されるサービスの ID が照合されます。

既定値は空の文字列です。
PropagateFaultMessage Boolean

- True - 送信処理に失敗したメッセージをサブスクライブしているアプリケーション (別の受信ポートやオーケストレーション スケジュールなど) にルーティングします。
- False - 失敗したメッセージを中断し、否定受信確認 (NACK) を生成します。		 送信処理に失敗したメッセージをルーティングまたは中断するかどうかを指定します。

このプロパティは、送信請求 - 応答のポートに対してのみ有効です。

既定値: True

参照

WCF アダプターとは分離 WCF 受信アダプターを使用した WCF サービスの発行分離 WCF 受信アダプター用の IIS の構成BizTalk ホストとホスト インスタンスの管理 WCF アダプターのサービス アカウントとパスワードの変更方法 WCF アダプターのメッセージ本文を指定する WCF アダプターの証明書をインストールする方法 WCF アダプターのプロパティ スキーマと WCF アダプターコンテキスト プロパティを使用して動的送信ポートを構成するプロパティ