Compartir a través de

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

  • Artículo

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 procedimientos, completará los pasos siguientes:

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

  • Configure el componente de canalización selector de itinerarios para resolver la lista de distribución adecuada.

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

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

Requisitos previos

Los procedimientos de este tema de procedimientos requieren la finalización de los requisitos previos para las actividades de desarrollo.

Antes de empezar

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

  • Implemente el itinerario DataFormatTransformation .

  • Cree el mensaje de prueba.

    En los procedimientos siguientes se describe cómo realizar cada una de estas acciones.

Para implementar el itinerario DataFormatTransformation

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

  2. En Explorador de soluciones, en el proyecto Itinerary.Library, haga doble clic en DataFormatTransformation.itinerary para abrirlo en el Designer Itinerario.

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

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

    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 (...) junto a la propiedad Base de datos de itinerarios .

    4. En el cuadro de diálogo Propiedades de conexión, elija el 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 y 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 Firmay, a continuación, 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 Biztalky, a continuación, haga clic en Proyecto de Biztalk Server vacío. 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 Firmay, a continuación, 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 Recibir canalizació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 el Cuadro de herramientas, arrastre un componente de canalización de desensamblador de archivos planos a la fase Desensamblado de la canalización.

  10. En el ventana Propiedades para el desensamblado de archivos planos, haga clic en DataModelTransformation.Schemas.NAOrderDocFF en la lista desplegable Esquema de documento.

  11. En el Cuadro de herramientas, arrastre un componente de canalización selector de itinerarios de ESB a la fase Resolver parte de la canalización.

  12. En el Cuadro de herramientas, arrastre un componente de canalización de 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 mueva) 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 de Norteamérica.

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 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 Aplicacionesy, a continuación, haga clic en Microsoft.Practices.ESB.

  3. Haga clic con el botón derecho en Ubicaciones de recepción, seleccione Nuevoy, a continuación, 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 ItinerarioSeleccionarReceiveFF en la lista desplegable Canalización de recepción y, a continuación, haga clic en el botón de puntos suspensivos (...).

  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 y , 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. Copie (no mueva) NAOrderDocFF.txt a C:\HowTos\DropFolder.

  3. Vaya a C:\HowTos\Out. Compruebe que el mensaje DFT%MessageID%.xml se ha 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 ubicación de recepción de eliminación , haga clic en Sí.

Recursos adicionales

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