EnvelopeProcessing (ejemplo de BizTalk Server)
El ejemplo EnvelopeProcessing muestra cómo procesar mensajes y sobres de mensajes en las canalizaciones de BizTalk Server. Además, muestra cómo procesar mensajes de archivos sin formato en mensajes XML.
Descripción del ejemplo
Este ejemplo configura la carpeta EnvInput como ubicación de recepción. Cuando se coloca un archivo en esta carpeta, como el archivo de ejemplo EnvelopeProcessing_in.txt, BizTalk Server procesa los mensajes de este archivo mediante los siguientes pasos:
BizTalk Server recupera el archivo de mensajes de la carpeta de la ubicación de recepción EnvInput.
En la canalización de recepción, el componente de canalización Desensamblador de archivos sin formato quita el encabezado y el finalizador de los mensajes de archivos sin formato, y los analiza en mensajes individuales.
En la base de datos de cuadro de mensajes, los mensajes se enrutan al puerto de envío mediante filtros de suscripción.
En la canalización de envío del puerto de envío, el componente de canalización Ensamblador de XML incluye los sobres XML y después los incluye en la carpeta del adaptador de envío EnvOutput.
Cómo se ha diseñado este ejemplo y por qué
El diseño de este ejemplo tenía que adaptarse a dos requisitos básicos:
Recibir y procesar un mensaje de archivo sin formato que contenga uno o varios pedidos.
Enviar un mensaje XML que contenga un pedido e información del remitente a un directorio para que un sistema de procesamiento de servidor lo recoja.
Para cumplir estos requisitos, se utilizó una combinación de esquemas de archivos sin formato y XML, así como canalizaciones personalizadas. 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 | - Usa el desensamblador de archivos planos y esquemas de archivos planos para traducir mensajes de pedido de compra entrantes. |
| Esquemas de archivos sin formato para el encabezado, el cuerpo y el finalizador del mensaje. | - Define todas las mismas características de registro y campo (incluida la estructura) que los esquemas XML y proporciona 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). - Los esquemas de encabezado, cuerpo y finalizador se usan para dividir el cuerpo en fragmentos discretos para su procesamiento. |
| Esquema de sobre | - Se usa para encapsular pedidos de compra individuales con información del encabezado. |
| 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. |
| Canalización de envío personalizada | - Usa el ensamblador XML y una combinación de esquemas de sobre y cuerpo para traducir los mensajes de instancia a formato XML. |
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 del pedido (PO.xsd) usa un valor Unqualified para elementFormDefault. De este modo, se generan resultados correctos pero con calificaciones xmlns adicionales e inesperadas. Para evitar este problema, use un valor Qualified para elementFormDefault.
Los esquemas de archivo sin formato de encabezado y finalizador se usan para separar los datos iniciales y finales del mensaje. Las propiedades del esquema de encabezado, el documento y el finalizador del desensamblador de archivos sin formato se establecen como el esquema de encabezado, pedido y finalizador, respectivamente.
El esquema de sobre XML combina elementos del encabezado y del pedido para generar un único mensaje XML. El esquema de encabezado promueve el campo Source en el campo SourceParty del espacio de nombres BTS.bts_system_properties ; El esquema de sobre promueve este mismo valor, lo que hace que se desbate en el mensaje saliente.
Ubicación del ejemplo
<Samples Path>\Pipelines\AssemblerDisassembler\EnvelopeProcessing\
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. |
| EnvelopeProcessing.btproj, EnvelopeProcessing.sln | Archivos de proyectos y de soluciones de este ejemplo. |
| EnvelopeProcessing_in.txt | Archivo de entrada de ejemplo. |
| Header.xsd, PO.xsd, Trailer.xsd | Esquema para el encabezado, el cuerpo y el finalizador del archivo sin formato, respectivamente. |
| XmlEnvelope.xsd | Esquema para el sobre XML saliente. |
| EnvReceivePipeline.btp, EnvSendPipeline.btp | Archivos de canalización de recepción y envío de BizTalk Server con los componentes de canalización Desensamblador de archivos sin formato y Ensamblador XML, respectivamente. |
| EnvelopeProcessingBinding.xml | Se usa para la configuración automatizada, como el enlace de puertos. |
| 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. Algunos ejemplos son los siguientes:
Mejore el ejemplo para escribir una versión del archivo sin formato de cada pedido, además de la versión XML. Para ello, cree una nueva canalización de envío personalizada y use el Ensamblador de archivos sin formato. En éste, especifique los esquemas de encabezado, pedido y finalizador de archivos sin formato. Si se usa en un puerto de envío, genera pedidos individuales con la información de encabezado y finalizador.
Mejore el sobre con más información procedente del pedido. Para escribir información adicional en el mensaje de salida, promocione el nombre de envío u otros campos mediante Promoción rápida, agregue campos al sobre y, a continuación, promocione los campos del sobre al mismo campo. Cuando se procesa el mensaje a través del ensamblador, las propiedades promocionadas se degradan y copian en el mensaje de salida.
Crear e inicializar este ejemplo
Para crear e inicializar el ejemplo EnvelopeProcessing
En una ventana de comandos, desplácese a la siguiente carpeta:
<Ruta de acceso> de ejemplos\Pipelines\AssemblerDisassembler\EnvelopeProcessing
Ejecute el archivo Setup.bat que realiza las acciones siguientes:
Crea la carpeta de entrada (EnvInput) y la carpeta de salida (EnvOutput) para este ejemplo en la carpeta:
<Ruta de acceso> de ejemplos\Pipelines\AssemblerDisassembler\EnvelopeProcessing\
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.
En este ejemplo se muestran las siguientes advertencias al crear y enlazar puertos:
Warning: Receive handler not specified for receive location "EnvelopeProcessing_RL"; updating with first receive handler with matching transport type. Warning: Host not specified for orchestration "EnvelopeProcessing"; updating with first available host.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
Para ejecutar el ejemplo EnvelopeProcessing
Ponga una copia del archivo EnvelopeProcessing_in.txt en la carpeta EnvInput.
Observe los tres archivos .xml creados en la carpeta EnvOutput. Los nombres de estos archivos .xml se basan en los GUID de Id. de mensaje. Contienen los mensajes extraídos del archivo de entrada e incluidos en sobres.
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)