Compartir a través de

Cómo: Convertir un documento de texto en XML y enrutar a una ubicación de archivo mediante una lista de distribución de itinerarios

Objetivo

En la sección se muestra cómo crear una canalización que convertirá un documento de texto en XML y, a continuación, seleccionará el itinerario adecuado y enrutará el mensaje a una ubicación FILE.

En este tema de cómo-hacer, realizarás los siguientes pasos:

  • Use una canalización para recibir un documento de archivo plano y convertirlo en XML.

  • Configurar el componente de canalización Selector de Itinerarios para resolver el plan de ruta adecuado.

  • Cree una rampa que use la canalización personalizada.

  • Pruebe el enrutamiento basado en itinerarios de un mensaje de archivo plano.

Prerrequisitos

Los procedimientos de este tema de cómo hacerlo requieren completar los requisitos previos para las actividades de desarrollo.

Antes de empezar

Complete las siguientes tareas antes de realizar los pasos que se indican más adelante en este tema de procedimientos:

  • Implemente el itinerario DataFormatTransformation .

  • Cree el mensaje de prueba.

    Los procedimientos siguientes describen cómo realizar cada uno de estos procedimientos.

Para desplegar el itinerario de transformación de formato de datos

  1. En Visual Studio, puede abrir C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation\DataFormatTransformation.sln.

  2. En el Explorador de soluciones, en el proyecto Itinerary.Library , haga doble clic en DataFormatTransformation.itinerary para abrirlo en el Diseñador de itinerarios.

  3. En Visual Studio, haga clic en la superficie de diseño de DataFormatTransformation.itinerary. En la ventana DataFormatTransformation.itinerary Properties (Propiedades de DataFormatTransformation.itinerary ), configure las siguientes propiedades:

    1. En la lista desplegable Estado del itinerario , haga clic en Implementar.

    2. En la lista desplegable Exportador de modelos, haga clic en Exportador de itinerarios de base de datos.

    3. Haga clic en el botón de puntos suspensivos (...) situado junto a la propiedad Base de datos de itinerarios .

    4. En el cuadro de diálogo Propiedades de conexión , elija el servidor SQL Server que hospeda la base de datos del repositorio de itinerarios y, a continuación, especifique el nombre de la base de datos (el nombre predeterminado es EsbItineraryDb).

  4. Guarde todos los artefactos del proyecto.

  5. En Visual Studio, haga clic con el botón derecho en la superficie de diseño del itinerario DataModelTransformation y, a continuación, haga clic en Exportar modelo.

Para crear la canalización de recepción

  1. En Visual Studio, haga clic con el botón derecho en DataFormatTransformation.Schemas y, a continuación, haga clic en Propiedades. Haga clic en Aplicación, a continuación, escriba GlobalBank.ESB.DataFormatTransformation.Schemas en el cuadro Nombre del ensamblado.

  2. Haga clic con el botón derecho en DataFormatTransformation.Schemas y, a continuación, haga clic en Propiedades. Haga clic en Firma y compruebe que la casilla Firmar el ensamblado está activada y que la ubicación del ensamblado apunta a .\.. \.. \.. \.. \.. \keys\Microsoft.Practices.ESB.snk.

  3. Haga clic con el botón derecho en DataFormatTransformation.Pipelines y, a continuación, haga clic en Quitar.

  4. Haga clic con el botón derecho en DataFormatTransformation, seleccione Agregar y, a continuación, haga clic en Nuevo proyecto. Haga clic en Proyectos de Biztalk, y luego haga clic en Proyecto vacío de Biztalk Server. En el cuadro Nombre , escriba DataFormatTransformationReceive.Pipeline.

  5. Haga clic con el botón derecho en DataFormatTransformationReceive.Pipeline y, a continuación, haga clic en Propiedades. Haga clic en Firma y compruebe que la casilla Firmar el ensamblado está activada y que la ubicación del ensamblado apunta a C:\projects\Microsoft.Practices.ESB\keys\Microsoft.Practices.ESB.snk.

  6. Haga clic con el botón derecho en DataFormatTransformationReceive.Pipeline, seleccione Agregar y, a continuación, haga clic en Nuevo elemento.

  7. En el cuadro de diálogo Agregar nuevo elemento, haga clic en Tubería de recepción en el panel Plantillas. En el cuadro Nombre , escriba ItinerarySelectReceiveFF y, a continuación, haga clic en Agregar.

  8. Haga clic con el botón derecho en Referencias para el proyecto DataFormatTransformationReceive.Pipeline y, a continuación, haga clic en Agregar referencia. Haga clic en la pestaña Proyectos y, a continuación, haga clic en DataFormatTransformation.Schemas. Haga clic en Aceptar para agregar la referencia.

  9. En la Caja de herramientas, arrastre un componente de canalización de desensamblador de archivos planos a la etapa Desensamblaje de la canalización.

  10. En la ventana Propiedades para desensamblar el archivo plano, haga clic en DataModelTransformation.Schemas.NAOrderDocFF en la lista desplegable Esquema de documento.

  11. En la Caja de herramientas, arrastre un componente de canalización Selector de itinerarios de ESB a la etapa Resolver entidad de la canalización.

  12. En el Cuadro de herramientas, arrastre un componente de canalización ESB Dispatcher a la fase Resolver Parte de la canalización y colóquelo en el componente de canalización Selector de Itinerarios de ESB.

  13. Guarde todos los artefactos del proyecto.

