FlatFileReceive (ejemplo de BizTalk Server)
El ejemplo FlatFileReceive muestra cómo puede usar BizTalk Server para procesar un archivo sin formato en el archivo .xml equivalente.
Descripción del ejemplo
Este ejemplo configura la carpeta FFInput como ubicación de recepción. Cuando se coloca un archivo, como el archivo de ejemplo FlatFileReceive_in.txt, en esta carpeta, BizTalk Server procesa el mensaje de este archivo mediante los siguientes pasos:
Lee el mensaje del archivo de entrada en la carpeta FFInput de la ubicación de recepción.
En la canalización de recepción, el componente Desensamblador de archivo sin formato convierte el mensaje sin formato en el mensaje XML equivalente.
En la base de datos de cuadro de mensajes, el mensaje se enruta a un puerto de envío FILE que escribe el mensaje XML en un archivo de la carpeta del adaptador de envío FFOutput.
Cómo se ha diseñado este ejemplo y por qué
El mensaje de ejemplo determina la mayor parte del diseño básico de este ejemplo. Los mensajes de archivos sin formato se deben desensamblar con el Desensamblador de archivo sin formato y un esquema de archivo sin formato en la canalización de recepción personalizada. Estos y otros elementos de diseño se resumen en la siguiente tabla.
| Elemento de diseño | Razones seleccionadas |
|---|---|
| Canalización de recepción personalizada | - La canalización personalizada usa el desensamblador de archivos planos y un esquema de archivo plano para traducir los mensajes de pedido de compra entrantes. El Desensamblador de archivos sin formato no es una canalización y no puede utilizarse al configurar una canalización de recepción en la consola de administración de BizTalk Server. |
| Esquema de archivos sin formato | - Defina todas las mismas características de registro y campo (incluida la estructura) que un esquema XML y proporcione un mecanismo para definir todas las características de archivo plano necesarias para traducir un mensaje de instancia de archivo plano en un mensaje de instancia XML equivalente (o viceversa). |
| Filtro de suscripción | - El filtro de suscripción realiza el enrutamiento real mediante la captura de mensajes que cumplen uno o varios criterios basados en campos de propiedad. |
| XMLTransmit | - Realiza un ensamblado básico de mensajes XML salientes cuando sea necesario. La canalización PassThruTransmit no ofrece compatibilidad adicional. |
Estos elementos se combinan para producir una solución que acepta mensajes de pedido de compra en archivos sin formato en la ubicación de recepción y escribe la representación XML resultante en la ubicación de envío.
Las siguientes consideraciones se aplican al diseño de este ejemplo:
El esquema de archivo sin formato (PO.xsd) contiene anotaciones ampliadas que describen la estructura del archivo de pedido sin formato. Estos archivos se pueden crear manualmente, pero muchos pueden generarse mediante el asistente para archivos sin formato.
El esquema de archivo sin formato utiliza un valor de elementFormDefault de Unqualified. De este modo, se generan resultados correctos pero con calificaciones del espacio de nombres XML (xmlns) adicionales e inesperadas. Para evitar este problema, use un valor Qualified para elementFormDefault.
XMLTransmit se utiliza como la canalización de envío. Utilice la canalización PassThruTransmit cuando no resulte necesario realizar la degradación de la propiedad u otro procesamiento de mensajes en el puerto de envío.
Ubicación del ejemplo
<Ruta de acceso> de ejemplos\Pipelines\AssemblerDisassembler\FlatFileReceive\
En la tabla siguiente se enumeran los archivos del ejemplo y se describe su propósito.
| Archivos | Descripción |
|---|---|
| Cleanup.bat | Se utiliza para anular la implementación de ensamblados y quitarlos de la caché de ensamblados global. Quita los puertos de envío y recepción. Quita los directorios virtuales de los Servicios de Microsoft Internet Information (IIS) según sea necesario. |
| FFReceivePipeline.btp | Archivo de canalización de recepción de BizTalk Server con el componente Desensamblador de archivo sin formato. |
| FlatFileReceive.btproj, FlatFileReceive.sln | Archivos de proyectos y de soluciones de este ejemplo. |
| FlatFileReceive_in.txt | Archivo de entrada de ejemplo. |
| FlatFileReceiveBinding.xml | Se usa para la configuración automatizada, como el enlace de puertos. |
| PO.xsd | Esquema del archivo sin formato entrante. |
| Setup.bat | Se utiliza para crear e iniciar este ejemplo. |
Uso del ejemplo
Use este ejemplo como base para su propia solución de procesamiento de archivos sin formato. Puede ampliar muchos de los elementos de diseño usados en este ejemplo para cumplir sus propios requisitos.
Crear e inicializar este ejemplo
En una ventana de comandos, desplácese a la siguiente carpeta:
<Ruta de acceso> de ejemplos\Pipelines\AssemblerDisassembler\FlatFileReceive
Ejecute el archivo Setup.bat que realiza las acciones siguientes:
Crea la carpeta de entrada (FFInput) y la carpeta de salida (FFOutput) para este ejemplo en la carpeta:
<Ruta de acceso> de ejemplos\Pipelines\AssemblerDisassembler\FlatFileReceive
Compila e implementa el proyecto de Visual Studio para este ejemplo.
Crea y enlaza la ubicación de recepción de BizTalk Server y los puertos de envío y recepción.
Nota
En este ejemplo se muestra la siguiente advertencia al crear y enlazar puertos:
Warning: Receive handler not specified for receive location "FlatFileReceive_RL"; updating with first receive handler with matching transport type.puede omitir estas advertencias de forma segura. (Para dar cabida a posibles diferencias de nombre en las instalaciones de usuario, se han omitido del archivo de enlace el nombre del host y el controlador de recepción).Habilita la ubicación de recepción e inicia el puerto de envío.
Nota
Debe confirmar que BizTalk Server no ha notificado ningún error durante el proceso de generación e inicialización antes de intentar ejecutar este ejemplo.
Nota
Si selecciona abrir y crear el proyecto de este ejemplo sin ejecutar Setup.bat, debe crear, en primer lugar, un par de claves de nombre seguro mediante la utilidad de nombre seguro de .NET Framework (sn.exe). Utilice este par de claves para firmar el ensamblado resultante.
Nota
Para deshacer los cambios realizados por Setup.bat, ejecute Cleanup.bat. Debe ejecutar Cleanup.bat antes de ejecutar Setup.bat por segunda vez.
Ejecución del ejemplo
Guarde una copia del archivo FlatFileReceive_in.xml en la carpeta FFInput.
Observe el archivo .xml creado en la carpeta FFOutput. El nombre del archivo de salida se basa en el GUID de Id. del mensaje. Este archivo contiene el equivalente XML del archivo sin formato situado en la carpeta de recepción.
Clases o métodos usados en el ejemplo
Las secuencias de comandos de configuración Setup.bat y Cleanup.bat se basan en las siguientes secuencias de comando administrativas del instrumental de administración de Windows (WMI):
Iniciar puerto de envío\StartSendPort.vbs
Habilitar ubicación de recepción\EnableRecLoc
Quitar puerto de envío\RemoveSendPort
Los archivos por lotes de instalación y de limpieza usan BTSTask de la siguiente forma:
BTSTask ImportBindings para aplicar el archivo de enlace y crear la aplicación, los puertos y los enlaces
BTSTask RemoveApp para quitar flatFileReceiveApplication
Consulte también
- Pipelines\AssemblerDisassembler (carpeta de ejemplos de BizTalk Server)
- Desensamblador de archivos sin formato [componente de canalización]
- Esquemas de archivos sin formato
- Canalizaciones predeterminadas
- Ejemplos de script de WMI en la guía de la interfaz de usuario y la referencia del espacio de nombres de api para desarrolladores
- Referencia de línea de comandos de BTSTask
- FlatFileSend (ejemplo de BizTalk Server)