如何配置 WCF-Custom 接收位置
可以通过编程方式或使用 BizTalk 管理控制台来配置 WCF-Custom 接收位置。
配置属性
使用 BizTalk 浏览器对象模型，您可以通过编程方式创建和配置接收位置。 BizTalk 资源管理器对象模型公开具有 TransportTypeData 读/写属性的IReceiveLocation 接收位置配置接口。 此属性以 XML 字符串的名称-值对形式接受 WCF-Custom 接收位置配置属性包。 若要在 BizTalk 资源管理器对象模型中设置此属性，必须设置 IReceiveLocation 接口的 InboundTransportLocation 属性。
无需设置 IReceiveLocation 接口的 TransportTypeData 属性。 如果未设置该属性，则 WCF-Custom 适配器将使用 WCF-Custom 接收位置配置的默认值，如下表所示。
下表列出了可在 BizTalk 浏览器对象模型中为 WCF-Custom 接收位置设置的配置属性：
| 属性名称 | 类型 | 说明 |
|---|---|---|
| 标识 | XML Blob 例如： <identity> <userPrincipalName value=“username@contoso.com” /> </身份> |
指定此接收位置提供的服务的标识。 可以为 Identity 属性指定的值因安全配置而异。 通过这些设置，客户端可对此接收位置进行验证。 在客户端与服务进行握手的过程中，Windows Communication Foundation (WCF) 基础结构将确保预期服务的标识与此元素的值保持一致。 默认值为空字符串。 |
| BindingType | 枚举 - basicHttpBinding - customBinding - mexHttpBinding - mexHttpsBinding - mexNamedPipeBinding - mexTcpBinding - netMsmqBinding - netNamedPipeBinding - netPeerTcpBinding - netTcpBinding - wsDualHttpBinding - wsFederationHttpBinding - wsHttpBinding |
指定此接收位置使用的终结点所采用的绑定类型。 注意： 如果使用自定义绑定，可以使用自定义绑定配置 BindingType 属性。 有关如何使用自定义绑定的详细信息，请参阅 如何使用 WCF 适配器启用 WCF 扩展点。 默认值为空字符串。 |
| BindingConfiguration | XML Blob 例如： <binding name=“netNamedPipeBinding”><security mode=“None” /></binding> |
指定包含绑定>元素的< XML 字符串，以配置 Windows Communication Foundation (WCF) 提供的不同类型的预定义绑定。 有关系统提供的绑定和自定义绑定的详细信息，请参阅“另请参见”部分中的相应主题。 注意：BizTalk Server不支持可以使用 BindingConfiguration 属性配置的所有类型的绑定扩展元素。 默认值为空字符串。 |
| ServiceBehaviorConfiguration | XML Blob 例如： <behavior name=“SampleServiceBehavior”><serviceMetadata httpGetEnabled=“true” httpGetUrl=“http://mycomputer:9995/SampleMex" /><serviceCredentials /></behavior> |
指定一个 XML 字符串，<>其中包含serviceBehaviors> 元素的行为<元素，以配置 WCF 服务的行为设置。 有关 serviceBehaviors> 元素的详细信息<，请参阅另请参阅中的相应主题。 默认值为空字符串。 |
| EndpointBehaviorConfiguration | XML Blob 例如： <behavior name=“sampleBehavior”><callbackTimeouts /></behavior> |
使用 endpointBehaviors> 元素的行为元素<指定 XML 字符串，以配置 WCF 终结点的行为设置。>< 有关 endpointBehaviors> 元素的详细信息<，请参阅另请参阅中的相应主题。 注意：BizTalk Server不支持可以使用 EndpointBehaviorConfiguration 属性配置的所有行为扩展元素类型。 默认值为空字符串。 |
| CredentialType | 枚举 - 无：当此接收位置发送请求消息来轮询外部服务时，请不要使用任何凭据，或者此接收位置不需要轮询任何外部服务。 - IssueTicket：使用企业单一 Sign-On (SSO) 检索客户端凭据以颁发 SSO 票证。 该选项要求所使用的安全模式允许接收位置模拟用户帐户来颁发 SSO 票证。 - UserAccount：使用此接收位置发送请求消息以轮询外部服务时，使用 “用户名” 和 “密码” 属性中指定的凭据。 - GetCredentials：使用此接收位置发送请求消息以轮询外部服务时，使用 AffiliateApplicationName 属性中指定的 SSO 关联应用程序。 |
指定在轮询外部服务时此接收位置使用的凭据类型 默认值： None |
| UserName | String | 指定在轮询外部服务以检索响应消息时此接收位置使用的用户名。 当 CredentialType 属性设置为 UserAccount 时，此属性是必需的。 默认值为空字符串。 |
| 密码 | 字符串 | 指定在轮询外部服务以检索响应消息时此接收位置使用的密码。 当 CredentialType 属性设置为 UserAccount 时，此属性是必需的。 默认值为空字符串。 |
| AffiliateApplicationName | 字符串 | 指定此接收位置发送要求消息以轮询外部服务时返回要使用的外部凭据的 SSO 关联应用程序。 在运行接收位置所使用的 Windows 帐户和用于外部服务的帐户之间，指定的 SSO 关联应用程序必须具有一个映射。 当 CredentialType 属性设置为 GetCredentials 时，此属性是必需的。 默认值为空字符串。 |
| OrderedProcessing | Boolean | 指定在处理消息时是否保留消息顺序（以便与 NetMsmq 绑定一起使用）。 默认值：False |
| InboundBodyLocation | 枚举 - UseBodyElement - 使用传入消息的 SOAP Body 元素的内容创建 BizTalk 消息正文部分。 如果 Body 元素具有多个子元素，则只有第一个元素成为 BizTalk 消息正文部分。 - UseEnvelope - 从传入消息的整个 SOAP 信封 创建 BizTalk 消息正文部分。 - UseBodyPath - 使用 InboundBodyPathExpression 属性中的正文路径表达式创建 BizTalk 消息正文部分。 针对传入消息的 SOAP Body 元素的直接子元素计算正文路径表达式。 此属性仅对要求-响应端口有效。 有关如何使用 InboundBodyLocation 属性的详细信息，请参阅 指定 WCF 适配器的消息正文。 |
指定传入 WCF 消息的 SOAP Body 元素的数据选择。 默认值： UseBodyElement |
| InboundBodyPathExpression | 字符串 有关如何使用 InboundBodyPathExpression 属性的详细信息，请参阅 WCF 适配器属性架构和属性。 |
指定正文路径表达式以标识传入消息中用于创建 BizTalk 消息正文部分的特定部分。 此正文路径表达式是针对传入消息的 SOAP Body 节点的直接子元素计算的。 如果此正文路径表达式返回多个节点，则只选择第一个节点作为 BizTalk 消息正文部分。 如果将 InboundBodyLocation 属性设置为 UseBodyPath，则需要此属性。 默认值为空字符串。 |
| InboundNodeEncoding | 枚举 - Base64 - Base64 编码。 - 十六进制 - 十六进制编码。 - 字符串 - 文本编码 - UTF-8。 - XML - WCF 适配器使用 InboundBodyPathExpression 中的正文路径表达式选择的节点的外部 XML 创建 BizTalk 消息正文。 |
指定 WCF-Custom 接收适配器用于解码 由 InboundBodyPathExpression 中指定的正文路径表达式标识的节点的编码类型。 如果将 InboundBodyLocation 属性设置为 UseBodyPath，则需要此属性。 默认值： XML |
| OutboundBodyLocation | 枚举 - UseBodyElement - 使用 BizTalk 消息正文部件为传出响应消息创建 SOAP Body 元素的内容。 - UseTemplate - 使用 OutboundXMLTemplate 属性中提供的模板为传出响应消息创建 SOAP Body 元素的内容。 有关如何使用 OutboundBodyLocation 属性的详细信息，请参阅 指定 WCF 适配器的消息正文。 |
指定传出 WCF 消息的 SOAP Body 元素的数据选择。 此属性仅对请求响应接收位置有效。 默认值： UseBodyElement |
| OutboundXMLTemplate | 字符串 有关如何使用 OutboundXMLTemplate 属性的详细信息，请参阅 指定 WCF 适配器的消息正文。 |
为传出响应消息的 SOAP Body 元素的内容指定 XML 格式的模板。 如果 OutboundBodyLocation 属性设置为 UseTemplate，则需要此属性。 此属性仅对请求响应接收位置有效。 默认值为空字符串。 |
| DisableLocationOnFailure | Boolean | 指定是否禁用由于接收管道故障或路由故障而导致入站处理失败的接收位置。 默认值： False |
| SuspendMessageOnFailure | Boolean | 指定是否将由于接收管道故障或路由故障而导致入站处理失败的请求消息挂起。 默认值：True |
| IncludeExceptionDetailInFaults | Boolean | 指定是否将托管异常信息包括在返回给客户端以便进行调试的 SOAP 错误的详细信息中。 默认值： False |
| ReferencedBindings | XML Blob 例如： <BindingConfiguration vt=“8”> <wsFederationHttpBinding> <binding name=“sampleBinding”> <security mode=“Message”> <message issuedKeyType=“AsymmetricKey”> <issuer address=“http://www.contoso.com/samplests" binding=”wsFederationHttpBinding“ bindingConfiguration=”contosoSTSBinding“/> </消息> </安全> </绑定> </wsFederationHttpBinding> </BindingConfiguration> <ReferencedBindings vt=“8”> <bindings> <wsFederationHttpBinding> <binding name=“contosoSTSBinding”> <security mode=“Message”> <message negotiateServiceCredential=“false”> <issuer address=“http://northwind.com/samplests" bindingConfiguration=”northwindBinding“ binding=”wsHttpBinding”> </发行> </消息> </安全> </绑定> </wsFederationHttpBinding> <wsHttpBinding> <binding name=“northwindBinding”> <security mode=“Message”> <message clientCredentialType=“Certificate” /> </安全> </绑定> </wsHttpBinding> </绑定> </ReferencedBindings>注意：ReferencedBinding 属性不得包含 BindingConfiguration 属性中使用的绑定配置。 |
为 wsFederationHttpBinding 和 customBinding 指定由颁发者>元素的<bindingConfiguration 属性引用的绑定配置，这指示颁发安全令牌的安全令牌服务 (STS) 。 有关颁发者<>元素的详细信息，请参阅 中的https://go.microsoft.com/fwlink/?LinkId=83476主题“<issuer>”。 可以通过 WCF-Custom 和 WCF-CustomIsolated 适配器的 BindingConfiguration 属性配置包括 wsFederationHttpBinding 和 customBinding 的颁发者>元素在内的绑定信息<。 此属性的所有引用绑定配置都必须以绑定>元素的形式<放置。 注意： 不能在传输属性对话框中的“ 绑定 ”选项卡上配置此属性。 可以通过 WCF-Custom 和 WCF-CustomIsolated 适配器的传输属性对话框中的“ 导入/导出 ”选项卡导入和导出此属性。 注意：issuer> 元素的<bindingConfiguration 属性必须引用此属性中的有效绑定名称。 注意：如果引用链不生成循环依赖项，则引用的绑定配置中的 issuer> 元素也可以引用其 属性中的不同绑定配置。< 默认值为空字符串。 |
使用 BizTalk 管理控制台配置 WCF-Custom 接收位置
您可以在 BizTalk 管理控制台中设置 WCF-Custom 接收位置适配器变量。 如果未设置接收位置的属性，则使用 BizTalk 管理控制台中设置的默认接收处理程序值。
注意
在执行以下过程之前，您必须已添加接收端口。 有关详细信息，请参阅 如何创建接收端口。
为 WCF-Custom 接收位置配置变量
如果打算在配置 WCF-Custom 适配器时使用 WCF 扩展点（如自定义绑定元素、自定义行为元素和自定义通道组件），则必须同时在 BizTalk 处理计算机（运行时计算机）和管理计算机上向全局程序集缓存添加实现扩展点的程序集及所有依存程序集。 此外，您必须向 machine.config 文件注册扩展组件。 有关如何将 WCF 扩展点与 WCF 自定义适配器配合使用的详细信息，请参阅 如何使用 WCF 适配器启用 WCF 扩展性点。
在 BizTalk 管理控制台中，依次展开“BizTalk Server管理”、“BizTalk 组”、“应用程序”和要在其中创建接收位置的应用程序。
在 BizTalk 管理控制台的左窗格中，单击“接收端口” 节点。 随后，在右窗格中右键单击与现有接收位置关联的接收端口或要与新接收位置关联的接收端口，然后单击“属性” 。
在“ 接收端口属性 ”对话框的左窗格中，选择“ 接收位置”，然后在右窗格中双击现有接收位置，或单击“ 新建”创建新的接收位置。
在“接收位置属性”对话框中，在“类型”旁边的“传输”部分，从下拉列表中选择“WCF-Custom”，然后单击“配置”。
在 “WCF 自定义传输属性 ”对话框中的“ 常规 ”选项卡上，为 WCF-Custom 接收位置配置终结点地址和服务标识。 有关“WCF-自定义传输属性”对话框中的“常规”选项卡的详细信息，请参阅 UI 指南和开发人员 API 命名空间参考中的 WCF 自定义传输属性对话框、接收、常规选项卡。
在 “WCF 自定义传输属性 ”对话框中的“ 绑定 ”选项卡上，为 WCF 配置不同类型的预定义绑定或自定义绑定。 有关“WCF-自定义传输属性”对话框中的“绑定”选项卡的详细信息，请参阅 UI 指南和开发人员 API 命名空间参考中的 WCF 自定义传输属性对话框、接收、绑定选项卡。
在 “WCF 自定义传输属性 ”对话框中的“ 行为 ”选项卡上，为此接收位置配置终结点和服务行为。 终结点行为是一组行为扩展元素，这些元素修改或扩展服务或客户端功能。 有关“WCF-自定义传输属性”对话框中的“行为”选项卡的详细信息，请参阅 UI 指南和开发人员 API 命名空间参考中的 WCF 自定义传输属性对话框、接收、行为选项卡。
在 “WCF 自定义传输属性 ”对话框中的“ 其他 ”选项卡上，配置轮询外部服务时要使用的此接收位置的凭据，以及此接收位置在处理消息时是否保留消息顺序。 有关“WCF-自定义传输属性”对话框中的“其他”选项卡的详细信息，请参阅 UI 指南和开发人员 API 命名空间参考中的 WCF 自定义传输属性对话框、接收、其他选项卡。
在 “WCF 自定义传输属性 ”对话框中的“ 消息 ”选项卡上，指定 SOAP 正文 元素的数据选择。 有关“WCF-自定义传输属性”对话框中的“消息”选项卡的详细信息，请参阅 UI 指南和开发人员 API 命名空间参考中的 WCF 自定义传输属性对话框、接收、消息选项卡。
在“WCF 自定义传输属性”对话框中的“导入/导出”选项卡上，导入和导出“常规”选项卡上的“地址 (URI) ”和“终结点标识”属性，“绑定”选项卡上的绑定信息，以及此接收位置的“行为”选项卡上的终结点行为。 有关“WCF-自定义传输属性”对话框中的“导入/导出”选项卡的详细信息，请参阅 UI 指南和开发人员 API 命名空间参考中的 WCF 自定义传输属性对话框、接收、导入-导出选项卡。
以编程方式配置 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 适配器如何创建endpointBehaviors>绑定行为的关联应用程序<行为><<>><<serviceBehaviors>
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