通过

错误处理（BizTalk Server 示例文件夹）

  • 项目

本示例的目的是为基于内容的路由 (CBR) 应用程序生成错误处理功能。

必备条件

若要运行本示例，建议你安装 Microsoft Office InfoPath 2010 或更高版本。 你可以在不使用 InfoPath 的情况下运行本示例，但在这种情况下，你无法通过 HTTP 适配器查看费用报告以及费用报告的提交。

本示例的用途

本示例可实现费用报告处理系统部分。 具体而言，本示例执行下列操作：

  1. 定义费用报告架构，该架构包含有关费用报告和单个提交者（包括部门名称）的信息。

  2. 使用 InfoPath 通过目录或 Web Services 提供费用报告的提交。

  3. 提升消息文档中的 Department 和 correlationID 属性，以便可以在端口筛选器中使用它来控制路由。

  4. 将属于 Marketing 部门的费用报告路由到目录中的某个文件，从而模拟送达该部门的后端系统。

  5. 对属于 Marketing 之外的部门的费用报告生成失败消息。 失败消息包括有关错误（包括错误代码和错误说明）的信息。

  6. 将失败消息路由给接收方人员（业务用户或应用程序操作员）以进行更正和重新提交。

  7. 如上所述，根据部门路由重新提交的费用报告。

    大部分工作都是通过 BizTalk 业务流程调度完成的。

此示例的设计方式和原因

设计依赖 BizTalk Server 中的默认发送和接收 XML 管道、属性升级、订阅筛选器和业务流程调度来路由消息。 下表列出了设计元素及其选入理由。

设计元素 选择的原因
默认 XML 接收管道 - XMLReceive 管道支持属性升级;PassThruReceive 管道没有。
- 入站消息已采用 XML 格式，不需要除基本反汇编和参与方解析外进行处理。
针对失败消息的路由 - 默认情况下，接收端口挂起失败的消息并生成否定确认。 启用路由后，BizTalk Server 会尝试将处理失败的所有消息路由到某个订阅应用程序（例如另一个接收端口或业务流程调度）。
属性升级 - BizTalk Server取决于属性字段来执行路由。 业务流程使用可分辨字段，并且该字段不能用于路由。
订阅筛选器 - 订阅筛选器通过根据属性字段捕获满足一个或多个条件的消息来执行路由。
BizTalk 业务流程调度 - 提供向失败消息添加信息的机会。
- 允许将失败的消息路由到专用位置进行人工干预。
- 处理重新提交的费用报表。
XMLTransmit - 执行传出 XML 消息的基本程序集。 PassThruTransmit 管道不提供其他支持。

本示例所在的位置

此示例位于 <Samples Path>\Messaging\ErrorHandling\。

下表包含本示例的文件列表。

文件 说明
Cleanup.bat 用于取消部署程序集并从全局程序集缓存中删除这些程序集。

删除发送和接收端口。

根据需要删除 Internet 信息服务 (IIS) 虚拟目录。
ErrorHandling.sln 本示例的 Visual Studio 解决方案文件。
ErrorHandlingBinding.xml 本示例的绑定文件。
Setup.bat 用于生成和初始化本示例。
Expense Report – John Doe.xml 示例费用报告 InfoPath 文档。
Invalid Expense Report – John Doe.xml 示例费用报告 InfoPath 文档，其中包含无效的数据。
在 ErrorHandler 文件夹中：

ErrorHandler.btproj		 业务流程的 BizTalk 项目。
在 ErrorHandler 文件夹中：

ResubmitLogic.odx		 订阅失败消息，将失败消息发送给接收方人员进行更正，然后将更正后的消息重新提交回服务器进行路由的业务流程。
在 ErrorHandler 文件夹中：

SuspendMessage.odx		 用于挂起无法在错误处理业务流程中处理的消息的业务流程。
在 InfoPathForms 文件夹中：

Expense Report.xsn

Expense Report - Resubmit.xsn		 费用报告 InfoPath 表单以及用于查看和重新提交失败消息的表单。
在 PipelinesAndSchemas 文件夹中：

ExpenseReportSchema.xsd		 费用报告文档的 XML 架构。
在 PipelinesAndSchemas 文件夹中：

PipelinesAndSchemas.btproj		 本示例的 BizTalk 项目。
在 PipelinesAndSchemas 文件夹中：

PropertySchema.xsd		 本示例的属性架构。

如何使用本示例

本示例为创建自己的错误处理过程提供了一个起点。

生成和初始化此示例

