Cómo configurar una ubicación de recepción de HTTP

Se pueden establecer variables de adaptador de ubicación de recepción HTTP mediante programación o con la consola de administración de BizTalk Server. Si no se definen las propiedades en la ubicación de recepción, se utilizarán los valores predeterminados del controlador de recepción definidos en la consola de administración de BizTalk Server.

Nota

Antes de completar este procedimiento, debe haber agregado un puerto de recepción. Para obtener más información, consulte Creación de un puerto de recepción.

Cómo configurar una ubicación de recepción HTTP mediante programación

El adaptador de HTTP almacena la información de configuración en la base de datos de administración de BizTalk (también conocida como la base de datos de configuración). La configuración se almacena en una bolsa de propiedades XML personalizada.

El modelo de objetos del Explorador de BizTalk expone la interfaz de configuración IReceiveLocation , que tiene una propiedad de lectura y escritura TransportTypeData . Esta propiedad acepta la bolsa de propiedades de configuración de la ubicación de recepción HTTP en una cadena XML de par nombre-valor.

No es necesario establecer la propiedad TransportTypeData de IReceiveLocation . Si no se establece, se usan los valores predeterminados de la configuración de ubicación de recepción HTTP. La tabla siguiente enumera los valores predeterminados y las propiedades de configuración que puede establecer en el modelo de objetos del Explorador de BizTalk para la ubicación de recepción HTTP.

Nombre de propiedad	Tipo	Descripción	Restricciones	Comentarios
ResponseContentType	string	Tipo de contenido de los mensajes de respuesta HTTP que el adaptador de HTTP envía a los clientes desde esta ubicación de recepción. Esta propiedad es válida sólo para puertos de recepción de solicitud respuesta y se omite para puertos de recepción unidireccionales.	String Longitud mínima: 0 Longitud máxima: 256	Valor predeterminado: Texto/XML
Loopback	Boolean	Especifica que el mensaje de solicitud recibido en esta ubicación se enrutará a un puerto de envío o se devolverá a la ubicación de recepción para enviarlo como respuesta. Esta propiedad es válida únicamente para puertos de recepción de solicitud-respuesta. Se omite para puertos de recepción unidireccionales.	None	Valor predeterminado: Falso
ReturnCorrelationHandle	Boolean	Especifica el token de correlación del mensaje que envía el adaptador de HTTP en la respuesta HTTP al cliente si el envío es correcto. Esta propiedad es válida sólo para puertos de recepción unidireccionales y se omite para puertos de recepción de solicitud-respuesta.	None	Valor predeterminado: Verdad
SuspendFailedRequests	Boolean	Especifica si se deben suspender las solicitudes HTTP con errores. Un valor true indica que suspende la solicitud con error y envía un código de estado "Aceptado" (202) al cliente para puertos de recepción unidireccionales o un código de estado "Error" (500) al cliente para puertos de recepción bidireccionales.	None	Valor predeterminado: Falso
UseSSO	Boolean	Especifica si el adaptador HTTP emitirá el vale SSO para los mensajes que llegan a esta ubicación de recepción.	None	Valor predeterminado: Falso

El formato de la cadena XML para establecer estas propiedades es el siguiente:

<CustomProps>  
   <UseSSO vt="11">-1</UseSSO>  
   <SuspendFailedRequests vt="11">-1</SuspendFailedRequests>  
   <ReturnCorrelationHandle vt="11">-1</ReturnCorrelationHandle>  
   <ResponseContentType vt="8">text/xml</ResponseContentType>  
   <LoopBack vt="11">-1</LoopBack>  
</CustomProps>  

Cómo configurar una ubicación de recepción HTTP con la consola de administración de BizTalk Server

Para configurar la ubicación de recepción utilizando la consola de administración de BizTalk Server, siga el procedimiento que se detalla a continuación:

Para configurar variables para una ubicación de recepción HTTP

1. Configure los Servicios de Internet Information Server (IIS) para trabajar con ubicaciones de recepción HTTP. Para obtener instrucciones sobre cómo configurar IIS, consulte Configuración de IIS para una ubicación de recepción HTTP.

2. En la consola de administración de BizTalk Server, expanda BizTalk ServerAdministration, expanda Grupo de BizTalk, expanda Aplicaciones y, a continuación, expanda la aplicación en la que desea crear una ubicación de recepción.

3. En el panel izquierdo, haga clic en el nodo Puertos de recepción . A continuación, en el panel de la derecha, haga clic con el botón secundario en el puerto de recepción asociado con una ubicación de recepción existente o que desee asociar con una nueva ubicación de recepción. A continuación, haga clic en Propiedades.

4. En el cuadro de diálogo Propiedades del puerto de recepción, en el panel izquierdo, seleccione Ubicaciones de recepción y, en el panel derecho, haga doble clic en una ubicación de recepción existente o haga clic en Nuevo para crear una nueva ubicación de recepción.

