HelloWorld (ejemplo de BizTalk Server)
En el ejemplo HelloWorld se muestra cómo utilizar orquestaciones de BizTalk para convertir un mensaje XML (un pedido), a un tipo de mensaje (una factura) relacionado pero distinto.
Descripción del ejemplo
En este ejemplo se configura la carpeta In como una ubicación de recepción. Al colocar un archivo, como el archivo de ejemplo SamplePOInput.xml, en esta carpeta, BizTalk Server procesa el mensaje mediante los pasos siguientes:
BizTalk Server recupera el de mensajes de pedido XML desde la carpeta de ubicación de recepción.
La orquestación utiliza el archivo de asignación para crear una factura XML del pedido XML.
BizTalk Server coloca el mensaje de factura XML resultante en la carpeta Out del adaptador de envío.
Cómo se ha diseñado este ejemplo y por qué
En un contexto de intercambio de mensajes entre empresas, a menudo es necesario convertir mensajes entrantes recibidos de los socios comerciales a un formato que puedan reconocer las aplicaciones internas. En este ejemplo se usa una forma Receive , una forma Transform y una forma Send para lograr este resultado. La forma Transformar desempeña el papel importante en este ejemplo porque es donde se produce la conversión de formato de mensaje. Arrastre una forma de transformación a la orquestación y configure el mensaje de origen, el nombre del mapa y el mensaje de destino para ella. Durante el tiempo de ejecución, el mensaje de origen se asigna al mensaje de destino mediante la asignación que designó.
Para obtener más información sobre la forma Transformar , vea Cómo configurar la forma de transformación. Para obtener más información sobre cómo crear un mapa, vea Crear mapas mediante el asignador de BizTalk.
Ubicación del ejemplo
<Ruta de acceso de> ejemplos\Orchestrations\HelloWorld\
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. |
| HelloOrchestration.odx | Orquestación que coordina la conversión del pedido en una factura. |
| HelloWorld.btproj HelloWorld.sln | Archivos de proyectos y de soluciones de este ejemplo. |
| HelloWorldBinding.xml | Se usa para la configuración automatizada, como el enlace de puertos. |
| InvoiceSchema.xsd POSchema.xsd | Esquemas para los mensajes de factura y de pedido, respectivamente. |
| POToInvoice.btm | Asignación para convertir el pedido en una factura. |
| SamplePOInput.xml | Archivo de entrada de ejemplo. |
| Setup.bat | Se utiliza para crear e iniciar este ejemplo. |
Crear e inicializar este ejemplo
Para crear e iniciar el ejemplo HelloWorld
En una ventana de comandos, desplácese a la siguiente carpeta:
<Ruta de acceso de> ejemplos\Orchestrations\HelloWorld
Ejecute el archivo Setup.bat que realiza las acciones siguientes:
Crea las carpetas de entrada (In) y de salida (Out) de este ejemplo en la carpeta siguiente:
<Ruta de acceso de> ejemplos\Orchestrations\HelloWorld
Compila 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 a la orquestación.
Habilita la ubicación de recepción e inicia el puerto de envío. Inscribe e inicia la orquestación.
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. Lo puede confirmar si ve sus registros de sucesos.
Ejecución del ejemplo
Para ejecutar el ejemplo HelloWorld
Pegue una copia del archivo SamplePOInput.xml en la carpeta In .
Observe el archivo .xml creado en la carpeta Out . Este archivo contiene la factura XML construida a partir del archivo de entrada SamplePOInput.xml. El formato del nombre de este archivo es <MessageID>.xml, donde <MessageID> es el GUID generado para identificar de forma única el mensaje.
Desinstalar este ejemplo
Para desinstalar el ejemplo HelloWorld
En una ventana de comandos, desplácese a la siguiente carpeta:
<Ruta de acceso de> ejemplos\Orchestrations\HelloWorld\
Ejecute Cleanup.bat.