通过

教程：使用 TIBCO Rendezvous 的 BizTalk 适配器以发送数据

  • 项目

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

必备条件

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

  • 此示例使用包含消息上下文属性的 DLL：Microsoft.BizTalk.Adapters.TibRV.Properties.dll。 您可能需要更新解决方案对此库的引用。 有关详细信息，请参阅BizTalk Server消息上下文属性 (发送处理程序) 。

关于本示例

  • 该示例从一个文件夹选取一个 XML 文件，将该文件发送到业务流程，然后使用用于 TIBCO Rendezvous 的 BizTalk 适配器在 TIBCO 系统中创建一个记录。

  • 此示例在 Visual Studio 中设计，演示了使用 BizTalk Adapter for TIBCO Rendezvous 和 BizTalk 业务流程的基本功能。

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

    Runtime 项目文件名 Runtime 项目文件说明
    OneWaySend.btproj

    OneWaySend.sln    		 应用程序的项目和解决方案文件。
    Schema.xsd

    PropertySchema.xsd    		 应用程序的架构和属性架构文件。
    Orchestration.odx 应用程序使用的业务流程。
    TIBCORendezvousOneWaySend.snk 强命名密钥文件。

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

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

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

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

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

步骤 2：创建发送端口

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

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

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

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

    注意

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

  5. 输入 “认证发件人属性”的值：

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

  6. 输入 凭据的值：

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

  7. 输入 RendezvousTransport 的值：

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

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

  8. 单击 “确定” 。

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

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

步骤 3：创建接收端口

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

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

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

步骤 4：创建接收位置

  1. 为要监视的文件接收位置创建文件夹，例如 C:\Filesource。

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

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

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

  5. 输入之前为 “接收 文件夹”属性创建的文件夹的位置，然后单击“ 确定”。

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

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

步骤 5：从架构生成文档实例

  1. 在 Visual Studio 中，右键单击“解决方案资源管理器中的 Schema.xsd”，然后单击“属性”。

  2. 在属性窗口，单击以选择“常规”部分下的“输出实例文件名”选项。

  3. 单击省略号按钮 (...) 显示 “选择输出文件 ”对话框。

  4. 指定输出文件实例的文件夹和名称，例如 ，C:\instance.xml 并单击“ 保存”。

    注意

    请勿指定为此处的文件接收位置指定的文件夹位置。

  5. 在 解决方案资源管理器 中右键单击“Schema.xsd”，然后单击“生成实例”以在指定位置生成文档实例。

步骤 6：更新生成的文档实例

  1. 在文本编辑器中打开生成的文档实例， (记事本工作) ，并编辑文档实例的内容，以确保数据将在 TIBCO 系统中生成唯一记录。 例如，以下代码显示数据文件的第一部分：

    <ns0:Root xmlns:ns0="http://TibcoRendezvousOneWaySend.TibcoRendezvousOneWaySendSchema">  
    <Name>Punya Palit</Name>  
    <MailAddress>Prose Ware, Inc.</MailAddress>  
</ns0:Root>

  2. 保存修改后的文档实例。

步骤 7：生成和部署项目

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

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

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

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

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

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

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

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

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

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

    参数 值
    主机 BizTalkServerApplication
    FileReceivePort TIBCORndOneWayFileRP
    TibcoRendezvousSend TIBCORndOneWaySP

  6. 单击“确定”。

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

步骤 9：删除文档并检查 TIBCO 系统

  • 将早期创建的文档实例复制到应用程序监视的文件接收文件夹。

  • 使用 TIBCO Web 界面验证是否已从 XML 文件中的数据创建记录。

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

  1. 文件适配器从文件夹中检索文件，并作为 BizTalk 消息将其发布到 MessageBox。

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

  3. 业务流程实例使用业务流程中指定的逻辑处理该消息，并将该消息发布回 MessageBox。

  4. TIBCO 发送端口订阅此发布消息，以便 BizTalk 消息引擎将消息发送到 TIBCO 发送端口。

  5. 发送端口将消息传给用于 TIBCO Rendezvous 的 BizTalk 适配器。

  6. 用于 TIBCO Rendezvous 的 BizTalk 适配器将消息发送给 TIBCO 系统。

另请参阅

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