演练：通过 WCF-BasicHttp 适配器使用 WCF 服务

项目
07/21/2023

注意

有关适配器的详细信息，请参阅 BizTalk Server 中的适配器。

简介

在本演练中，你将使用 Windows Communication Foundation (WCF) 服务，该服务托管在 Internet Information Services (IIS) BizTalk 消息传送和 WCF-BasicHttp 发送适配器。此适配器使用 BasicHttpBinding 绑定提供与早期版本的 Web 服务兼容的传输/协议堆栈实现，以充当 Microsoft BizTalk Server 与 WCF 功能之间的桥梁。业务流程可以绑定到使用 WCF 适配器调用 WCF 服务的发送端口，并在其逻辑业务处理中利用其功能。

WCF-BasicHttp 适配器由一个发送适配器和一个接收适配器组成。在此示例中，将仅使用此适配器的发送端通过 HTTP 协议向 WCF 服务发出 WCF 服务请求。对于 Solicit-Response 发送端口，发送适配器会发送到 WCF 服务并接收结果响应。相反，WCF 接收适配器允许 WCF 客户端应用程序在外部发布和调用BizTalk Server业务流程。有关其他信息，请参阅发布 WCF 服务。

在完成本演练后，你将了解如何执行以下任务：

在 Microsoft Visual Studio 中，使用 Deploy 命令将包含 BizTalk Server 解决方案和 WCF 服务的程序集部署到 BizTalk Server 的本地实例。这将创建一个用这些程序集填充的 BizTalk 应用程序。
在 Visual Studio 中，使用 BizTalk WCF 服务使用向导生成使用 WCF 服务所需的BizTalk Server架构和类型。将生成空业务流程，您可以使用并将其绑定至逻辑端口。此业务流程与架构和类型一起编译和部署。但此处的业务流程工作流处理为空，在此示例中未使用，因为这只是一个纯BizTalk Server消息传送方案。
在 BizTalk Server 管理控制台中，使用 WCF-BasicHttp 发送端口配置基于内容的路由。你将配置目标 WCF 服务预期接收的 SOAPAction 标头。
在 BizTalk Server 管理控制台中，配置筛选器表达式，以路由 WCF 服务可以发送到输出文件夹的任何 SOAP 错误消息。
在 Internet Information Services (IIS) 管理器中，将承载 WCF 服务的 Web 应用程序配置为公开其元数据。启用后， BizTalk WCF 服务使用向导 可以获取此元数据，以生成用于访问 WCF 服务的类型和架构。

必备条件

若要执行本示例中的步骤，请确保你的环境中安装了以下必备软件：

生成程序集并运行部署过程的计算机和运行示例的计算机都需要 Microsoft Windows Server 2008 SP2、Microsoft .NET Framework 4.5 和 Microsoft BizTalk Server。
用于构建程序集和运行部署过程的计算机需要安装 Microsoft Visual Studio。
运行示例的计算机需要 WCF 适配器和 WCF 管理工具。这些是在安装 Microsoft BizTalk Server 期间要安装的选项。
在用于执行管理任务的计算机上，必须以BizTalk Server管理员组成员的用户帐户身份运行，才能在 BizTalk Server 管理控制台中配置BizTalk Server应用程序设置。此用户帐户还必须是本地管理员组的成员，才能部署应用程序，管理主机实例以及其他可能需要的任务。
在需要 WCF 功能的任何计算机上，在 Windows Communication Foundation 示例的一次性设置过程中完成 WCF 示例的一次性设置过程。
在运行示例并将绑定或 .msi 文件导入BizTalk Server的计算机上，请确保主机不是受信任的主机，否则导入将失败。
必须下载演练代码并将其提取到计算机。本演练是整个 WCF 适配器演练包的一部分。可以从 BizTalk Server 开发人员中心https://go.microsoft.com/fwlink/?LinkId=194140下载文件WCFAdapterWalkthroughs.exe。

部署示例 WCF 服务

