WCF-NetMsmq 送信ポートを構成する方法

WCF-NetMsmq 送信ポートは、プログラムから、または BizTalk 管理コンソールを使用して構成できます。

構成プロパティ

BizTalk エクスプローラー オブジェクト モデルは、TransportTypeData の読み取り/書き込みプロパティを持つ ITransportInfo という名前の送信ポート用のアダプター固有のインターフェイスを公開します。 このプロパティでは、名前と値の組の XML 文字列の形式で WCF-NetMsmq 送信ポートの構成プロパティ バッグを指定できます。

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

次の表に、BizTalk エクスプローラ オブジェクト モデルで WCF-NetMsmq 送信ポート用に設定できる構成プロパティを示します。

BizTalk 管理コンソールを使用して WCF-NetMsmq 送信ポートを構成する

BizTalk 管理コンソールで、WCF-NetMsmq 送信ポート アダプタの変数を設定できます。 送信ポートのプロパティが設定されていない場合は、上の表に記載されている WCF-NetMsmq 送信ポートの構成の既定値が使用されます。

WCF-NetMsmq 送信ポートの変数を構成する

1. BizTalk 管理コンソールで、新しい送信ポートを作成するか、既存の送信ポートをダブルクリックして変更します。 詳細については、「 送信ポートを作成する方法」を参照してください。 すべての送信ポート オプションを構成し、UI ガイダンスと開発者 API 名前空間リファレンスの [全般] タブの [トランスポート] セクションの [種類] オプションに WCF-NetMsmq を指定します。

2. [ 全般 ] タブの [ トランスポート ] セクションで、[種類] の横にある [構成 ] ボタンをクリック します。

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

4. [ WCF-NetMsmq トランスポートのプロパティ ] ダイアログ ボックスの [ バインド ] タブで、タイムアウトとトランザクションのプロパティとキューの設定を構成します。 [WCF-NetMsmq トランスポートのプロパティ] ダイアログ ボックスの [バインド] タブの詳細については、UI ガイダンスと開発者 API 名前空間リファレンスの「WCF-NetMsmq トランスポートのプロパティ] ダイアログ ボックスの [送信]、[バインド] タブ」を参照してください。

5. [ WCF-NetMsmq トランスポートのプロパティ ] ダイアログ ボックスの [ セキュリティ ] タブで、WCF-NetMsmq 送信ポートのセキュリティ機能を定義します。 [WCF-NetMsmq トランスポートのプロパティ] ダイアログ ボックスの [セキュリティ] タブの詳細については、UI ガイダンスと開発者 API 名前空間リファレンスの「WCF-NetMsmq トランスポートのプロパティ] ダイアログ ボックスの [送信]、[セキュリティ] タブ」を参照してください。

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

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

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

<CustomProps>  
  <ServiceCertificate vt="8" />  
  <UseSSO vt="11">0</UseSSO>  
  <CloseTimeout vt="8">00:01:00</CloseTimeout>  
  <MessageClientCredentialType vt="8">Windows</MessageClientCredentialType>  
  <SendTimeout vt="8">00:01:00</SendTimeout>  
  <OutboundXmlTemplate vt="8"><bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/></OutboundXmlTemplate>  
  <MsmqProtectionLevel vt="8">Sign</MsmqProtectionLevel>  
  <OpenTimeout vt="8">00:01:00</OpenTimeout>  
  <UseSourceJournal vt="11">0</UseSourceJournal>  
  <AlgorithmSuite vt="8">Basic256</AlgorithmSuite>  
  <SecurityMode vt="8">Transport</SecurityMode>  
  <CustomDeadLetterQueue vt="8" />  
  <ClientCertificate vt="8" />  
  <MsmqEncryptionAlgorithm vt="8">RC4Stream</MsmqEncryptionAlgorithm>  
  <StaticAction vt="8">http://www.northwindtraders.com/Service/Operation</StaticAction>  
  <MsmqSecureHashAlgorithm vt="8">Sha1</MsmqSecureHashAlgorithm>  
  <EnableTransaction vt="11">-1</EnableTransaction>  
  <TimeToLive vt="8">1.00:00:00</TimeToLive>  
  <MsmqAuthenticationMode vt="8">WindowsDomain</MsmqAuthenticationMode>  
  <DeadLetterQueue vt="8">System</DeadLetterQueue>  
  <OutboundBodyLocation vt="8">UseBodyElement</OutboundBodyLocation>  
</CustomProps>  

次のコードは、WCF-NetMsmq 送信ポートの作成方法を示しています。

// Use BizTalk Explorer object model to create new WCF-NetMsmq 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>  
                                 <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-NetMsmq"];  
sendPort.PrimaryTransport.Address = "net.msmq://mycomputer/private/samplequeue";  
sendPort.PrimaryTransport.TransportTypeData = transportConfigData; // propertyData; // need to change  
sendPort.SendPipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruTransmit"];  
// Save  
explorer.SaveChanges();  

参照

WCF アダプター プロパティ スキーマおよびプロパティ
WCF アダプターの証明書のインストール
WCF アダプターのメッセージ本文の指定
WCF-NetMsmq アダプターの構成
WCF アダプター コンテキスト プロパティによる動的送信ポートの構成