如何配置 WCF-NetMsmq 发送端口

可以通过编程方式或使用 BizTalk 管理控制台配置 WCF-NetMsmq 发送端口。

配置属性

BizTalk 资源管理器对象模型为发送端口公开一个适配器特定的接口，该接口名为 ITransportInfo，并具有 TransportTypeData 读/写属性。 此属性接受一个 WCF-NetMsmq 发送端口配置属性包，该包以 XML 字符串的名称-值对形式存在。

无需 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 发送端口的终结点地址、服务标识和 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 正文 元素的数据选择。 有关“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 适配器上下文属性配置动态发送端口