5. En el cuadro de diálogo Propiedades de ubicación de recepción, en la sección Transporte situada junto a Tipo, seleccione HTTP en la lista desplegable y, a continuación, haga clic en Configurar.

6. En el cuadro de diálogo Propiedades de transporte HTTP , haga lo siguiente:

   Use	Para hacer esto
   Directorio virtual más extensión ISAPI	Especificar el nombre del directorio virtual al que se envían los mensajes que recibe la ubicación de recepción HTTP/HTTPS. El directorio virtual incluye el nombre del archivo DLL de ubicación de recepción y una cadena de consulta opcional. Éstos son algunos ejemplos de nombres de directorio virtual: /<virtual directory>/BTSHTTPReceive.dll /<virtual directory>/BTSHTTPReceive.dll? Purchase%20Order Esta ubicación no debe contener más de una extensión ISAPI BTSHTTPReceive.dll, incluidas todas las subcarpetas. Tipo: Cadena Longitud máxima: 256 Nota: el URI de un puerto de envío o ubicación de recepción no puede superar los 256 caracteres.
   Dirección pública	Especificar el URI completo de la ubicación de recepción. El valor de esta propiedad es una combinación del nombre del servidor y el directorio virtual. El motor de mensajería de BizTalk expone esta dirección a socios externos. El URI especificado debe designar la dirección URL del sitio Web público para que los socios comerciales se conecten cuando envíen mensajes a BizTalk Server. Esta información es opcional y BizTalk Server no la utiliza. Este parámetro está disponible para permitir a los administradores documentar la dirección URL pública a la que está vinculada la ubicación de recepción. Tipo: Cadena Longitud mínima: 0 Longitud máxima: 256
   Tipo de contenido devuelto	Especificar el tipo de contenido de los mensajes de respuesta HTTP que la ubicación de recepción envía a los clientes. Esta propiedad sólo es válida para las ubicaciones de recepción de solicitud-respuesta. Valor predeterminado: text/xml Tipo: Cadena Longitud mínima: 0 Longitud máxima: 256
   Bucle invertido	Definir que el mensaje de solicitud recibido en esta ubicación se enrute a un puerto de envío o se devuelva a esta ubicación de recepción para enviarlo como respuesta. Esta propiedad sólo es válida para las ubicaciones de recepción de solicitud-respuesta. Valor predeterminado: Falso Tipo: Booleana
   Devolver controlador de correlación en caso de éxito (sólo puerto unidireccional)	Definir que, si la recepción es correcta, la ubicación de recepción envíe el token de correlación del mensaje enviado en la respuesta HTTP al cliente. Esta propiedad sólo es válida para las ubicaciones de recepción unidireccionales. Valor predeterminado: Verdad Tipo: Booleana
   Utilizar Inicio de sesión único	Indicar que se utiliza el inicio de sesión único (SSO) empresarial. Valor predeterminado: Falso Tipo: Nota booleana : Si esta opción está habilitada, también debe habilitar la opción Permitir vales en el nivel de sistema de SSO . La opción Permitir vales se puede configurar en la pestaña Opciones del cuadro de diálogo Propiedades del sistema de SSO disponible en la interfaz MMC de administración de SSO . Si esta opción está habilitada y la opción Permitir vales en el nivel del sistema de SSO no está habilitada, se suspenderán los mensajes recibidos por esta ubicación de recepción.
   Suspender solicitudes con errores	Indica si se deben suspender o no las solicitudes HTTP que dan error en el procesamiento de entrada. El valor False indica que se descarte la solicitud con errores y se envíe un código de estado de error (401 o 500) al cliente. El valor indica que se suspenda la solicitud con errores y se envíe un código de estado "Aceptado" (200) al cliente para puertos de recepción unidireccionales o un código de estado "Error" (500) al cliente para puertos de recepción bidireccionales. Valor predeterminado: Falso Tipo: Booleana

7. Haga clic en Aceptar para guardar la configuración.

8. Especifique los valores apropiados en el cuadro de diálogo Propiedades de la ubicación de recepción para completar la configuración de la ubicación de recepción y haga clic en Aceptar para guardar la configuración. Para información sobre el cuadro de diálogo Propiedades de ubicaciones de recepción , vea Cómo crear una ubicación de recepción.

   Si bien el cliente HTTP llama a la ubicación HTTP, el adaptador de HTTP autentica el cliente HTTP usando autenticación anónima, básica, implícita o integrada de Windows. Si se comprueba el usuario, se pasa el contexto del usuario al controlador de recepción.

Nota

No será válida ninguna configuración de IIS que haga que SOAP y HTTP compartan el mismo proceso. Sólo puede haber un receptor aislado por proceso.