运行自解压 WCFBasicHttpSendAdapter.exe 文件并将文件提取到 C：\WCFBasicHttpSendAdapter 文件夹中。
在 Visual Studio 中打开 C：\WCFBasicHttpSendAdapter\WCFBasicHttpSendAdapter.sln 。
在解决方案资源管理器中，展开 BasicHttpWCFServiceConsuming 项目。此项目是由发送端口调用的 WCF 服务。它将承载于使用 Internet 信息服务 (IIS) 的托管主机环境中。在 IIS 中承载将使用基于消息的激活来管理服务的激活和生存期。展开 “App_Code”，然后打开 “OrderProcess.cs” 进行查看。此 WCF 服务通过 OrderRequest 方法接收订单请求消息。 OrderProcess.cs 文件包含 WCF 服务的接口定义和实现。它只是通过 OrderResponse 方法返回订单响应消息。
查看 OrderProcess.svc 文件。它仅包含一行，该行用来告诉 IIS 为客户端应用程序激活服务。用于承载服务的 @ServiceHost 属性是 WCF 编程模型中的扩展点。工厂模式使用 ServiceHostFactory 创建 ServiceHost 实例，其中包含 WCF 服务实例来处理传入请求。此实例的实例化基于 ServiceBehaviorAttribute.ConcurrencyMode 属性，该属性确定服务是支持一个线程、多个线程还是支持可重入调用。实例化还由 ServiceBehavior.InstanceMode 属性确定，该属性确定是否只有一个实例将 (单一实例) 为所有调用方提供服务，是否为每个调用创建一个实例 (无状态) ，或者是否将为每个会话创建一个实例， (有状态) 。
```
<%@ServiceHost language=c# Debug="true" Service="Microsoft.Samples.BizTalk.WCF.BasicHttpSendAdapter.BasicHttpWcfServiceConsuming.OrderProcessServiceType" %>
```
在 Visual Studio 解决方案资源管理器中，打开 Web.config 进行查看。在 IIS 中托管时，WCF 服务使用 Web.config 文件而不是控制台应用程序中托管的 app.config 文件进行配置。
- 确保 serviceMetaData> 元素的 <httpGetEnabled 属性设置为 true ，以便 BizTalk WCF 服务使用向导可以使用服务的元数据。
- 确保安全>元素的 <mode 属性设置为 None。由于本演练使用 None 安全模式，因此承载此服务的 Web 应用程序必须配置为允许匿名访问。
由于必须在 GAC 中安装 Microsoft.Samples.BizTalk.WCF.BasicHttpSendAdapter.BasicHttpWcfServiceConsuming 程序集，因此需要强名称密钥文件才能完成部署过程。右键单击 “BasicHttpWcfServiceConsuming ”项目，然后单击“ 属性”。在 “属性” 页上，单击“ 签名”，然后选择“ 对程序集进行签名”。单击“选择强名称密钥文件”下拉列表中的向下箭头，单击“新建>”<，然后在“密钥文件名”文本框中输入 keyfile.snk 。取消选中“ 使用密码保护我的密钥文件”，然后单击“ 确定”。
在解决方案资源管理器中，右键单击“基本”“HttpWcfServiceConsuming”，然后单击“重新生成”。
使用 Windows 资源管理器，将 C：\WCFBasicHttpSendAdapter\BasicHttpWCFServiceConsuming 的内容复制到 C：\InetPub\wwwroot 文件夹。
配置 Web 应用程序以托管 WCF 服务，如下所示：
1. 单击 “开始”，指向 “管理员工具”，然后单击“ Internet Information Services (IIS) 管理器”。
2. 创建此服务将运行在其中的应用程序池。右键单击“ 应用程序池”，单击“ 添加应用程序池...”，输入应用程序池的名称，然后单击“ 确定”。
3. 展开 “应用程序池”，右键单击刚创建的应用程序池，然后选择“ 高级设置”。在“进程模型”部分的“标识”字段下，输入有权访问BizTalk Server数据库的帐户。
4. 展开 “站点”，展开“ 默认网站”，右键单击“基本”“ HttpWCFServiceConsuming”，然后单击“ 转换为应用程序 ”，为此 WCF 服务创建 Web 应用程序。
5. 在“ 转换为应用程序 ”对话框中，单击“ 选择 ”以选择之前创建的应用程序池，然后单击“ 确定”。
6. 在“功能视图”中，单击“身份验证”图标，并确保已启用“匿名身份验证”选项。这支持 无安全模式 的 WCF 服务。
按如下所示测试已发布的 WCF 服务：
1. 在 IIS 管理器中，展开 “网站”，然后展开“ 基本”“HttpWCFServiceConsuming”。
2. 在 IIS 管理器的右窗格中，右键单击“ OrderProcess.svc”，然后单击“ 浏览”。这将打开 Internet Explorer 以显示 “OrderProcessServiceType 服务 ”页，指示已成功创建正在运行的 WCF 服务。此页还包含一个完整的 WSDL 地址，您可以通过复制该地址并将其用于服务元数据工具 (svcutil.exe) 来创建可用于该服务客户端应用程序开发的代理代码和配置文件。
3. 将完整的 WSDL 地址复制到系统剪贴板中。请勿复制 “svcutil.exe” 部分： http://localhost/BasicHttpWcfServiceConsuming/OrderProcess.svc?wsdl

