Paso 6: Configurar un puente unidireccional XML

Actualizado: agosto de 2015

Este tema proporciona instrucciones sobre cómo configurar un Puente unidireccional XML. Como parte de la configuración del Puente unidireccional XML, haremos lo siguiente:

  • Configurar el puente para procesar el mensaje de archivo sin formato del tipo que hemos creado con anterioridad.

  • Mediante las propiedades promocionadas, extraer el valor de los registros OrderId (antes de la transformación del mensaje) y TotalAmount (tras la transformación del mensaje). Realizaremos un seguimiento de los valores de esos dos registros cuando el mensaje sea procesado por el puente.

  • Configurar el puente para utilizar el token Map.trfm Transformación que hemos creado con anterioridad.

  • Configurar el puente para realizar un seguimiento de los valores que procese.

  1. Arrastre y coloque un Puente unidireccional XML desde el cuadro de herramientas al área de diseño del Configuración del puente. En el caso de las propiedades Nombre de entidad y Dirección relativa del puente, especifique Procesar pedidos para el valor.

  2. Haga doble clic en el Puente unidireccional XML del diseñador de itinerarios.

  3. En el área de diseño del Puente unidireccional XML, en el cuadro Tipos de mensaje, seleccione el icono para agregar [ Icono Agregar ] para abrir el cuadro de diálogo Selector de tipo de mensaje.

  4. En el cuadro de diálogo Selector de tipo de mensaje, en el cuadro Tipos de mensajes disponibles, seleccione el tipo de mensaje Pedido de compra, seleccione el icono de flecha derecha [ Icono de flecha ] para asociar el esquema de solicitud al Puente unidireccional XMLy, a continuación, haga clic en Aceptar. El esquema que ha seleccionado debe aparecer ahora en la sección Tipo de mensaje de solicitud.

  5. Configure la fase Enriquecimiento previa a la transformación para extraer el valor del elemento Id. de pedido del esquema de origen.

    1. Dentro de la fase Enriquecimiento, seleccione la actividad Enriquecimiento y, en el panel Propiedades, haga clic en el botón de puntos suspensivos (…) de la propiedad Propiedades para abrir el cuadro de diálogo Definición de propiedad.

    2. En Definiciones de propiedades, seleccione Agregar para abrir el cuadro de diálogo Agregar propiedad. En el cuadro de diálogo Agregar propiedad, haga lo siguiente:

       

      Sección Nombre de campo Descripción

      Origen (leer de)

      Tipo

      Seleccione XPath en la lista desplegable.

      Identificador

      Especifique la consulta XPath para extraer el valor del Id. de pedido del esquema de la solicitud.

      TipSugerencia
      Puede obtener la consulta XPath en el editor de esquemas. Seleccione el elemento Id. de pedido en el editor de esquemas y después, en la ventana Propiedades, busque el valor de la propiedad Xpath de instancia. Esa debería ser la consulta XPath para el nodo.

      Tipo de mensaje

      Seleccione el esquema perteneciente al Pedido de compra.

      Propiedad (escribir en)

      Nombre de la propiedad

      Especifica el nombre de la propiedad que está definiendo. Para este tutorial, especifique el Id. de pedido.

      Tipo de datos

      Especifica el tipo de datos de la propiedad. Para este tutorial, especifique la cadena.

    3. Haga clic en Aceptar en el cuadro de diálogo Agregar propiedad y, a continuación, haga clic en Aceptar en el cuadro de diálogo Definición de propiedad.

  6. Configure el puente para utilizar la Transformación creada con anterioridad. Dentro de la fase Transformación, seleccione la actividad Transformación XML y, a continuación, en la ventana Propiedades, seleccione el botón de puntos suspensivos (…) de la propiedad Maps para abrir el cuadro de diálogo Selección de mapa.

    En la lista de Transformacións que se muestra en el cuadro de diálogo, seleccione Map.trfm. Esta Transformación ha sido creada por usted en pasos anteriores.

  7. Configurar la fase Enriquecimiento posterior a la transformación para extraer el valor del elemento Cantidad total del esquema de origen.

    1. Dentro de la fase Enriquecimiento, seleccione la actividad Enriquecimiento y, en el panel Propiedades, haga clic en el botón de puntos suspensivos (…) de la propiedad Propiedades para abrir el cuadro de diálogo Definición de propiedad.

    2. En el cuadro de diálogo Definiciones de propiedad, seleccione Agregar para abrir el cuadro de diálogo Agregar propiedad. En el cuadro de diálogo Agregar propiedad, haga lo siguiente:

       

      Sección Nombre de campo Descripción

      Origen (leer de)

      Tipo

      Seleccione XPath en la lista desplegable.

      Identificador

      Especifique la consulta XPath para extraer el valor de la Cantidad total del esquema de la solicitud.

      Tipo de mensaje

      Seleccione el esquema perteneciente a Insertar.

      Propiedad (escribir en)

      Nombre de la propiedad

      Especifica el nombre de la propiedad que está definiendo. Para este tutorial, especifique la Cantidad total.

      Tipo de datos

      Especifica el tipo de datos de la propiedad. Especifique largo.

    3. Haga clic en Aceptar en el cuadro de diálogo Agregar propiedad y, a continuación, haga clic en Aceptar en el cuadro de diálogo Definición de propiedad.

    4. Guarde los cambios realizados en el proyecto.

  8. Configure el puente para realizar un seguimiento de las propiedades del mensaje y otros datos para las propiedades Id. de pedido y Cantidad total que acaba de promocionar.

    1. Vuelva al archivo MessageFlowItinerary.bcs, seleccione el Puente unidireccional XML y, en la ventana Propiedades, seleccione los puntos suspensivos (...) de Hacer seguimiento de propiedades.

    2. Active la casilla Hacer seguimiento de eventos de procesamiento de mensajes para hacer un seguimiento de información detallada, por ejemplo cuándo una fase se inicia, se completa o produce errores; cuándo una actividad de una fase se inicia, se completa o produce errores; si se recupera un artefacto, etc.

    3. Opcional. Active la casilla Hacer seguimiento de todas las propiedades de mensaje y, a continuación, seleccione las propiedades de las que desea realizar el seguimiento. Tenga en cuenta que en el cuadro de diálogo se enumeran las propiedades que usted ha promocionado dentro de cualquiera de las fases de Enriquecimiento de un puente.

      Para este tutorial, seleccione Id. de pedido y Cantidad total.

    4. Seleccione Aceptar.

  9. Guarde la configuración del puente y vuelva al área del diseñador de Configuración del puente.

  10. Conecte el componente de origen FTP al Puente unidireccional XML y el puente a la entidad de Retransmisión de LOB.

  11. Establezca la condición de filtro en el conector entre el puente y la entidad de Retransmisión de LOB.

    1. Seleccione el conector entre el Puente unidireccional XML y la entidad de Retransmisión de LOB.

    2. En la ventana Propiedades, seleccione el botón de puntos suspensivos (…) de Condición de filtro.

    3. En el cuadro de diálogo Configuración de filtro de enrutamiento, establezca la condición de filtro en Coincide con todo.

    4. Seleccione Aceptar.

  12. Establezca la acción de enrutamiento de modo que el mensaje saliente a la aplicación de LOB tenga un encabezado de acción SOAP.

    1. Abra el Explorador de servidores y navegue a la Retransmisión de LOB de SQL Server que hemos creado con anterioridad. Haga clic con el botón secundario en la retransmisión, seleccione Propiedades y, para la propiedad Operaciones, copie el valor de la primera operación.

    2. En el área de diseño de Configuración del puente, haga clic en el conector entre Puente unidireccional XML y la entidad de Retransmisión de LOB.

    3. En Propiedades, seleccione el botón de puntos suspensivos (…) de Acción de enrutamiento. En Acciones de enrutamiento, seleccione Agregar para abrir el cuadro de diálogo Agregar acción de enrutamiento. En el cuadro de diálogo Agregar acción de enrutamiento, haga lo siguiente:

    4. En la sección Propiedad (leer de), seleccione Expresión y peque el valor que ha copiado.

      ImportantImportante
      Siempre debe especificar el valor de una expresión entre comillas simples.

    5. En la sección Destino (escribir en), establezca el Tipo en SOAP y el Identificador en Acción.

      ImportantImportante
      Siempre debe especificar el valor de una expresión entre comillas simples.

    6. Seleccione Aceptar en el cuadro de diálogo Agregar acción de enrutamiento para agregar la acción de enrutamiento. Seleccione Aceptar en el cuadro de diálogo Acciones de enrutamiento y, a continuación, seleccione Guardar para guardar los cambios en un Proyecto de servicio de BizTalk.

Vea también

Mostrar: