Tutorial: Uso de descriptores de mensajes EMS de TIBCO

Información general

En este tutorial se muestra cómo usar las propiedades de contexto de BizTalk Server para establecer los campos de descriptor de mensajes de TIBCO Enterprise Message Service (EMS) en la orquestación. El tutorial supone que dispone de una orquestación que recibe un mensaje de un puerto de recepción y lo envía a un puerto de envío enlazado al adaptador de Microsoft BizTalk para TIBCO Enterprise Message Service.

En el siguiente procedimiento se muestra cómo cambiar la prioridad del mensaje de TIBCO EMS mediante el cambio del valor de la propiedad de contexto TibcoEMS.Priority. En BizTalk Server, los mensajes son inmutables. Por lo tanto, para cambiar un valor de propiedad, debe crear y modificar un nuevo mensaje. Puede crear y modificar el nuevo mensaje mediante la inserción de una forma de asignación del mensaje entre las formas de envío y recepción. No obstante, debe hacer referencia, en primer lugar, al esquema DLL para obtener acceso a las propiedades TIBCO EMS.

Referencia al archivo DLL de esquema

1. En Visual Studio, abra el proyecto de BizTalk Server y abra Explorador de soluciones .

2. Haga clic con el botón derecho en Referencias y seleccione Agregar referencia.

   Aparecerá el cuadro de diálogo Agregar referencia.

3. Haga clic en la pestaña Examinar .

   Aparece el cuadro de diálogo Seleccionar componente .

4. Busque <TIBCO EMS_Adapter_installation_directory>\bin y seleccione Microsoft.Adapters.TibcoEMSProperties.dll.

5. Haga clic en Abrir.

   El archivo DLL aparece en los componentes seleccionados en el cuadro de diálogo Agregar referencia .

6. Haga clic en Aceptar y, a continuación, haga doble clic en la orquestación para acceder a la Designer de orquestación.

7. En el menú Ver , seleccione Otras ventanas y, a continuación, haga clic en Vista de orquestación.

8. En la vista Orquestación, haga clic con el botón derecho en Mensajes y seleccione Nuevo mensaje.

9. Edite las nuevas propiedades del mensaje y asigne un tipo de mensaje.

   Asignará Message_1 a Message_2. Por lo tanto, se debe asignar el mismo tipo de mensaje a ambos mensajes.

10. En el menú Ver , haga clic en Cuadro de herramientas.

11. Arrastre una forma de asignación de mensajes a la orquestación donde desea crear un mensaje.

12. Edite la forma ConstructMessage_1 externa y seleccione el nuevo mensaje, Message_2, en la propiedad Mensajes construidos .

13. Haga doble clic en la forma MessageAssignment_1 interna.

    Aparecerá el Editor de expresiones de BizTalk.

14. En el Editor de expresiones de BizTalk, escriba el código.

15. En primer lugar, copie un mensaje existente y asigne los valores a las propiedades de contexto de mensaje.

    La sintaxis es Message(property) = value;. Por ejemplo:

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

    Vea TIBCO EMS para obtener una lista de propiedades admitidas que puede usar en el mensaje personalizado.

16. Haga clic en Aceptar para cerrar el Editor de expresiones de BizTalk y guardar el código.

17. Haga clic en la forma Enviar y asigne el mensaje que se va a Message_2.

18. Compruebe que las formas del flujo de mensajes restantes funcionan en el mensaje correspondiente.

19. Haga clic con el botón derecho en el proyecto en Explorador de soluciones y seleccione Compilar.

20. Haga clic con el botón derecho en el proyecto y seleccione Implementar.

21. Seleccione Enlazar, Inscribir e Iniciar en el Explorador de BizTalk para probar la orquestación.

Consulte también

Propiedades de contexto del mensaje EMS de TIBCO