¿Le resultó útil esta página?
Sus comentarios sobre este contenido son muy importantes. Háganos saber su opinión.
¿Tiene comentarios adicionales?
Caracteres restantes: 1500
Exportar (0) Imprimir
Expandir todo

Crear un puente unidireccional XML

Actualizado: mayo de 2015

En esta sección se muestran los pasos para crear un Puente unidireccional XML en un Proyecto de servicio de BizTalk. Puente XMLtienen distintas fases. En este tema:

  1. Agregar el puente al proyecto de servicios de BizTalk

  2. Especifique los esquemas de solicitud para los mensajes XML que procesa Puente XML.

  3. Configurar la fase de descodificación

  4. Configuración de la Fase de validación

  5. Configurar la fase de enriquecimiento y sus propiedades

  6. Configuración de la fase de transformación

  7. Configurar la fase de enriquecimiento (posterior a la transformación)

  8. Configurar la fase Codificar

  1. Cree un Proyecto de servicio de BizTalk. Introducción a un proyecto de Visual Studio muestra los pasos que debes seguir.

  2. Haga clic con el botón secundario en cualquier lugar del área de diseño del Proyecto de servicio de BizTalk y seleccione Propiedades. En Dirección URL del servicio BizTalk, escriba la dirección URL de su Servicios de BizTalk.

  3. En el Cuadro de herramientas, arrastre y coloque Puente unidireccional XML en el área de diseño de Proyecto de servicio de BizTalk. Un archivo . BridgeConfig se agrega a la solución.

  4. Haga clic con el botón secundario en el puente, seleccione Propiedades y especifique las siguientes propiedades:

     

    Nombre de la propiedad Descripción

    Elemento de proyecto asociado

    De solo lectura: Nombre del archivo .BridgeConfig asociado. Para cambiar el nombre del archivo, cambie la propiedad Nombre de la entidad.

    Nombre de la entidad

    El nombre del Puente XML en el área de diseño del Proyecto de servicio de BizTalk. Este nombre debe ser exclusivo para el Proyecto de servicio de BizTalk. El nombre del archivo .BridgeConfig ese el mismo que el valor que especifique aquí.

    Dirección relativa

    La dirección relativa en la que está hospedado el Puente XML en Microsoft Azure. Esta dirección, junto con la dirección URL de Servicios de BizTalk que especificó en el Paso 2, crea la dirección URL completa para el puente.

    Por ejemplo, si la dirección URL de Servicios de BizTalk es MyBizTalkService y la dirección relativa del puente es UpdateCustomers, la dirección URL del extremo en CmdLets es https://MyBizTalkService.biztalk.windows.net/default/UpdateCustomers.

    Tabla de ordenamiento de ruta

    Establezca el orden de enrutamiento del mensaje desde el puente a otros componentes del flujo de mensajes. Vea The Routing Order.

    Dirección de tiempo de ejecución

    La dirección URL pública de extremo en tiempo de ejecución donde se implementará el puente.

    Hacer seguimiento de propiedades

    Configure esta propiedad para definir de qué propiedades del mensaje hace un seguimiento el puente. Vea Seguimiento de los mensajes procesados por el puente.

  5. Haga clic en Guardar.

Un solo Proyecto de servicio de BizTalk puede tener varios puentes y esquemas. Para facilitar el uso y ahorrar tiempo de procesamiento, puede asociar esquemas con puentes. En otras palabras, quizá necesite que un puente específico solo pueda procesar mensajes que se ajusten a un esquema o conjunto de esquemas determinados. En esta sección se enumeran los pasos para crear esta asociación.

  1. Agregue los esquemas a Proyecto de servicio de BizTalk. Introducción a un proyecto de Visual Studio muestra los pasos que debes seguir. Repita este paso a fin de agregar el número de esquemas que necesite para su Proyecto de servicio de BizTalk.

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

    noteNota
    El diseñador de itinerarios es un área de solo lectura. No se puede agregar ni quitar una fase o una actividad en el diseñador de itinerarios.

  3. En el área de diseño del puente, en el cuadro Tipos de mensajes, seleccione el icono de agregar [ Icono Agregar ] para abrir el Selector de tipos de mensajes. En el Selector de tipos de mensajes:

    1. En el cuadro Tipos de mensajes disponibles, seleccione el esquema del mensaje de solicitud.

    2. Seleccione el icono de flecha derecha [ Icono de flecha ] para asociar el esquema de solicitud con el puente.

    3. Seleccione Aceptar. El esquema seleccionado aparece ahora en el cuadro Tipo de mensaje.

      Adicional:

      • No puede agregar varios esquemas a la vez. Para asociar varios esquemas con el puente, repita este paso.

      • Para quitar una asociación de esquema con el puente, seleccione el esquema en el cuadro Tipo de mensaje y, a continuación, presione el icono de eliminación [ Icono de eliminación ].

      • Para reemplazar una asociación de esquema por otra, haga clic en el botón Editar [ Icono Editar ] para volver a abrir el Selector de tipos de mensajes.

  4. Haga clic en Guardar.

La fase de descodificación descodifica un mensaje de texto entrante en un mensaje XML y lo transmite a la fase de validación en el puente Puente unidireccional XML. A diferencia de otras fases del puente, la fase de descodificación no cuenta con una propiedad IsEnabled. La propiedad IsEnabled de una fase define si la fase procesa el mensaje que se transmite a través del puente. La fase de descodificación no incluye esta propiedad, debido que el mensaje está descodificado o no depende del tipo de contenido del mensaje entrante. Si un puente recibe un mensaje de tipo de contenido "text/plain", la fase de descodificación descodifica el mensaje y lo convierte en un mensaje XML. El resto del procesamiento en cada fase dentro del puente se produce en el mensaje XML y no en el mensaje de archivo sin formato. Sin embargo, si el puente recibe un mensaje con cualquiera de los demás tipos de contenido, la fase de descodificación no se activa y el mensaje simplemente pasa a la otra fase.

La fase de descodificación proporciona dos propiedades, On Enter Inspector y On Exit Inspector. Estas propiedades se utilizan para incluir código personalizado como parte del procesamiento de puentes. Vea Cómo incluir un código personalizado en puentes.

En la fase de Validación, es posible especificar si se deben realizar validaciones de esquema en el mensaje de solicitud entrante y si las advertencias de validación se deben propagar de vuelta al cliente como excepciones.

  1. Haga doble clic en el puente para abrir el área de diseño de la Configuración del puente.

  2. Seleccione la Fase de Validación. En Propiedades, establezca IsEnabled a True o False. Si se establece como True, la fase valida el mensaje de solicitud entrante según los esquemas que agregó previamente. Si se establece como False, no habrá validación y el mensaje sencillamente se pasa a la siguiente fase.

    Adicional:

  3. Seleccione la actividad Xml Validate. En Propiedades, establezca la propiedad Report Warnings As Errors a True o False. Si se establece como True, el puente informa de las advertencias como errores que se hayan encontrado durante la validación XML contra un esquema y los devuelve de vuelta al cliente que envió el mensaje de solicitud. Se lanza una advertencia de validación como una excepción y la validación produce un error. Consulte Validación y el modelo de objetos de esquema para comprender las advertencias y los errores en la validación de esquemas XML.

  4. Haga clic en Guardar.

La fase de enriquecimiento habilita el enriquecimiento del mensaje definiendo propiedades, los valores de las cuales pueden obtenerse del encabezado del mensaje (estándar o personalizado), a través de propiedades predeterminadas promocionadas por el sistema Servicios de BizTalk, desde un origen de datos externos (solo tablas Base de datos SQL de Microsoft Azure admitidas) o desde un elemento situado dentro del cuerpo del mensaje. Estas propiedades pueden usarse a continuación para enrutar el mensaje a un extremo de destino o para su posterior procesamiento por la entidad receptora de mensajes. En esta sección se enumeran los pasos necesarios para realizar cada una de las siguientes acciones:

  • Asignar valores de encabezado de mensajes a propiedades.

  • Usar propiedades predeterminadas o del sistema promocionadas por Servicios de BizTalk.

  • Buscar un origen de datos externo

  • Extraer valores de un elemento del cuerpo de mensaje mediante Xpath

Importante:

Puede elegir si desea realizar alguna de estas acciones activando o desactivando la fase de enriquecimiento.