Para crear el mensaje de prueba

  1. Haga clic una vez en el archivo de esquema NAOrderDocFF.xsd del proyecto DataFormatTransformation.Schemas. En el panel Propiedades de Visual Studio, cambie las dos propiedades siguientes:

    • Generar tipo de salida de instancia. Haga clic en la lista desplegable de esta propiedad para cambiarla a Nativa.

    • Nombre de archivo de instancia de salida. Haga clic en el botón de puntos suspensivos (...) para esta propiedad y acepte la ruta de acceso predeterminada de C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation. En el cuadro Nombre de archivo , escriba NAOrderDocFF y, a continuación, haga clic en Guardar.

  2. Haga clic con el botón derecho en NAOrderDocFF.xsd en DataFormatTransformation.Schemas y, a continuación, haga clic en Generar instancia. En este momento, debe tener un nuevo archivo generado en el directorio C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation.

  3. Copie (no mover) el archivo NAOrderDocFF.txt de C:\Projects\Microsoft.Practices.ESB\Source\Samples\DataFormatTransformation a C:\HowTos.

    Nota:

    Este es el mensaje que recibirá y convertirá en XML. Este documento representa una versión de archivo plano del documento de pedido norteamericano.

Pasos

Para implementar la canalización de recepción y el esquema

  1. Haga clic con el botón derecho en DataFormatTransformationReceive.Pipeline y, a continuación, haga clic en Propiedades. Haga clic en Implementación y escriba Microsoft.Practices.ESB en el cuadro Nombre de la aplicación .

  2. Haga clic con el botón derecho en el proyecto DataFormatTransformation.Schemas y, a continuación, haga clic en Propiedades. Haga clic en Implementación y escriba Microsoft.Practices.ESB en el cuadro Nombre de la aplicación .

  3. Cierre los paneles Properties para DataFormatTransformationReceive.Pipeline y DataFormatTransformation.Schemas.

  4. En el Explorador de soluciones, haga clic con el botón derecho en el proyecto DataFormatTransformation y, a continuación, haga clic en Implementar solución.

Para crear y configurar una rampa de ESB

  1. Haga clic en Iniciar en la barra de tareas, seleccione Todos los programas, BizTalk Server y, a continuación, haga clic en Administración de BizTalk Server.

  2. En la Consola de administración de BizTalk Server, expanda Grupo de BizTalk, expanda Aplicaciones, y luego haga clic en Microsoft.Practices.ESB.

  3. Haga clic con el botón derecho en Ubicaciones de recepción, seleccione Nuevo y luego haga clic en Ubicación de recepción unidireccional.

  4. En el cuadro de diálogo Seleccionar un puerto de recepción , haga clic en OnRamp.Itinerary y, a continuación, haga clic en Aceptar.

  5. En el cuadro de diálogo Propiedades de ubicación de recepción , en el cuadro Nombre , escriba OnRamp.Itinerary.FlatFile.FILE.

  6. En la lista desplegable Tipo , haga clic en ARCHIVO y, a continuación, haga clic en Configurar.

  7. En el cuadro de diálogo Propiedades de transporte de archivos , en el cuadro Carpeta de recepción , escriba C:\HowTos\DropFolder.

  8. En el cuadro de diálogo Propiedades de transporte de archivos , en el cuadro Máscara de archivo , escriba *.txty, a continuación, haga clic en Aceptar.

Para configurar el componente de canalización selector de itinerarios

  1. En el cuadro de diálogo Propiedades de ubicación de recepción, haga clic en ItinerarySelectReceiveFF en la lista desplegable Canalización de recepción y, a continuación, haga clic en el botón de elipsis (...).

  2. Use el cuadro de diálogo Configurar canalización para configurar las siguientes propiedades del componente Selector de itinerarios :

    1. Haga clic en la propiedad ItineraryFactKey y, a continuación, escriba Resolver.Itinerary.

    2. Haga clic en la propiedad ResolverConnectionString , escriba ITINERARY:\\name=DataFormatTransformation; a continuación, haga clic en Aceptar.

  3. Haga clic en Aceptar para cerrar el cuadro de diálogo Propiedades de ubicación de recepción .

  4. En la Consola de administración de BizTalk Server, haga clic con el botón derecho en la ubicación de recepción OnRamp.Itinerary.FlatFile.FILE y, a continuación, haga clic en Habilitar.

Para probar el enrutamiento basado en itinerarios de un mensaje de archivo plano

  1. En el Explorador de Windows, vaya a C:\HowTos.

  2. Copiar (no mover) NAOrderDocFF.txt a C:\HowTos\DropFolder.

  3. Navegar hasta C:\HowTos\Out. Verify that the DFT%MessageID%.xml mensaje ha sido escrito en el directorio.

  4. En la Consola de administración de BizTalk Server, haga clic con el botón derecho en la ubicación de recepción OnRamp.Itinerary.FlatFile.FILE y, a continuación, haga clic en Deshabilitar.

  5. Una vez deshabilitada la ubicación de recepción OnRamp.Itinerary.FlatFile.FILE , haga clic con el botón derecho en ella y, a continuación, haga clic en Eliminar. En el cuadro de diálogo Confirmar eliminación de ubicación de recepción, haga clic en Sí.

Recursos adicionales

Para obtener más información, vea los siguientes temas relacionados: