通过

教程：使用适用于 TIBCO Rendezvous 的 BizTalk 适配器来接收数据

  • 项目

您可以使用用于 TIBCO Rendezvous 的 BizTalk 适配器接收来自 TIBCO 系统的数据。 本演练描述了对此进行说明的一个 SDK 示例。

必备条件

在运行适配器的BizTalk Server上安装 Visual Studio，以便生成和部署示例。

关于本示例

  • 本示例使用用于 TIBCO Rendezvous 的 BizTalk 适配器接收来自 TIBCO 系统的数据。 业务流程处理消息并使用文件适配器将数据编写为指定文件夹中的 XML 文件。

  • 此示例在 Visual Studio 中设计，演示了将 BizTalk Adapter for TIBCO Enterprise Message Service 与 BizTalk 业务流程配合使用的基本功能。

    注意

    本示例假定您知道如何发送来自 TIBCO 的消息以供应用程序处理。

  • 示例的默认位置为 C:\Program Files\Microsoft BizTalk Adapters for Enterprise Applications\TIBCO(r) Rendezvous(r)\Sdk\OneWayReceive，并包含以下文件：

    Runtime 项目文件名 Runtime 项目文件说明
    OneWayReceive.btproj,

    OneWayReceive.sln    		 应用程序的项目和解决方案文件。
    PureMessage.xsd、 应用程序的架构文件。
    TIBCORvOWR.odx 应用程序使用的业务流程。
    TIBCORv.snk 强命名密钥文件。

步骤 1：将适配器添加到 BizTalk 管理

  1. 在“BizTalk Server管理”中，依次展开“BizTalk 组”、“平台设置”和“适配器”。

  2. 右键单击“适配器”并指向“新建”、“适配器...”以显示“适配器属性”对话框。

  3. 输入 “名称” 字段的值，例如 TIBCO Rendezvous。

  4. 从“适配器”下拉列表中提供的适配器列表中选择“TIBCO (r) Rendezvous (r) ”，然后单击“确定”。

步骤 2：创建接收端口

  1. 在“BizTalk Server管理”中，依次展开“BizTalk 组”、“应用程序”和“BizTalk 应用程序 1”，然后单击“接收端口”。

  2. 右键单击“接收端口”文件夹，然后单击“ 新建， 单向接收端口...” 以显示“ 接收端口属性 ”对话框。

  3. 输入 “名称” 字段的值，例如 TIBCORvOneWayRP，然后单击“ 确定”。

步骤 3：创建接收位置

  1. 右键单击新的接收端口，然后单击 “新建”、“ 接收位置...” 以显示“ 接收位置属性 ”对话框。

  2. 为 “名称” 字段输入值。 例如，输入 TIBCORvOneWayRL。

  3. 从“ 类型 ”下拉框中的可用适配器列表中选择 TIBCO Rendezvous 适配器，然后单击“ 配置 ”按钮以显示适配器的“ 传输属性 ”对话框。

    注意

    此值是在 BizTalk Server 管理控制台中创建 TIBCO 适配器时指定的名称。

  4. 在 AdapterRequiredProperties 下输入 RendezvousSubjectName 的值。

  5. 输入 “认证侦听器属性”的值：

    属性 值
    分类帐文件名称 用于持久性认证消息传递的分类帐文件名。
    可重复使用的名称 用于已验证消息传递的可重用的通信名称。 在网络上所有已验证消息通信名称中，该名称必须是唯一的。

  6. 输入 “凭据”的值：

    属性 值
    密码 TIBCO Rendezvous 服务器的密码。
    用户名 TIBCO Rendezvous 服务器的用户名。

  7. 输入 RendezvousTransport 的值：

    属性 值
    守护程序 Rendezvous 传输后台程序参数。
    网络 Rendezvous 传输网络参数。
    服务 Rendezvous 传输服务参数。

    有关属性的详细信息，请参阅 创建接收项目。

  8. 单击 “确定” 。

  9. 从“接收管道”下拉框中的可用管道列表中选择“XMLReceive”，然后单击“确定”。

  10. 右键单击接收位置，然后单击“ 启用”。

步骤 4：创建单向发送端口

  1. 创建发送端口要使用的目标文件夹，例如 C:\FilesOut。

  2. 在BizTalk Server管理控制台中，依次展开“BizTalk Server管理”、“BizTalk 组”、“应用程序”和“BizTalk 应用程序 1”，然后单击“发送端口”。

  3. 右键单击“ 发送端口 ”，指向“ 新建”、“ 静态”One-Way“发送端口...” 以显示“ 发送端口属性 ”对话框。

  4. 输入 “名称” 字段的值，例如 TIBCORvOneWayFileSP。

  5. 从“类型”下拉框中的可用适配器列表中选择“文件”，然后单击“配置”按钮以显示适配器的“传输属性”对话框。

  6. 对于“ 目标文件夹” 属性，请输入之前创建的文件夹的位置，然后单击“ 确定”。

  7. 从“发送管道”下拉列表中提供的管道列表中选择 XMLTransmit 管道，然后单击“确定”。

  8. 右键单击发送端口，然后单击“ 开始 ”以登记并启动发送端口。

步骤 5：生成和部署项目

  1. 右键单击解决方案资源管理器中的 OneWayReceive 项目，然后单击“属性”以启动该项目的 Project Designer。

  2. 单击“ 部署 ”选项卡。

  3. 在 BizTalk 组类别下输入“服务器”属性和“配置数据库”属性的相应值。

  4. 右键单击解决方案资源管理器中的 OneWayReceive 项目，然后单击“部署”生成项目并将程序集部署到BizTalk Server配置数据库。

步骤 6：绑定、登记和启动业务流程

  1. 在BizTalk Server管理控制台中，依次展开“BizTalk Server管理”、“BizTalk 组”、“应用程序”和“BizTalk 应用程序 1”，然后单击“业务流程”。

  2. 单击BizTalk Server管理控制台工具栏中的“刷新”按钮，或按键盘上的 F5 键刷新BizTalk Server管理控制台视图。

  3. 双击业务流程以显示“ 业务流程属性 ”对话框。

  4. 单击对话框左窗格中的“ 绑定 ”以显示业务流程的“绑定”选项。

  5. 指定绑定选项的适当值，例如：

    参数 值
    主机 BizTalkServerApplication
    SendPort TIBCORvOneWayFileSP
    ReceivePort TIBCORvOneWayRP

  6. 单击 “确定” 。

  7. 右键单击业务流程，然后单击“ 启动 ”以登记并启动业务流程。

步骤 7：确认应用程序收到消息

  • 打开文件发送端口配置为发送到的文件夹，并验证是否生成了输出文档。

    成功处理文档实例后，会发生以下事件序列：

  1. TIBCO Rendezvous 适配器接收来自 TIBCO 系统的消息并将其作为 BizTalk 消息发布到 MessageBox。

  2. 业务流程会订阅此发布的消息，以便 BizTalk 消息引擎能够激活业务流程的实例，并将该消息发送到业务流程实例。

  3. 业务流程实例将此消息发布回 MessageBox。

  4. 文件发送端口会订阅此消息，以便 BizTalk 能够将消息发送到文件适配器。

  5. 文件适配器将包含结果集的消息写入到指定的输出文件夹。

另请参阅

教程：使用适用于 TIBCO Rendezvous 的 BizTalk 适配器发送数据
教程：使用适用于 TIBCO Rendezvous 的 Microsoft BizTalk 适配器
入门