将 WCF-BasicHttp 适配器的架构和类型添加到示例 BizTalk 应用程序

由于适配器将调用 WCF 服务，因此它需要架构和类型中有关如何使用元数据对该服务进行调用的信息。 BizTalkApp 提供项目来使用 WCF 服务。在 Visual Studio 解决方案资源管理器中，右键单击 BizTalkApp，单击“添加”，然后单击“添加生成的项”。
在 “添加生成的项 ”对话框的“ 模板 ”部分中，选择“ 使用 WCF 服务”，然后单击“ 添加”。
在 “欢迎使用 BizTalk WCF 服务使用向导” 页上，单击“ 下一步”。此向导将读取元数据并创建架构和类型。
在 “元数据源 ”页上，选择“ 元数据交换 (MEX) 终结点 ”选项，以使用在上一过程中复制到剪贴板的 URL 中的元数据，然后单击“ 下一步”。
在 “元数据终结点 ”页上，将上一过程中复制的完整 WSDL 地址粘贴到“ 元数据地址 ”下拉列表，然后单击“ 获取 ”以获取示例 WCF 服务的元数据文档。获取元数据将启用“ 下一步 ”按钮。单击“下一步”以继续。
在 “导入 WCF 服务元数据摘要 ”页上，查看设置。此对话框会显示要导入的元数据的命名空间、XSD 及 WSDL 摘要。它还显示了在导入过程中将写入业务流程 (.odx) 、绑定 (.xml) 和架构 (.xsd) 文件的位置。单击“ 导入 ”，创建用于使用示例 WCF 服务的 BizTalk 项目和类型。
在 “完成 BizTalk WCF 服务使用向导” 页上，单击“ 完成”。
在 Visual Studio 解决方案资源管理器中，BizTalk WCF 服务使用向导生成以下文件：
- 业务流程文件 OrderProcessServiceType.odx。在此业务流程中没有工作流阶段。但是，可以向其添加，并将其绑定到逻辑端口以使用 WCF 服务。它包含重要的 BizTalk 类型（例如端口类型和多部分消息类型），在此示例中将会使用这些类型。若要查看此信息，请双击 OrderProcessServiceType.odx 业务流程。依次单击“ 视图”、“ 其他窗口”和“ 业务流程视图”。依次展开“类型”、“端口类型”和“IOrderProcess”。你将看到 Submit 方法。展开该方法，你将看到 OrderRequest 和 OrderResponse 端口类型。单击每个端口类型，在属性浏览器中查看其 Description 字段，并查看不同的 WSDL 输入和输出消息。单击 “多部分消息类型 ”，并查看 OrderRequest 和 OrderResponse 多部分消息类型。单击其 “说明” 字段，并查看每种消息类型的 WDSL 消息名称。
- 将生成两个架构文件。 (OrderProcessServiceType_biztalk_WCF_basichttpsendadapter_basichttpWCFserviceconsuming.xsd) 的第一个架构文件定义示例 WCF 服务使用的消息类型。它在 OrderRequest 和 OrderResponse 调用中使用 OrderID 字段。
- dataContractSerializer 为命名空间 http://schemas.microsoft.com/2003/10/Serialization/中的类型、元素和属性导出 (OrderProcessServiceType_schemas_microsoft_com_2003_10_Serialization.xsd) 的第二个架构文件。
- 生成两个绑定文件，稍后将用于创建 BizTalk 应用程序： OrderProcessServiceType.BindingInfo.xml 和 OrderProcessServiceType_Custom.BindingInfo.xml。一般情况下，您通常使用非自定义绑定文件。但在您拥有自定义绑定元素的某些少数情形下，将使用自定义绑定文件。自定义绑定元素将为应用程序创建发送端口。双击 OrderProcessServiceType.BindingInfo.xml 文件并搜索 SendPort 定义行，并查看将此绑定文件导入BizTalk Server时将创建的发送端口：
```
<SendPort Name="WCFSendPort_OrderProcessServiceType_ServiceEndpoint" …  >
```
- 这些文件用于使用 WCF 适配器的发送端口，以使用元数据中描述的示例 WCF 服务。