生成并初始化 Compose 示例

  1. 在命令窗口中，导航到下面的文件夹：

    <Samples Path>\Messaging\ErrorHandling

  2. 运行 Setup.bat，它执行以下操作：

    • 在以下路径下创建三个文件夹： ExpenseReportIn、 ExpenseReportOut 和 ResubmittedReportIn ：

      <Samples Path>\Messaging\ErrorHandling

    • 将 InfoPath 表单 Expense Report.xsn 和 Expense Report – Resubmit.xsn 复制并发布到 C：\Temp\InfoPathForms 文件夹中。

    • 编译此示例的 Visual Studio 项目。

    • 创建名为 ExpenseReports 的虚拟目录。

    • 创建名为 “错误处理示例” 的新 BizTalk 应用程序，并将示例程序集部署到其中。

    • 创建并绑定BizTalk Server接收位置以及发送和接收端口。

    • 登记并启动业务流程，启用接收位置，然后启动发送端口。

      如果选择在不运行 Setup.bat 的情况下打开并生成本示例中的项目，则必须首先使用 .NET Framework 强名称实用工具 (sn.exe) 创建一个强名称密钥对。 使用该密钥对可以对示例程序集进行签名。

  3. 在尝试运行本示例之前，请确认在生成或初始化过程中 BizTalk Server 未报告任何错误。

    注意

    若要撤销 Setup.bat 所做的更改，请运行 Cleanup.bat。 第二次运行 Setup.bat 之前，必须运行 Cleanup.bat。

  4. 如果使用 Internet Information Services (IIS) 7.0，则需要执行其他配置步骤来调整与示例使用的BizTalk Server HTTP 接收位置相对应的虚拟目录的设置。 通过执行以下操作配置 IIS：

    1. 使用 IIS 7.0 管理器为 BizTalk Isolated Host Users 组创建新的应用程序池。

    2. 将应用程序池配置为以 BizTalk Server 独立主机用户的身份运行。 （如果您已为其他 BizTalk Server HTTP 接收位置配置应用程序池，则可以跳过此步骤。）

    3. 将虚拟目录 ExpenseReport 配置为使用在上一步中创建的 HTTP 接收应用程序池。

      如果 BTSHTTPReceive.dll ISAPI 扩展尚不具有 Web 服务器扩展，则可通过将其状态设置为“允许”创建和启用该扩展。 可以在 IIS 7.0 中执行此操作，方法是使用 IIS 管理控制台 (直接在 “管理工具” 下或通过计算机管理控制台) ，如下所示：

    4. 展开 “Internet Information Services 管理器” 树。

    5. 单击“ Web 服务扩展” 文件夹。

    6. 在管理控制台的右窗格中，单击“添加新的 Web 服务扩展”。

    7. 在“ 新建 Web 服务扩展 ”对话框中，单击“ 添加”。

    8. 在“添加文件”对话框中，单击“浏览”以选择\HttpReceive\BTSHTTPReceive.dll的文件<BizTalkInstallPath>，然后单击“确定”。

    9. 将虚拟目录 ExpenseReport 配置为使用本地路径 \Program Files (x86) \Microsoft BizTalk Server <VERSION>HTTPReceive

      有关详细信息，请参阅 如何为 HTTP 接收位置配置 IIS。

运行示例

在降本示例与正确的费用报告一起运行之前，请使用以下过程验证“无错误”情况下的示例是否正常运行。

验证“无错误”情况下的示例是否正常运行

  1. 打开 InfoPath 表单 Expense Report - John Doe.xml。 查看窗体中的 “部门 ”字段。 此字段应设置为“Marketing”。

  2. 在 InfoPath 窗口的左上角，单击“ 提交 ”或单击“ 重新提交费用报表”。 等待出现确认窗口，指示已成功提交费用报告。

    \- 或 -

    将此文件复制并粘贴到 ExpenseReportIn 文件夹中。

  3. 应会看到一个新文件已放入 ExpenseReportOut 文件夹中。 此文件即为上述步骤中提交的费用报告表单。

    在确认“无错误”的情况后，使用以下过程将本示例与不正确的费用报告一起运行，从而触发错误处理功能。

触发错误处理

  1. 打开 InfoPath 表单 无效费用报表 - John Doe.xml。 查看窗体中的 “部门 ”字段。 此字段设置为某个无效的值。

  2. 在 InfoPath 窗口的左上角，单击“ 提交”。 等待出现确认窗口，指示已成功提交费用报告。

    \- 或 -

    将此文件复制并粘贴到 ExpenseReportIn 文件夹中。

  3. 应会看到名为 ErrorReport_<date_time> 的新文件.xml 放入 ExpenseReportOut 文件夹中。

    打开此文件，然后会观察到这是在前面步骤中提交的费用报告，但在开头添加了错误信息。

  4. 将错误的部门值替换为“Marketing”，然后单击 InfoPath 窗口左上角的“ 提交 ”。

    \- 或 -

    将此文件复制并粘贴到 ResubmittedReportIn 文件夹中。

  5. 应会看到在 ExpenseReportOut 文件夹中创建了一个新文件。 此文件即为重新提交到服务器的更正后的费用报告。

另请参阅

使用失败消息路由
消息传送（BizTalk Server 示例文件夹）