WCF-Custom 受信場所を構成する方法

WCF-Custom 受信場所は、プログラムまたは BizTalk 管理コンソールを使用して構成できます。

構成プロパティ

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

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

次の表に、WCF-Custom 受信場所の BizTalk Explorer オブジェクト モデルで設定できる構成プロパティの一覧を示します。

BizTalk 管理コンソールを使用して WCF-Custom 受信場所を構成する

BizTalk 管理コンソール WCF-Custom 受信場所アダプター変数を設定できます。 受信場所にプロパティが設定されていない場合は、BizTalk 管理コンソールで設定された既定の受信ハンドラー値が使用されます。

WCF-Custom 受信場所の変数を構成する

1. WCF-Custom アダプターを構成するときに、カスタム バインド要素、カスタム動作要素、カスタム チャネル コンポーネントなどの WCF 拡張ポイントを使用する場合は、BizTalk 処理コンピューター (ランタイム コンピューター) と管理コンピューターの両方のグローバル アセンブリ キャッシュに、拡張ポイントとすべての依存アセンブリを実装するアセンブリを追加する必要があります。 さらに、拡張コンポーネントを machine.config ファイルに登録する必要があります。 WCF カスタム アダプターで WCF 拡張ポイントを使用する方法の詳細については、「WCF アダプターで WCF 拡張ポイントを有効にする方法」を参照してください。

2. BizTalk 管理コンソールで、BizTalk Server 管理を展開し、 BizTalk グループを展開し、 アプリケーションを展開し、受信場所を作成するアプリケーションを展開します。

3. BizTalk 管理コンソールの左側のウィンドウで、[ 受信ポート ] ノードをクリックします。 次に、右側のウィンドウで、既存の受信場所に関連付けられている受信ポート、または新しい受信場所に関連付ける受信ポートを右クリックし、[ プロパティ] をクリックします。

4. [ 受信ポートのプロパティ ] ダイアログ ボックスの左側のウィンドウで、[ 受信場所] を選択し、右側のウィンドウで既存の受信場所をダブルクリックするか、[ 新規] をクリックして新しい受信場所を作成します。

5. [受信場所のプロパティ] ダイアログ ボックスの [種類] の横にある [トランスポート] セクションで、ドロップダウン リストから [WCF-Custom] を選択し、[構成] をクリックします。

6. [ WCF-Custom トランスポートのプロパティ ] ダイアログ ボックスの [ 全般 ] タブで、WCF-Custom 受信場所のエンドポイント アドレスとサービス ID を構成します。 「トランスポートのプロパティWCF-Custom」 ダイアログ ボックスの 「全般」 タブの詳細については、「UI ガイダンスと開発者 API 名前空間リファレンス」の 「WCF-Custom トランスポートのプロパティ」ダイアログ ボックスの「全般」、「受信」 タブを参照してください。

7. [ WCF-Custom トランスポートのプロパティ ] ダイアログ ボックスの [ バインド ] タブで、WCF のさまざまな種類の定義済みバインドまたはカスタム バインドを構成します。 [WCF-Custom トランスポートのプロパティ] ダイアログ ボックスの [バインド] タブの詳細については、「UI ガイダンスと開発者 API 名前空間のリファレンス」の「WCF-Custom トランスポートのプロパティ」ダイアログ ボックスの [受信]、[バインド] タブを参照してください。

8. [ WCF-Custom トランスポートのプロパティ ] ダイアログ ボックスの [ 動作 ] タブで、この受信場所のエンドポイントとサービスの動作を構成します。 エンドポイントの動作は、サービスまたはクライアントの機能を変更または拡張する動作拡張要素のセットです。 「動作」 タブについて、「WCF-Custom トランスポートプロパティ」 ダイアログ ボックスの詳細は、「UI ガイダンスと開発者 API 名前空間のリファレンス」の 「WCF-Custom トランスポートプロパティ ダイアログ ボックスの [受信]、[動作]」 タブを参照してください。

9. [トランスポートのプロパティのWCF-Custom] ダイアログ ボックスの [その他] タブで、外部サービスをポーリングするときに使用するこの受信場所の資格情報を構成し、この受信場所がメッセージの処理時にメッセージの順序を保持するかどうかを構成します。 トランスポートプロパティのWCF-Custom ダイアログ ボックスの [その他] タブの詳細については、UI ガイダンスと開発者 API 名前空間リファレンス の WCF-Custom トランスポートプロパティ ダイアログ ボックスの [受信], [その他] タブを参照してください。

10. [ トランスポートのプロパティのWCF-Custom ] ダイアログ ボックスの [ メッセージ ] タブで、SOAP Body 要素のデータ選択を指定します。 [WCF-Custom トランスポートのプロパティ] ダイアログ ボックスの [メッセージ] タブの詳細については、「UI ガイダンスと開発者 API 名前空間リファレンス」の「WCF-Custom トランスポート プロパティ] ダイアログ ボックスの [受信]、[メッセージ] タブを参照してください。

11. [WCF-Custom トランスポートのプロパティ] ダイアログ ボックスの [インポート/エクスポート] タブで、[全般] タブの [アドレス (URI) とエンドポイント ID のプロパティ、バインド] タブのバインド情報、およびこの受信場所の [動作] タブのエンドポイントの動作をインポートおよびエクスポートします。 [WCF-Custom トランスポートのプロパティ] ダイアログ ボックスの [インポート/エクスポート] タブの詳細については、「UI ガイダンスと開発者 API 名前空間リファレンス」の「WCF-Custom トランスポート プロパティ] ダイアログ ボックスの [受信]、[インポート/エクスポート] タブを参照してください。

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

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

<CustomProps>
  <InboundBodyPathExpression vt="8" />
  <InboundBodyLocation vt="8">UseBodyElement</InboundBodyLocation>
  <BindingConfiguration vt="8"><binding name="netNamedPipeBinding"><security mode="None" /></binding></BindingConfiguration>
  <OutboundXmlTemplate vt="8"><bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/></OutboundXmlTemplate>
  <CredentialType vt="8">GetCredentials</CredentialType>
  <Identity vt="8" />
  <ServiceBehaviorConfiguration vt="8"><behavior name="SampleServiceBehavior"><serviceMetadata httpGetEnabled="true" httpGetUrl="http://mycomputer:9995/SampleService/Mex" /><serviceCredentials /></behavior></ServiceBehaviorConfiguration>
  <Password vt="1" />
  <OrderedProcessing vt="11">-1</OrderedProcessing>
  <IncludeExceptionDetailInFaults vt="11">0</IncludeExceptionDetailInFaults>
  <AffiliateApplicationName vt="8">SampleAffiliateApplication</AffiliateApplicationName>
  <DisableLocationOnFailure vt="11">0</DisableLocationOnFailure>
  <SuspendMessageOnFailure vt="11">0</SuspendMessageOnFailure>
  <BindingType vt="8">netNamedPipeBinding</BindingType>
  <UserName vt="8">Hello</UserName>
  <InboundNodeEncoding vt="8">Xml</InboundNodeEncoding>
  <EndpointBehaviorConfiguration vt="8"><behavior name="EndpointBehavior" /></EndpointBehaviorConfiguration>
  <OutboundBodyLocation vt="8">UseBodyElement</OutboundBodyLocation>
</CustomProps>

次のコード フラグメントは、WCF-Custom 受信場所の作成を示しています。

// Use BizTalk Explorer object model to create new WCF-Custom 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>
  <BindingConfiguration vt=""8""><binding name=""netNamedPipeBinding""><security mode=""None"" /></binding></BindingConfiguration>
  <BindingType vt=""8"">netNamedPipeBinding</BindingType>
</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-Custom
int i = 0;
for(i=0; i < explorer.ReceiveHandlers.Count; ++i)
{
    if("WCF-Custom" == explorer.ReceiveHandlers[i].TransportType.Name)
        break;
}
receiveLocation.ReceiveHandler = explorer.ReceiveHandlers[i];
receiveLocation.Address = "net.pipe://mycomputer/samplePipeName";
receiveLocation.ReceivePipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruReceive"];
receiveLocation.TransportType = explorer.ProtocolTypes["WCF-Custom"];
receiveLocation.TransportTypeData = transportConfigData;
// Save
explorer.SaveChanges();

こちらもご覧ください

WCF 受信アダプターのサービス メタデータを公開するBizTalk ホストとホスト インスタンスを管理するサービス アカウントとパスワードを変更する方法WCF アダプターの証明書をインストールするWCF アダプターのメッセージ本文を指定するWCF-Custom アダプターを構成する関連アプリケーションを作成する方法<behavior>の<endpointBehaviors><bindings><behavior>の<serviceBehaviors>