部署示例 BizTalk 解决方案 BizTalkApp

按如下所示部署BizTalk Server应用程序：
1. 在 Visual Studio 解决方案资源管理器中，右键单击 BizTalkApp，然后单击“属性”。
2. 在“项目Designer”窗口中，单击“部署”选项卡，如果对 BizTalk Server Management 数据库使用不同的数据库服务器，则更改 Server 属性。 确保应用程序名称为 WCFBasicHttpSendAdapter。
3. 在 Visual Studio 的解决方案资源管理器中，右键单击 BizTalkApp，然后单击“重新生成”。
4. 在 Visual Studio 解决方案资源管理器中，右键单击 BizTalkApp，然后单击“部署”。这会将 Microsoft.Samples.BizTalk.WCF.BasicHttpSendAdapter.BizTalkApp 程序集部署到 GAC，并将项目部署到名为 WCFBasicHttpSendAdapter 的BizTalk Server应用程序。
在 BizTalk 应用程序中配置 WCF-BasicHttp 发送端口，如下所示：
1. 单击“开始”，指向“所有程序”，指向“Microsoft BizTalk Server 20xx”，然后单击“BizTalk Server管理”。
2. 在BizTalk Server管理控制台中，依次展开“BizTalk 组”、“应用程序”，右键单击“WCFBasicHttpSendAdapter”，指向“导入”，然后单击“绑定”。
3. 在“ 导入绑定 ”对话框中，转到 “C：\WCFBasicHttpSendAdapter\BizTalkApp ”文件夹，选择“ OrderProcessServiceType.BindingInfo.xml”，然后单击“ 打开”。这是 BizTalk WCF 服务使用向导 先前创建的绑定文件之一。这会创建 WCFSendPort_OrderProcessServiceType_ServiceEndpoint 发送端口。
4. 在BizTalk Server管理控制台中，展开“WCFBasicHttpSendAdapter”，并单击“发送端口”。
5. 在BizTalk Server管理控制台的右窗格中，双击通过导入绑定文件 OrderProcessServiceType.BindingInfo.xml 创建的WCFSendPort_OrderProcessServiceType_ServiceEndpoint。此时会显示“ 发送端口属性 ”对话框。
6. 在“ 发送端口属性 ”对话框中，单击“ 配置”。
7. 在“ 常规 ”选项卡上，查看的“ 地址 (URI) ”字段 http://localhost/BasicHttpWcfServiceConsuming/OrderProcess.svc。这是 WCF-BasicHttp 适配器将调用的 IIS 中托管的 WCF 服务的地址。
8. 查看 “SOAP 操作标头/操作 ”文本框的内容：
```
<BtsActionMapping xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <Operation Name="Submit" Action="http://Microsoft.Samples.BizTalk.WCF.BasicHttpSendAdapter.BasicHttpWcfServiceConsuming/IOrderProcess/Submit" />
</BtsActionMapping>
```
  此字段指示传出 SOAP HTTP 请求消息的目的。此处用来在 IOrderProcess 接口上从 Microsoft.Samples.BizTalk.WCF.BasicHttpSendAdapter.BasicHttpWcfServiceConsuming 命名空间来调用“提交”操作。
  
  注意
  
  BizTalk WCF 服务使用向导生成的绑定文件使用 StaticAction 属性的操作映射格式。使用 WCF 发送适配器的基于内容的路由将消息发送到 WCF 服务时，需要设置 BTS。 管道组件中的操作属性，用于操作映射格式，作为要用于基于内容的路由的字段。或者，您也可以选择将单一操作格式用于基于内容的路由。在本演练中，您将使用单一操作格式。有关单一操作格式和操作映射格式的详细信息，请参阅 UI 指南和开发人员 API 命名空间参考中的 WCF-BasicHttp 传输属性对话框、发送和常规选项卡。
9. 单击“确定”两次返回到BizTalk Server管理控制台。
创建单向静态接收端口和 FILE 接收位置。接收端口是一个或多个接收位置的逻辑容器。在这里，你将删除文件适配器将选取的示例 WCF 消息，然后将其发送到 WCF 服务。
1. 在BizTalk Server管理控制台中，展开“WCFBasicHttpSendAdapter”，右键单击“接收端口”，指向“新建”，然后单击“单向接收端口”。
2. 在“ 接收端口属性 ”对话框的“ 名称 ”文本框中，键入 WCFBasicSendAdapter.ReceivePurchaseOrder，然后单击“ 确定”。
3. 在BizTalk Server管理控制台中，右键单击“WCFBasicHttpSendAdapter.ReceivePurchaseOrder”，指向“新建”，然后单击“接收位置”。
4. 在“ 接收位置属性 ”对话框的“ 名称 ”文本框中，键入 WCFBasicSendAdapter.ReceivePurchaseOrder.FILE。
5. 在“接收位置属性”对话框的“类型”旁边的“传输”部分中，从下拉列表中选择“文件”，然后单击“配置”。
6. 在“ 文件传输属性 ”对话框中的“ 常规 ”选项卡上的“ 接收文件夹 ”文本框中键入 C:\WCFBasicHttpSendAdapter\OrderRequestIn，然后单击“ 确定”。
7. 在 “接收位置属性 ”对话框中，单击“ 确定”。
创建一个筛选器，将消息从上一步中创建的 FILE 接收位置路由至 WCF-BasicHttp 发送端口。与端口关联的筛选器作用与 SQL“where”子句相似，如果其值为真，则将消息发送至该端口。
1. 在BizTalk Server管理控制台中，展开“WCFBasicHttpSendAdapter”，单击“发送端口”，然后双击“WCFSendPort_OrderProcessServiceType_ServiceEndpoint”。
2. 在“ 发送端口属性 ”对话框中的“ 筛选器 ”选项卡上，选择“ BTS”。ReceivePortName 在 “属性” 字段中，键入 WCFBasicSendAdapter.ReceivePurchaseOrder “ 值 ”字段，然后单击“ 确定”。此筛选器表达式将从 WCFBasicSendAdapter.ReceivePurchaseOrder 接收端口将传入消息路由至此 WCF-BasicHttp 发送端口。
为示例应用程序创建两个 FILE 发送端口。第一个发送端口将输出响应消息从 WCF 服务发送到 FILE 端口。第二个发送端口用于处理从发往客户端的 WCF 服务发送的错误消息。
1. 在BizTalk Server管理控制台中，展开“WCFBasicHttpSendAdapter”，右键单击“发送端口”，指向“新建”，然后单击“静态单向发送端口”。
2. 在“ 发送端口属性 ”对话框的“ 名称 ”文本框中，键入 WCFBasicSendAdapter.SendPurchaseOrder.FILE。
3. 在 “发送端口属性 ”对话框的“类型”旁边的“ 传输 ”部分中，从下拉列表中选择“ 文件 ”，然后单击“ 配置”。
4. 在“ 文件传输属性 ”对话框的“ 常规 ”选项卡上的“ 目标文件夹 ”文本框中键入 C：\WCFBasicHttpSendAdapter\OrderResponseOut，然后单击“ 确定”。
5. 在“发送端口属性”对话框中的“筛选器”选项卡上，选择“BTS”。MessageType 在“属性”字段中，键入http://Microsoft.Samples.BizTalk.WCF.BasicHttpSendAdapter.BasicHttpWCFServiceConsuming#OrderResponse“值”字段以指定示例 WCF 服务中的响应消息类型，然后单击“确定”。此筛选器表达式将响应消息从示例 WCF 服务路由到此 FILE 发送端口。此发送端口通过在筛选器属性中指定类型来订阅 OrderResponse 类型的消息。这是来自 WCF 服务的响应消息的消息类型。
6. 在 “发送端口属性 ”对话框中，单击“ 确定”。
7. 在BizTalk Server管理控制台中，展开“WCFBasicHttpSendAdapter”，右键单击“发送端口”，指向“新建”，然后单击“静态单向发送端口”。
8. 在“ 发送端口属性 ”对话框的“ 名称 ”文本框中，键入 WCFAdapterErrorSend.FILE。
9. 在“发送端口属性”对话框的“类型”旁边的“传输”部分中，从下拉列表中选择“文件”，然后单击“配置”。
10. 在“ 文件传输属性 ”对话框的“ 常规 ”选项卡上的“ 目标文件夹 ”文本框中，键入**C：\WCFBasicHttpSendAdapter\WCFAdapterErrorOut**，然后单击“ 确定”。
11. 在“ 发送端口属性 ”对话框中的“ 筛选器 ”选项卡上，选择“ WCF”。IsFault 在 “属性” 字段中，键入 True “ 值 ”字段，然后单击“ 确定”。在应用程序中，可以通过检查 WCF 来检测异常或错误。发送回调用方的消息的 IsFault 属性。如果发送的消息是 SOAP 错误消息，则此属性将设置为 True 。此筛选器表达式将来自示例 WCF 服务的错误消息路由到此 FILE 发送端口。
指定示例应用程序的主机名和绑定，如下所示：

