Cómo consumir matrices de servicios Web
BizTalk Server proporciona la capacidad de consumir matrices expuestas en servicios web desde una orquestación de BizTalk.
Para configurar una orquestación para consumir una matriz expuesta en un servicio Web:
Determine la URL para el servicio Web que expone las matrices. Ésta corresponde normalmente a una página Web asmx que enumera las operaciones admitidas por el servicio Web. Por ejemplo: http://localhost/ArrayWS/ArraySvc.asmx.
Agregue una referencia Web a esta URL en el proyecto de Visual Studio que contenga su orquestación.
En el Explorador de soluciones, haga clic con el botón derecho en Referencias y haga clic en Agregar referencia de servicio.
En el cuadro de diálogo Agregar referencia de servicio , haga clic en Avanzadas.
En el cuadro de diálogo Configuración de referencia del servicio , haga clic en Agregar referencia web en la sección Compatibilidad .
En el cuadro de diálogo Agregar referencia web , escriba la dirección URL del servicio web en el cuadro de texto URL y, a continuación, haga clic en Ir.
Escriba un nombre para la referencia web en el cuadro de texto Nombre de referencia web y haga clic en el botón Agregar referencia .
La referencia web aparecerá en Referencias web en el Explorador de soluciones.
Sugerencia
Una vez que haya agregado una referencia web al proyecto, el comando Agregar referencia web estará disponible directamente cuando haga clic con el botón derecho en el nombre del proyecto o referencias web o referencias web.
Agregue un puerto web a la orquestación:
Arrastre una forma Puerto desde el cuadro de herramientas a una de las superficies de puerto de la Designer orquestación para iniciar el Asistente para configuración de puertos. Haga clic en el botón Siguiente del Asistente para configuración de puertos para mostrar el cuadro de diálogo Propiedades del puerto .
Escriba un valor en el cuadro de texto Nombre para identificar el puerto y haga clic en el botón Siguiente para mostrar el cuadro de diálogo Seleccionar un tipo de puerto .
Seleccione la opción Usar un tipo de puerto existente, seleccione el tipo de puerto web que corresponde a la referencia web que agregó y haga clic en el botón Siguiente para mostrar el cuadro de diálogo Enlace de puerto .
En el cuadro de diálogo Enlace de puerto, seleccione la opción Enlace de puerto adecuada y haga clic en el botón Siguiente y, a continuación, haga clic en el botón Finalizar . Ahora debería tener un puerto web mostrado en el Designer orchestration que incluye las operaciones admitidas por el servicio web.
Agregue las formas Enviar y Recibir a la orquestación según corresponda:
Arrastre una forma Enviar desde el cuadro de herramientas a una línea de conexión en la superficie de orquestación Designer para configurar la orquestación para enviar un mensaje de solicitud al puerto web. Si conecta la forma Enviar a uno de los conectores de mensajes de solicitud de puerto web, BizTalk creará automáticamente un mensaje del tipo adecuado que se usará al enviar un mensaje de solicitud a este puerto.
Arrastre una forma Receive del cuadro de herramientas a una línea de conexión en la superficie de orquestación Designer para configurar la orquestación para recibir un mensaje de respuesta desde el puerto web. Si conecta la forma Receive a uno de los conectores de mensajes de respuesta del puerto web, BizTalk creará automáticamente un mensaje del tipo adecuado que se usará al recibir un mensaje de respuesta de este puerto.
Nota
Use el adaptador de SOAP para enviar o recibir mensajes desde un servicio Web. Para obtener más información sobre cómo configurar el adaptador SOAP, consulte Configuración del adaptador SOAP.
El motor de orquestación de BizTalk Server proporciona compatibilidad para consumir matrices unidimensionales y irregulares expuestas por servicios web. Si agrega una referencia Web a un servicio Web que exponga matrices, el Diseñador de orquestaciones generará un tipo de mensaje Web que describa la matriz. Puede enviar y recibir mensajes de este tipo de la misma forma que con cualquier otro mensaje. BizTalk Server no limita el envío de mensajes Web que contengan matrices para solo puertos Web.
Para obtener un ejemplo de consumo de matrices de servicios web, consulte el ejemplo del SDK "Consumir servicios web" y "Consumo de servicios web con parámetros de matriz" en https://go.microsoft.com/fwlink/?LinkId=73703.