Compartir a través de

Adaptador de HTTP (ejemplo de BizTalk Server)

  • Artículo

En el ejemplo de adaptador HTTP se muestra cómo implementar los paradigmas de comunicación de solicitud/respuesta y solicitud/respuesta usados en BizTalk Server.

Ubicación del ejemplo

<Ruta de acceso> de ejemplos\AdaptersDevelopment\HttpAdapter\

En la tabla siguiente se enumeran los archivos del ejemplo y se describe su propósito.

Archivos Descripción
\Design-Time\Adapter Management Contiene el proyecto que implementa la parte de tiempo de diseño de este adaptador.
\Run-Time\HttpReceive Contiene el proyecto que implementa la del patrón de comunicación del adaptador de solicitud-respuesta. Se trata de un receptor aislado.
\Run-Time\HttpSend Contiene el proyecto que implementa la del patrón de comunicación del adaptador de petición-respuesta.

Uso del ejemplo

El propósito de este ejemplo es constituir un marco de trabajo que pueda usarse para el desarrollo de adaptadores personalizados. En algunos casos, es posible que BizTalk Server necesite transportar mensajes a una aplicación personalizada específica o usar un protocolo para el que no exista un adaptador nativo. Las compañías de terceros han escrito adaptadores compatibles con otros protocolos. Antes de decidirse a escribir un adaptador personalizado, puede que desee saber si ya hay un adaptador para el protocolo. Si no consigue encontrar un adaptador compatible para satisfacer los requisitos de comunicación, puede desarrollar un adaptador personalizado propio.

La escritura de un adaptador personalizado puede resultar todo un desafío. Para simplificar este proceso, Microsoft ha desarrollado una base denominada el marco de trabajo de adaptadores. Puede usar este marco de trabajo como base para el desarrollo junto con el código fuente de adaptador de ejemplo que se encuentra en el SDK de BizTalk Server. Para obtener más información sobre los adaptadores personalizados y el marco de trabajo del adaptador, consulte la sección Ver también al final de este documento.

Crear e inicializar el adaptador de ejemplo

Importante

Si la instalación de BizTalk es de 64 bits o se modifica la ubicación de la instalación, OutboundAssemblyPath, InboundAssemblyPath y AdapterMgmtAssemblyPath deben cambiarse según corresponda.

Para crear e inicializar el ejemplo del adaptador de HTTP

  1. En una ventana de comandos, desplácese a la siguiente carpeta:

    <Ruta de acceso de> ejemplos\AdaptersDevelopment\HttpAdapter

  2. Ejecute el archivo Setup.bat que realiza las acciones siguientes:

    • Compila el adaptador de HTTP y todas sus dependencias.

    • Crea una aplicación de Internet Information Services (IIS) que se usa para la recepción en el adaptador.

    En IIS 7,0, debe asegurarse de que la identidad del grupo de aplicaciones que se ejecuta en esta aplicación de IIS es miembro de los grupos siguientes:

  • Grupo de usuarios de hosts aislados de BizTalk.

  • Grupo IIS_WPG.

  • En IIS 7.0, debe migrar la aplicación para que funcione con el modo .NET integrado. Puede migrar la configuración de la aplicación, incluido el contenido de la <sección de configuración httpHandlers> , mediante lo siguiente desde una ventana de línea de comandos (la ventana debe ejecutarse como administrador):

    %systemroot%\system32\inetsrv\APPCMD.EXE migrate config "Default Web Site/HttpReceive"

  • Después de migrar la aplicación, se ejecutará en los modos .NET clásico e integrado, así como en plataformas de nivel inferior.

Nota

Debe confirmar que no se ha informado de errores durante el proceso de creación e iniciació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.

Nota

Para deshacer los cambios realizados por Setup.bat, ejecute Cleanup.bat. Debe ejecutar Cleanup.bat antes de ejecutar Setup.bat por segunda vez.

Registrar el adaptador de ejemplo