在BizTalk Server管理控制台中，依次展开“WCFBasicHttpSendAdapter”和“业务流程”，右键单击“Microsoft.Samples.BizTalk.WCF.BasicHttpSendAdapter.BizTalkApp.OrderProcessServiceTypeClient 业务流程”，单击“属性”，单击“绑定”，将“主机”设置为“BizTalkServerApplication”，然后单击“确定”保存配置。

使用 WCF-BasicHttp 发送适配器测试示例解决方案

在BizTalk Server管理控制台中，右键单击“WCFBasicHttpSendAdapter”，然后单击“启动”。
在“ 开始 ”对话框中，单击“ 启动”。
在BizTalk Server管理控制台中，依次展开“平台设置”、“主机实例”、右键单击 BizTalkServerApplication 或其他相应的主机实例，然后单击“重启”。
打开命令提示符，键入 iisreset 以回收 IIS 及其依赖服务，然后按 Enter。
在命令提示符下， 将C:\WCFBasicHttpSendAdapter\TestData\WCFBasicSendAdapter.OrderRequest.Sample.xml 复制到 C：\WCFBasicHttpSendAdapter\OrderRequestIn 文件夹。此消息路由到双向 WcfSendPort_OrderProcessServiceType_ServiceEndpoint 静态 Solicit-Response 发送端口。此双向发送端口的发送端在 IIS 中托管的 WCF 服务上调用 Submit 方法。结果将返回到 WcfSendPort_OrderProcessServiceType_ServiceEndpoint 发送端口的响应端口。 WCFBasicSendAdapter.SendPurchaseOrder.FILE 发送端口有一个订阅，该订阅将在消息的类型为 http://Microsoft.Samples.BizTalk.WCF.BasicHttpSendAdapter.BasicHttpWCFServiceConsuming#OrderResponse时触发。它将获取已成功处理的消息，并将其写出到 C：\WCFBasicHttpSendAdapter\OrderResponseOut 文件夹。
检查 C：\WCFBasicHttpSendAdapter\OrderResponseOut 文件夹中是否有来自 WCF 服务的响应消息。
在命令提示符下， C:\WCFBasicHttpSendAdapter\TestData\WCFBasicSendAdapter.OrderRequest.Invalid.xml C ：\WCFBasicHttpSendAdapter\OrderRequestIn 文件夹。此消息包含无效的命名空间，以便 WCF 服务返回错误消息。
检查 C：\WCFBasicHttpSendAdapter\WCFAdapterErrorOut 文件夹中是否存在包含来自 WCF 服务的错误消息的 XML 文件。查看 <错误字符串> 字段，其中显示了导致错误消息正文无效的原因。

另请参阅

演练：使用 WCF-BasicHttp 适配器发布 WCF 服务如何使用 BizTalk WCF 服务使用向导来使用 WCF 服务指定 WCF 适配器的消息正文

通过