教程:使用 TIBCO EMS 消息描述符

概述

本教程演示了如何使用 BizTalk Server 上下文属性在业务流程中设置 TIBCO Enterprise Message Service (EMS) 消息描述符字段。 该教程假定您已具备一个可执行如下操作的业务流程:从接收端口接收消息并将该消息发送到与用于 TIBCO Enterprise Message Service 的 Microsoft BizTalk 适配器绑定的发送端口。

下面的过程演示了如何通过更改 TibcoEMS.Priority 上下文属性的值来更改 TIBCO EMS 消息的优先级。 在 BizTalk Server 中,消息是不可改变的。 因此,若要更改属性值,必须创建并修改新消息。 通过在接收形状和发送形状之间插入消息赋值形状可以创建和修改新消息。 但是,必须首先引用架构 DLL 才能访问 TIBCO EMS 属性。

引用架构 DLL

  1. 在 Visual Studio 中,打开 BizTalk Server 项目,然后打开 解决方案资源管理器

  2. 右键单击“ 引用”,然后选择“ 添加引用”。

    此时会显示“添加引用”对话框。

  3. 单击“ 浏览 ”选项卡。

    此时将显示 “选择组件 ”对话框。

  4. 找到 <“TIBCO EMS_Adapter_installation_directory>\bin”,然后选择“ Microsoft.Adapters.TibcoEMSProperties.dll”。

  5. 单击 “打开”

    DLL 显示在“添加引用”对话框中的“所选组件”中。

  6. 单击“确定”,然后双击业务流程以访问业务流程Designer。

  7. 在“ 视图 ”菜单上,指向“ 其他窗口”,然后单击“ 业务流程视图”。

  8. 在“业务流程”视图中,右键单击“ 消息 ”,然后选择“ 新建消息”。

  9. 编辑新邮件属性并分配 消息类型

    您会将 Message_1 分配给 Message_2。 因此,您必须为这两个消息分配相同的消息类型。

  10. 在“视图”菜单上,单击“工具箱”

  11. “消息分配” 形状拖到要创建新消息的业务流程上。

  12. 编辑外部ConstructMessage_1形状,并在“ 构造 的消息”属性中选择新邮件Message_2。

  13. 双击内部 MessageAssignment_1 形状。

    随即将显示 BizTalk 表达式编辑器。

  14. 在 BizTalk 表达式编辑器中,键入代码。

  15. 首先复制现有的消息,然后对消息上下文属性赋值。

    语法为 Message(property) = value;。 例如:

    Message_2 = Message_1;  
    Message_2( TibcoEMS.Priority) = 6;  
    

    有关可在自定义消息中使用的受支持属性的列表,请参阅 TIBCO EMS。

  16. 单击“ 确定 ”关闭 BizTalk 表达式编辑器并保存代码。

  17. 单击“发送”形状并分配要Message_2的消息

  18. 请确保其余消息流中的形状对适当的消息执行了操作。

  19. 右键单击解决方案资源管理器中的项目,然后选择“生成”。

  20. 右键单击项目并选择“ 部署”。

  21. 在 BizTalk 资源管理器中选择“绑定”、“登记”和“启动”以测试业务流程。

另请参阅

TIBCO EMS 消息上下文属性