Pasos:

  1. Haga doble clic en el Puente unidireccional XML para abrir el diseñador de itinerarios.

  2. Seleccione la fase de enriquecimiento. En Propiedades, establezca la propiedad IsEnabled en True o False.

    noteNota
    Cuando es True y no hay ninguna propiedad definida, puente no produce error al configurar puente (tiempo de diseño) ni al procesar el mensaje (tiempo de ejecución).

    Adicional:

  3. Dentro de la fase de enriquecimiento, seleccione la actividad enriquecimiento. En Propiedades, seleccione el botón de puntos suspensivos (...) junto a la propiedad Definición de la propiedad para abrir las Definiciones de propiedad.

  4. En Definiciones de propiedad, seleccione Agregar. En Agregar propiedad, puede utilizar valores de diferentes fuentes e incluirlos en el mensaje como propiedades. Estas propiedades y sus valores pueden utilizarse más tarde para otras tareas de procesamiento como el enrutamiento de mensajes a diferentes destinos basados en valores de propiedades (consulte The Routing Action. En la tabla siguiente se enumeran las diferentes fuentes y maneras de agregar propiedades al mensaje.

     

    Origen Conocimientos técnicos

    Asignar valores de encabezado de mensajes a propiedades

     

    Usar propiedades promocionadas por el sistema

     

    Buscar un origen de datos externo

    Extraer valores del mensaje mediante XPath

    To extract values from a message body using xpath

  1. En Agregar propiedad, realice lo siguiente:

    noteNota
    En esta tabla se enumeran únicamente los campos requeridos para el encabezado para la operación de asignación de propiedades, que solamente resulta relevante para los mensajes que se transfieren mediante protocolos de transferencia de mensajes como SOAP, HTTP, FTP y SFTP. Por lo tanto, los siguientes pasos únicamente son relevantes si selecciona HTTP, SOAP, FTP o SFTP de la lista desplegable Tipo. Asimismo, en función de lo que seleccione para la lista desplegable Tipo, los campos obligatorios aparecen destacados en rojo y los otros campos aparecen atenuados.

     

    Sección Nombre de campo Descripción

    Origen (leer de)

    Tipo

    Especifica el tipo de mensaje del cual se extraen los valores de los encabezados. Para asignar valores de encabezado a propiedades, los posibles valores son SOAP, HTTP, FTP, SFTP y Brokered.

    Espacio de nombres del encabezado SOAP (solamente si Tipo se encuentra ajustado en SOAP)

    Especifica el espacio de nombres del encabezado SOAP personalizado. Por ejemplo, en el extracto siguiente, se resalta el espacio de nombres del encabezado personalizado MessageType.

    <s:Header>
       ...
      <MessageType xmlns="http://schemas.microsoft.com/integration/2011/system-properties">http://POAttr.org#PurchaseOrderAttr</MessageType> 
       ...
    </s:Header>
    
    ImportantImportante
    Este campo aparece atenuado si selecciona un encabezado estándar de la lista desplegable Identificador. Deberá introducir un espacio de nombres solamente para los encabezados SOAP personalizados; no obstante, esta propiedad no es obligatoria.

    Este campo también está atenuado si se ajusta Tipo en HTTP, FTP, SFTP o Brokered.

    Identificador

    Especifica el nombre de la propiedad del encabezado del mensaje, el valor del cual desea extraer y asignar a una propiedad que está definiendo en este cuadro de diálogo. Si tomamos el mismo extracto que anteriormente, el identificador sería MessageType.

    También puede especificar aquí encabezados personalizados. Para FTP y SFTP, el cuadro desplegable enumera los identificadores estándar. Para el tipo de mensaje HTTP, debido a que existe una lista enorme de encabezados estándar, el cuadro desplegable no enumera ningún encabezado; puede introducir el nombre del encabezado en tal caso. Asimismo, para los tipos de mensaje SOAP, HTTP y Brokered, también puede enumerar un encabezado personalizado cuyo valor desee asignar a otra propiedad.

    Para entenderlo mejor, vea este ejemplo. Supongamos que el encabezado de un mensaje SOAP tiene el siguiente aspecto:

    <s:Header>
      ...  
      <PONumber xmlns="http://schemas.microsoft.com/integration/promotedpropertiesinfo">PO1234</PONumber> 
      ...  
    </s:Header>
    

    En este extracto, PONumber es un encabezado de SOAP personalizado cuyo valor es PO1234. Por lo tanto, si ajusta el identificador en PONumber, el valor PO1234 se asigna a la propiedad que está definiendo aquí.

    Propiedad (escribir en)

    Nombre de la propiedad

    Especifica el nombre de la propiedad que está definiendo. El valor de esta propiedad se configura en el valor que se extrae de la propiedad del encabezado del mensaje especificado anteriormente.

    Para continuar utilizando el mismo ejemplo que anteriormente, si ajusta el Nombre de la propiedad en P1 y Identifier en PONumber, el valor de P1 se establece en PO1234.

    Tipo de datos

    Especifica el tipo de datos de la propiedad. Puede seleccionar un valor de la lista desplegable.

  2. Haga clic en Aceptar en el cuadro de diálogo Agregar propiedad. Ahora los cuadros de diálogo deberían ser similares a los siguientes:

    Definición de la propiedad

    ¿Qué se describe en esta captura de pantalla? Significa que si el mensaje entrante es un mensaje SOAP con un nombre de encabezado SOAP como PONumber y el espacio de nombres del encabezado como http://schemas.microsoft.com/integration/promotedpropertiesinfo, se creará un P1 con tipo de datos de string y se asigna el valor del encabezado a esta propiedad.

  3. Para actualizar o eliminar una definición de propiedad, puede seleccionar la definición de propiedad en el cuadro de diálogo y hacer clic en Editar o Eliminar. Haga clic en Aceptar en el cuadro de diálogo Definición de la propiedad y, a continuación, haga clic en Guardar para guardar los cambios en Configuración del puente.

  1. En Agregar propiedad, realice lo siguiente:

    noteNota
    En esta tabla solamente se enumeran los campos requeridos para la asignación de propiedades promocionadas por el sistema al mensaje. Asimismo, en función de lo que seleccione para la lista desplegable Tipo, los campos obligatorios aparecen destacados en rojo y los otros campos aparecen atenuados.

     

    Sección Nombre de campo Descripción

    Origen (leer de)

    Tipo

    Para utilizar propiedades promocionadas por el sistema, seleccione Sistema en la lista desplegable.

    Identificador

    Especifica el nombre de la propiedad promocionada por el sistema, el valor del cual desea extraer y asignar a una propiedad que está definiendo en este cuadro de diálogo.

    Propiedad (escribir en)

    Nombre de la propiedad

    Especifica el nombre de la propiedad que está definiendo. El valor de esta propiedad se configura en el valor que se extrae de la propiedad promocionada por el sistema especificada anteriormente.

    Tipo de datos

    Especifica el tipo de datos de la propiedad. Puede seleccionar un valor de la lista desplegable.

  1. En Agregar propiedad, realice lo siguiente:

    noteNota
    En esta tabla solamente se enumeran los campos requeridos para la operación de búsqueda. Por lo tanto, los siguientes pasos únicamente son relevantes si selecciona Búsqueda en la lista desplegable Tipo. Asimismo, en función de lo que seleccione para la lista desplegable Tipo, los campos obligatorios aparecen destacados en rojo y los otros campos aparecen atenuados.

    ImportantImportante
    Para esta versión, únicamente puede buscar desde una tabla Base de datos SQL de Microsoft Azure.

     

    Sección Nombre de campo Descripción

    Origen (leer de)

    Tipo

    Para una operación de búsqueda, seleccione Búsqueda en la lista desplegable.

    Identificador

    En la lista desplegable, seleccione un proveedor ya configurado

    Si no ha configurado un proveedor, configure uno:

    1. En la lista desplegable Identificador, seleccione Configurar nuevo.

    2. En el cuadro de diálogo Configuración de proveedor, especifique los valores siguientes:

       

      Nombre de campo Descripción

      Nombre de proveedor

      Especifique un nombre para el proveedor

      Cadena de conexión

      Especifique una cadena de conexión válida para conectarse a una tabla de Base de datos SQL de Microsoft Azure.

      Nombre de la tabla

      Especifique el nombre de la tabla de Base de datos SQL de Microsoft Azure en la que desea hacer una búsqueda de datos

      Columna de consulta

      Especifique un nombre de columna de la tabla de Base de datos SQL de Microsoft Azure; ese valor se utilizará como consulta de entrada para realizar la búsqueda de datos.

      Columna resultado de la consulta

      Especifique un nombre de columna de la tabla de Base de datos SQL de Microsoft Azure cuyo valor será el valor de salida que se asignará a la propiedad buscada.

    3. Haga clic en Aceptar para agregar la configuración del proveedor.

    Propiedad de búsqueda

    En la lista desplegable, seleccione una propiedad que debe haber definido previamente. El valor de esta propiedad se pasa a la Columna de consulta especificada en la configuración del proveedor definida anteriormente.

    Propiedad (escribir en)

    Nombre de la propiedad

    Especifique un nombre para la propiedad que contiene el valor buscado. El valor de esta propiedad se deriva del valor de la Columna resultado de la consulta de la configuración del proveedor definida arriba.

    Tipo de datos

    Especifica el tipo de datos de la propiedad. Puede seleccionar un valor de la lista desplegable.

  2. Haga clic en Aceptar en el cuadro de diálogo Agregar propiedad. Los cuadros de diálogo deberían ser similares a los siguientes:

    Buscar definición

    ¿Qué describen estos cuadros de diálogo? Este es el modo en el que fluye la lógica (explicado mediante el mismo ejemplo del pedido de compra anterior):

    • El puente busca el valor de P1 (PO1234) en la columna de consulta de entrada (P_Order) en la tabla (TempTable) definida en la configuración del proveedor MyProvider.

    • A continuación, el puente recoge el valor correspondiente a PO1234 desde la columna de la consulta de salida (Cust_Name) en la tabla TempTable.

    • El valor recogido de la columna de consulta de salida se asigna a la propiedad P2. Por ejemplo, si el nombre del cliente corresponde con el pedido de compra PO1234 es John, el valor de P2 se establecerá en John.

    • El tipo de datos de la propiedad P2 está ajustado en string.

  3. Para actualizar o eliminar una definición de propiedad, puede seleccionar la definición de propiedad en el cuadro de diálogo y hacer clic en Editar o Eliminar. Haga clic en Aceptar en el cuadro de diálogo Definición de la propiedad y, a continuación, haga clic en Guardar para guardar los cambios en Configuración del puente.

  1. En Agregar propiedad, realice lo siguiente:

    noteNota
    En esta tabla solamente se enumeran los campos requeridos para la operación de extracción (xpath). Asimismo, en función de lo que seleccione para la lista desplegable Tipo, los campos obligatorios aparecen destacados en rojo y los otros campos aparecen atenuados.

     

    Sección Nombre de campo Descripción

    Origen (leer de)

    Tipo

    Seleccione XPath en la lista desplegable.

    Identificador

    Especifique la consulta xpath para extraer un elemento o un atributo de un mensaje. Este es el aspecto de una consulta XPath:

    /*[local-name()='<root_node>' and namespace-uri()='<namespace>']/*[local-name()='<node_name>' and namespace-uri()=<namespace>']/*@[local-name()='<attribute_name>' and namespace-uri()='<namespace>']
    

    Tipo de mensaje

    Especifica el tipo de mensaje del mensaje del que se debe extraer el elemento o el valor del atributo mediante la consulta xpath.

    La lista desplegable muestra todos los esquemas agregados al Proyecto de servicio de BizTalk. Seleccione el esquema que disponga del elemento que desee extraer.

    Propiedad (escribir en)

    Nombre de la propiedad

    Especifica el nombre de la propiedad que está definiendo. El valor de esta propiedad se configura en el valor que se extrae del cuerpo del mensaje mediante la consulta XPath.

    Tipo de datos

    Especifica el tipo de datos de la propiedad. Puede seleccionar un valor de la lista desplegable.

  2. Haga clic en Aceptar en el cuadro de diálogo Agregar propiedad. Los cuadros de diálogo deberían ser similares a los siguientes:

    Extracción con Xpath

    ¿Qué se describe en este cuadro de diálogo? Significa que desde un tipo de mensaje (PurchaseOrder en este ejemplo), el puente extrae el valor del elemento por la consulta xpath facilitada, lo asigna a la propiedad P3, y ajusta el tipo de datos de la propiedad P3 en doble.

  3. Para actualizar o eliminar una definición de propiedad, puede seleccionar la definición de propiedad en el cuadro de diálogo y hacer clic en Editar o Eliminar. Haga clic en Aceptar en el cuadro de diálogo Definición de la propiedad y, a continuación, haga clic en Guardar para guardar los cambios en Configuración del puente.

En el tiempo de diseño mediante la utilización de la superficie de diseño de Configuración del puente, puede definir las propiedades que se promocionarán y los valores que se les asignarán. Pero la promoción de propiedades y la asignación de valores se produce realmente en el tiempo de ejecución cuando un mensaje fluye a través del puente implementado en el CmdLets. No obstante, en el tiempo de ejecución podría haber instancias cuando la promoción de propiedades falla debido a varios motivos. Utilice la tabla siguiente para comprender cómo y cuándo puede ocurrir:

 

Si esto se produce Qué se promociona

El encabezado SOAP o HTTP que especifica durante el tiempo de diseño no existe en el mensaje real que se envía al puente durante el tiempo de ejecución

La propiedad definida en el tiempo de diseño no se promociona durante el tiempo de ejecución; no se aplica ninguna excepción.

La consulta XPATH que especifica durante el tiempo de diseño no se corresponde con un elemento del mensaje enviado al puente durante el tiempo de ejecución

La propiedad definida en el tiempo de diseño no se promociona durante el tiempo de ejecución; no se aplica ninguna excepción.

Para la búsqueda, si la propiedad Lookup especificada durante el tiempo de diseño no existe en el tiempo de ejecución (debido a que nunca se ha promocionado)

La propiedad a la que se le habría asignado un valor como resultado de la búsqueda no se promociona; no se aplica ninguna excepción.

Para la búsqueda, si la configuración del proveedor que especifica (que incluye la cadena de conexión, el nombre de la tabla, etc.) en el tiempo de diseño es incorrecta.

En el tiempo de ejecución, se aplica una excepción; no se promociona ninguna propiedad. Durante el tiempo de diseño no se aplica ninguna excepción debido a que la superficie de diseño de Configuración del puente no lleva a cabo ninguna validación de la configuración del proveedor.

ImportantImportante
A la hora del diseño solamente se validan las credenciales del usuario y si la validación no es correcta, la implementación falla.

Para la búsqueda, si el valor de la propiedad Lookup especificado en el tiempo de diseño no tiene correspondencia alguna en el origen de los datos del proveedor (tabla Base de datos SQL de Microsoft Azure, en este caso) en el tiempo de ejecución

Se aplica una excepción; no se promociona ningún valor

Para la búsqueda, si el valor de la propiedad Lookup especificado en el tiempo de diseño tiene más de una correspondencia en el origen de los datos del proveedor (tabla Base de datos SQL de Microsoft Azure, en este caso) en el tiempo de ejecución

Se promociona la propiedad y solamente se asigna uno de los valores correspondientes del origen de datos como valor a la propiedad promocionada.

Para SOAP, HTTP, XPATH y Lookup, si el tipo de datos especificado para la propiedad durante el tiempo de diseño no coincide con el tipo de datos del valor que tendrá la propiedad en el tiempo de ejecución

En los casos en los que la conversión del tipo sea posible, el tipo se convertirá y la propiedad se promocionará. Por ejemplo, si en el tiempo de diseño define una propiedad como cadena, pero el valor asignado a dicha propiedad durante el tiempo de ejecución es 30, el valor de dicha propiedad será de “30” (como una cadena).

Cuando la conversión del tipo no es posible, se aplica una excepción y la propiedad no se promociona. Por ejemplo, en el tiempo de diseño define una propiedad como “double” pero el valor asignado a dicha propiedad durante el tiempo de ejecución es “John”. Debido a que “John” no se puede almacenar en la propiedad como “double”, se aplica una ejecución y la propiedad no se promociona.

En esta fase, puede especificar las transformaciones que usará el puente. También puede habilitar o deshabilitar la fase.

  1. Agregue las transformaciones al Proyecto de servicio de BizTalk. Introducción a un proyecto de Visual Studio muestra los pasos que debes seguir. Repita este paso a fin de agregar el número de transformaciones que necesite para su proyecto.

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

  3. Seleccione la fase de Transformación. En Propiedades, establezca IsEnabled a True o False. Si se establece en True, la fase utiliza las transformaciones especificadas para transformar un mensaje de solicitud entrante. Si se establece en False, no habrá transformación de mensaje y el mensaje pasa sencillamente a la siguiente fase.

    Adicional:

  4. Dentro de la fase de Transformación, seleccione la actividad Transformación XML. En Propiedades, seleccione el botón de puntos suspensivos (...) junto a la propiedad Mapas para abrir Selección de mapa.

  5. En la lista de mapas que se muestra, seleccione los mapas que desea asociar con la fase Transformación y, a continuación, seleccione Aceptar. Los mapas que agregó se muestran ahora en Mapas seleccionados en el diseñador de itinerarios.

    ImportantImportante
    El cuadro de diálogo solo muestra los mapas para los que el esquema de origen (del mapa) coincide con el esquema del mensaje de solicitud especificado en Especifique los esquemas de solicitud (en este tema).

    noteNota
    Si la propiedad IsEnabled se establece en True en la fase de Transformación y no especifica ningún mapa como parte de la actividad Transformación XML, el puente no lanza un error ni durante la configuración del puente (tiempo de diseño) ni durante el procesamiento del mensaje (tiempo de ejecución).

    Puede hacer clic en el botón de puntos suspensivos (…) junto a la propiedad Mapa para agregar o quitar un mapa.

  6. Haga clic en Guardar.

La configuración de la fase de enriquecimiento tras una fase de transformación es idéntica a la configuración de una fase de enriquecimiento antes de la fase de transformación. Vea Configurar la fase de enriquecimiento y sus propiedades en este tema. Lo único que hay que tener en cuenta al configurar una fase de enriquecimiento posterior a la transformación es que las propiedades que se definieron en la fase de enriquecimiento anterior a la transformación también estarán disponibles en la fase de enriquecimiento posterior a la transformación. Por lo tanto, si desea conservar esas propiedades, no cree propiedades con el mismo nombre. Si lo hace, la nueva definición de propiedad sobrescribe la anterior definición de propiedad.

La fase enriquecimiento posterior a la transformación también proporciona dos propiedades: On Enter Inspector y On Exit Inspector. Estas propiedades se utilizan para incluir código personalizado como parte del procesamiento de puentes. Vea Cómo incluir un código personalizado en puentes.

En esta fase, puede escribir el esquema de archivo sin formato que se utilizará para convertir un mensaje XML en un mensaje de archivo sin formato. En el momento en que un mensaje alcanza la fase Codificar, ya está en formato XML. Según cómo se haya configurado la fase Codificar, el mensaje se codifica en un formato de archivo plano o se envía como mensaje XML.

  1. Haga doble clic en el Puente unidireccional XML para abrir el diseñador de itinerarios.

  2. Seleccione la fase Codificar. En Propiedades, establezca la propiedad IsEnabled en True o False. Si la establece en True, la fase usa los esquemas de archivo plano que escriba para codificar los mensajes XML en un mensaje de archivo plano. Si la establece en False, no se produce la codificación y el mensaje XML se envía desde el puente.

    Adicional:

  3. Dentro de la fase Codificar, seleccione la actividad Flat File Encode. En Propiedades, haga clic en el botón de puntos suspensivos (…) de la propiedad Esquemas de archivo plano para abrir el cuadro de diálogo Selección de esquema de archivo plano.

  4. En la lista de esquemas de archivo plano que aparece en el cuadro de diálogo, seleccione los esquemas que quiera usar para codificar el mensaje XML en un mensaje de archivo plano y luego haga clic en Aceptar. En tiempo de ejecución, cuando un mensaje XML alcanza la actividad Codificación de archivo plano, el tipo de mensaje (Namespace#Root) se asigna a los esquemas de archivo plano proporcionados como parte de la configuración de la actividad. Si se establece una correspondencia, el esquema se utiliza para convertir el mensaje XML en un mensaje de archivo plano. El encabezado HTTP de los mensajes convertidos se establece en “texto/plano”. Si no se establece una correspondencia, la fase Codificar envía el XML procesado tal cual.

    noteNota
    Si la propiedad IsEnabled se establece en True en la fase Codificar, y no especifica un esquema de archivo plano como parte de la actividad Flat File Encode, el puente no lanza un error ni durante la configuración del puente (tiempo de diseño) ni durante el procesamiento del mensaje (tiempo de ejecución).

    Puede hacer clic en el botón de puntos suspensivos (…) en la propiedad Esquemas de archivo plano para agregar o quitar un esquema.

  5. Haga clic en Guardar.

Se configura el Puente unidireccional XML. Ahora puede conectar el puente a un sistema de línea de negocio, enrutar mensajes y/o implementar el puente:

Conectarse a sistemas LOB desde un proyecto de Servicios de BizTalk

Enrutamiento de mensajes de puentes a destinos en el proyecto de Servicios de BizTalk

Implementar y actualizar el proyecto de Servicios de BizTalk

Vea también

Mostrar:
© 2015 Microsoft