Para registrar el ejemplo de adaptador de HTTP

  1. En el Explorador de Windows, vaya a la unidad de instalación para BizTalk Server y, a continuación, vaya a <Ruta de acceso> de ejemplos\AdaptersDevelopment\HTTPAdapter.

  2. Para agregar el adaptador de ejemplo al Registro, haga doble clic en HTTP. NET.reg.

    Nota

    HTTP. NET.reg incluye rutas de acceso codificadas de forma rígida al directorio de instalación de BizTalk Server. Si no instaló BizTalk Server en la ubicación predeterminada o si actualizó la instalación de BizTalk Server desde una versión anterior de BizTalk Server, debe modificar el archivo HTTP. NET.reg con las rutas de acceso adecuadas. Actualice las rutas asociadas a los valores "OutboundAssemblyPath" y "AdapterMgmtAssemblyPath" para que señalen la ubicación correcta de los archivos especificados.

    Importante

    Si instala BizTalk en una máquina de 64 bits, cambie todas las instancias de la entrada del Registro de HKEY_CLASSES_ROOT\CLSID\ a HKEY_CLASSES_ROOT\Wow6432Node\CLSID\ en HTTP. Archivo del registro NET.reg .

  3. En el cuadro de diálogo Editor del Registro , haga clic en Sí para agregar el adaptador de ejemplo al Registro y, a continuación, haga clic en Aceptar.

  4. Para cerrar el Explorador de Windows, en el menú Archivo , haga clic en Cerrar.

Instalar el adaptador de ejemplo

Para instalar el ejemplo del adaptador de HTTP

  1. Haga clic en el menú Inicio, seleccione Todos los programas, Microsoft BizTalk Server 20xx y luego BizTalk Server Administración.

  2. En la consola de administración de BizTalk Server, expanda el árbol administración de BizTalk Server y, a continuación, expanda el árbol grupo de BizTalk y, a continuación, expanda el árbol Configuración de la plataforma.

  3. Haga clic con el botón derecho en Adaptadores, haga clic en Nuevoy, a continuación, en Adaptador.

  4. En el cuadro de diálogo Propiedades del adaptador , haga lo siguiente.

    Use Para hacer esto
    Nombre Escriba HTTP.NET.
    Adapter (Adaptador) Seleccione HTTP.NET en la lista desplegable.
    Descripción Escriba ejemplo HTTP.NET adaptador.

  5. Haga clic en OK.

  6. El adaptador aparece en la lista de adaptadores de la ventana derecha de la consola de administración de BizTalk Server.

Detener y reiniciar la instancia de host

Para detener y reiniciar la instancia de host para el ejemplo de adaptador de HTTP

  1. Haga clic en el menú Inicio, seleccione Todos los programas, Microsoft BizTalk Server 20xx y BizTalk Server Administración.

  2. En la consola de administración de BizTalk Server, expanda el árbol administración de BizTalk Server, expanda Configuración de la plataforma y haga clic en Instancias de host.

  3. En el panel de resultados, haga clic con el botón derecho en la instancia de host (normalmente, el nombre del equipo) y, a continuación, haga clic en Detener.

    El estado de la instancia de host cambia a Detenido.

  4. En el panel de resultados, haga clic con el botón derecho en la instancia de host y, a continuación, haga clic en Iniciar.

    La aplicación ya puede utilizar el adaptador de HTTP.NET. Al configurar el adaptador, el formato de la propiedad de transporte directorio virtual tiene el formato: /httpreceive/httpreceive.aspx?optionalQueryString.

Comentarios

El adaptador de HTTP.NET usa las clases BaseAdapter proporcionadas en <Samples Path>\AdaptersDevelopment\BaseAdapter\v1.0.. 2\. Las clases que se proporcionan en el proyecto BaseAdapter tienen como finalidad acelerar el desarrollo del adaptador. Vea los comentarios de código BaseAdapter para obtener más información acerca de las clases proporcionadas.

Consulte también

Registro de un adaptador
Ejemplos de adaptadores: uso
Desarrollo de adaptadores personalizados
¿Qué es el marco de trabajo de adaptadores?
Uso de las herramientas de marco de trabajo de adaptadores
Desarrollo de un adaptador de recepción
Desarrollo de un adaptador de envío
Cómo implementar un adaptador personalizado
Sugerencias para diseñar un adaptador
Configuración de adaptadores en tiempo de diseño