ApplicationAdapter

ApplicationAdapter 示例演示如何在接收消息时从响应方或发起方的公用流程和专用流程发送通知。 你可以自定义该示例，使其具有任何你需要的其他功能。

ApplicationAdapter 示例演示如何实现 类的 IApplicationAdapterApplicationAdapter1 接口。 此类包括两种方法： BeginNotify 和 Notify。 每个类的参数包括消息类别、源参与方名称、目标参与方名称、合作伙伴接口流程 (PIP) 代码、PIP 实例 ID 以及 PIP 版本。

通过在 Microsoft® BizTalk Accelerator for RosettaNet (BTARN) 管理控制台中，在协议的“常规”选项卡上输入程序集名称和类名来设置协议的 ApplicationAdapter。 应用程序适配器 .dll 文件运行所用的凭据与 BizTalk 主机服务的凭据相同。

如果更改 ApplicationAdapter 示例或 ApplicationAdapter 示例所依赖的任何外部环境变量，请重启承载 BTARN 公共进程的 BizTalk 主机服务。

ApplicationAdapter 示例代码位于 <drive>：\Program Files\ BizTalk <版本> Accelerator for RosettaNet\SDK\ApplicationAdapter\。

演示

ApplicationAdapter 示例演示如何通知响应方专用流程公用流程已收到消息。 通知指明消息类别、源参与方名称、目标参与方名称、PIP 代码、PIP 版本以及 PIP 实例 ID。 可以为操作或响应消息发送此通知。

BeginNotify和 Notify 方法的工作方式如下：

1. 响应方公用流程接收消息。

   注意

   以下步骤也适用于公用发起方从响应方接收响应消息的情况。

2. 如果接收管道和公共进程的验证以及验证适配器（如果适用）成功，则响应方公共进程会调用 BeginNotify 类中的 ApplicationAdapter 方法。 此方法通知响应方专用流程公用流程已收到新消息并将该消息保存在 MessageBox 数据库中。

3. 响应方公用流程向发起方回送信号消息。

4. 响应方公用流程向响应方专用流程发送消息服务内容。

5. 响应方专用流程将消息放入 BTARNDATA 数据库的 MessagesToLOB 表中。

6. 响应方专用进程调用 Notify 类中的 ApplicationAdapter 方法，以将结束通知消息发送回响应方公共进程。 只有在响应方公用流程收到“通知结束”消息时，该流程才算成功完成。 否则，消息被挂起。

注意

可以使用消息 Notify 向业务线 (LOB) 应用程序发出消息在 MessagesToLOB 表中等待的信号。 系统向 LOB 应用程序发出警报后，LOB 应用程序可立即从该表中检索此消息。

实现此示例

要实现该 ApplicationAdapter 示例，必须向协议添加应用程序适配器。

向协议添加应用程序适配器

1. 单击“开始”，指向“所有程序”，指向“Microsoft BizTalk <版本> Accelerator for RosettaNet”，然后单击“BizTalk Accelerator for RosettaNet管理控制台”。

2. 在“BizTalk Accelerator for RosettaNet管理控制台”中，展开“BizTalk Accelerator for RosettaNet”，然后单击“协议”。

3. 双击要添加应用程序适配器的协议。

4. 在“应用程序适配器”框中，单击“程序集名称”右侧的省略号按钮 (...) 按钮，移动到包含应用程序适配器程序集的位置，选择相应的 .dll 文件，然后单击“打开”。

5. 单击“ 类名称”的向下箭头，选择应用程序适配器类，然后单击“ 确定”。

另请参阅

适配器示例