HTTPRequestResponse
En el ejemplo HTTPRequestResponse se muestra cómo usar el filtro interfaz de programación de aplicaciones (ISAPI) de Microsoft BizTalk Server Servidor de Internet para permitir que una aplicación de ASP.NET se comunique con una orquestación de BizTalk Server.
Descripción del ejemplo
En este ejemplo, la aplicación ASP.NET envía una solicitud al filtro ISAPI de BizTalk Server. A continuación, la orquestación consume este mensaje y lo devuelve a la aplicación ASP.NET por medio de una respuesta sincrónica. Puede lograr la integración entre la orquestación de BizTalk Server y la aplicación de ASP.NET mediante el filtro ISAPI de BizTalk Server.
En este ejemplo, BizTalk Server y la aplicación ASP.NET intercambian el pedido de compra (PO) y los mensajes de confirmación de pedido siguiendo esta secuencia de pasos:
Una aplicación ASP.NET, a través de una solicitud HTTP, envía un mensaje de pedido XML a BizTalk Server.
BizTalk Server recibe el mensaje de pedido XML, construye un mensaje de confirmación de pedido XML y, a continuación, devuelve el mensaje a la aplicación ASP.NET en la respuesta HTTP.
La aplicación ASP.NET recibe la respuesta de confirmación de pedido XML y actualiza el formulario Web con la información de estado extraída de la respuesta.
Ubicación del ejemplo
<Ruta de acceso> de ejemplos\AdaptersUsage\HTTPRequestResponse\
En la tabla siguiente se enumeran los archivos del ejemplo y se describe su propósito.
| Archivos | Descripción |
|---|---|
| Cleanup.bat | Anula la implementación de ensamblados y los elimina de la caché de ensamblados global (GAC); elimina puertos de envío y de recepción; elimina directorios virtuales de los Servicios de Microsoft Internet Information Server (IIS) según sea necesario. |
| HTTPRequestResponse.btproj, HTTPRequestResponse.sln | Proporciona archivos del proyecto y de origen para el proyecto de BizTalk que recibe la solicitud HTTP, procesa el mensaje de pedido y emite la respuesta. |
| HTTPRequestResponseBinding.xml | Proporciona la instalación automatizada, como el enlace de puertos. |
| POAck.xsd, POSchema.xsd | Proporciona esquemas para la confirmación de pedido y para los archivos de pedido .xml, respectivamente. |
| POReceiveOrchestration.odx | Proporciona una orquestación de BizTalk Server que recibe el pedido de compra, lo procesa y emite la confirmación de pedido. |
| Setup.bat | Crea e inicializa este ejemplo. |
| En la carpeta \RequestResponse: AssemblyInfo.cs, default.aspx, default.aspx.cs, Global.asax, Global.asax.cs, RequestResponse.csproj, RequestResponse.csproj.webinfo, RequestResponse.sln, Web.config |
Contiene archivos que forman la aplicación ASP.NET que sirve como controlador para este ejemplo, incluidos los archivos del proyecto y de la solución, archivos ASPX, archivos de origen de Microsoft Visual C# .NET, etc. |
Crear e inicializar este ejemplo
Utilice el siguiente procedimiento para generar e inicializar el ejemplo HTTPRequestResponse.
Para generar e inicializar el ejemplo
En una ventana de comandos, desplácese a la siguiente carpeta:
<Ruta de acceso de> ejemplos\AdaptersUsage\HTTPRequestResponse
Ejecute el archivo Setup.bat que realiza las acciones siguientes:
Compila y configura la aplicación ASP.NET utilizada para controlar este ejemplo.
Nota
Al crear un grupo de aplicaciones en el Administrador de IIS, establezca la versión defaultAppPool de .NET Framework en .Net Framework v4.0.
Compila e implementa la orquestación de BizTalk Server usada en este ejemplo.
Compila e implementa los proyectos de Microsoft Visual Studio para este ejemplo.
Crea los puertos de BizTalk Server necesarios y los enlaza.
Inicia la orquestación de BizTalk Server.
Importante
Debe modificar el código del ejemplo que implementa la aplicación Web (Default.aspx.cs) para reflejar su entorno:
< http:// nombre> de servidor/<dir> virtual/BTSHTTPReceive.dll donde
<servername>es el nombre del servidor web en el que está publicando y<el dir>virtual es el directorio virtual donde reside este archivo.Nota
Debe confirmar que BizTalk no ha informado de ningún error durante el proceso de generación e inicialización antes de intentar ejecutar este ejemplo.
Nota
Si opta por abrir y crear los proyectos de este ejemplo sin ejecutar el archivo 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 los ensamblados resultantes. También debe eliminar de forma manual las referencias a default.aspx.resx y Global.asax.resx del archivo RequestResponse.csproj antes de intentar generar ese proyecto.
Nota
Para deshacer los cambios realizados por Setup.bat, ejecute Cleanup.bat. Debe ejecutar Cleanup.bat antes de ejecutar Setup.bat por segunda vez.
Nota
Debe configurar y habilitar ISS para usar el adaptador de recepción HTTP. Para obtener más información, consulte Configuración de IIS para una ubicación de recepción HTTP.
El archivo setup.bat configura el directorio virtual de este ejemplo para ejecutarlo en el grupo de aplicaciones de IIS asociado al sitio Web predeterminado. Para configurar el directorio virtual de este ejemplo para que se ejecute en el contexto de un usuario en los usuarios host aislados de BizTalk y IIS_IURS grupos de usuarios, debe configurar el directorio virtual para que se ejecute en un nuevo grupo de aplicaciones de IIS. Configure el directorio virtual para ejecutarlo en un grupo de aplicaciones IIS nuevo realizando los pasos que se indican a continuación:
Nota
Si ya ha creado un grupo de aplicaciones nuevo para otro ejemplo de SDK, puede continuar con el último paso que aparece a continuación.
Haz clic en Inicio, apunta a Todos los programas, Herramientas administrativas y haz clic en Administrador de Internet Information Services (IIS).
En el Administrador de Internet Information Services (IIS), vaya a la carpeta Grupos de aplicaciones .
Haga clic con el botón derecho en la carpeta Grupos de aplicaciones y haga clic en Nuevo, Grupo de aplicaciones...
Escriba un nombre para el identificador del grupo de aplicaciones: como BizTalkSDKSamples, compruebe que la opción Usar la configuración predeterminada para el nuevo grupo de aplicaciones está seleccionada y haga clic en Aceptar para crear el nuevo grupo de aplicaciones.
Haga clic con el botón derecho en el nuevo grupo de aplicaciones y, a continuación, haga clic en Propiedades.
Haga clic en la pestaña Identidad del cuadro de diálogo de propiedades y cambie la identidad en la que se ejecuta este grupo de aplicaciones a un usuario que sea miembro del grupo de usuarios de host aislado de BizTalk . Este usuario también debe ser miembro del grupo de usuarios local IIS_IURS .
Configure el directorio virtual de este ejemplo SDK para ejecutarlo en el grupo de aplicaciones nuevo. La configuración del grupo de aplicaciones está disponible en la pestaña Directorio virtual del cuadro de diálogo Propiedades del directorio virtual. El directorio virtual que se ha creado para este ejemplo es HttpRequestResponseSample.
Ejecución del ejemplo
Utilice el siguiente procedimiento para ejecutar el ejemplo HTTPRequestResponse.
Para ejecutar el ejemplo
En Internet Explorer, vaya a http://localhost/RequestResponse/.
Complete los campos necesarios en el formulario web y, a continuación, haga clic en Realizar pedido para enviar el pedido.
Consulte el estado de su pedido cuando se actualice el formulario Web después de recibir una respuesta.
Comentarios
La extensión BTSHTTPReceiveISAPI que se usa en este ejemplo está configurada para funcionar en una sola instalación predeterminada del equipo. Para ampliar este ejemplo para configuraciones adicionales, consulte Adaptador HTTP.
Puede extender este ejemplo a aplicaciones que requieren enviar datos a BizTalk Server a través de un formulario Web o HTTP, por lo general. Si extiende la parte de la aplicación ASP.NET de este ejemplo, podrá consultar más información y realizar otro preprocesamiento antes de enviar los datos a BizTalk Server.