Cómo configurar una ubicación de recepción de SOAP
Puede configurar una ubicación de recepción SOAP mediante programación o con la consola de administración de BizTalk Server.
Cómo configurar una ubicación de recepción SOAP mediante programación
El modelo de objetos para el Explorador de BizTalk permite crear y configurar ubicaciones de recepción mediante programación. El modelo de objetos del Explorador de BizTalk expone la interfaz de configuración de ubicación de recepciónIReceiveLocation que tiene una propiedad de lectura y escritura TransportTypeData . Esta propiedad acepta una bolsa de propiedades de configuración de ubicación de recepción SOAP con formato de un par de nombre y valor de cadenas XML. Para establecer esta propiedad en el modelo de objetos del Explorador de BizTalk, debe establecer la propiedad InboundTransportLocation de la interfaz IReceiveLocation .
No es necesario establecer la propiedad TransportTypeData de la interfaz IReceiveLocation . Si no se establece, el adaptador de SOAP utiliza los valores predeterminados de la configuración de ubicación de recepción SOAP que se incluyen en la siguiente tabla.
La siguiente tabla enumera las propiedades de configuración que se pueden establecer en el modelo de objetos del Explorador de BizTalk para la ubicación de recepción SOAP.
| Nombre de propiedad | Tipo | Descripción |
|---|---|---|
| URI | String | Directorio virtual que contiene el servicio Web en el servidor de implementación. |
| AddressableURI | String | Campo de dirección pública que contiene la dirección URL completa a la que se puede llamar. Valor predeterminado: en blanco |
| UseSSO | Boolean | Especifica si el adaptador de SOAP emite el vale de inicio de sesión único para los mensajes que llegan a esta ubicación de recepción. Valor predeterminado: False |
Utilice el siguiente formato para establecer las propiedades:
receiveLocation.TransportTypeData = "<CustomProps><UseSSO vt=\"11\">-1</UseSSO></CustomProps>";
Las propiedades URI y AddressableURI se establecen mediante las propiedades Address y PublicAddress del objeto de ubicación de recepción.
El siguiente fragmento de código muestra la creación de una ubicación de recepción SOAP:
// Use BizTalk Explorer object model to create new SOAP receive location.
string server = System.Environment.MachineName;
string database = "BizTalkMgmtDb";
string connectionString = string.Format("Server={0};Database={1};Integrated Security=true", server, database);
//requires project reference to \Program Files\Microsoft BizTalk Server 2009\Developer Tools\Microsoft.BizTalk.ExplorerOM.dll
BtsCatalogExplorer explorer = new Microsoft.BizTalk.ExplorerOM.BtsCatalogExplorer();
explorer.ConnectionString = connectionString;
// Add a new Request-Response port
ReceivePort receivePort = explorer.AddNewReceivePort(true);
receivePort.Name = "SampleReceivePort";
receivePort.SendPipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruTransmit"];
// Add primary SOAP receive location
ReceiveLocation receiveLocation = receivePort.AddNewReceiveLocation();
receiveLocation.Name = "SampleReceiveLocation";
receiveLocation.Address = "/PurchaseOrder/POOrchestration.asmx";
receiveLocation.TransportType = explorer.ProtocolTypes["SOAP"];
receiveLocation.TransportTypeData = "<CustomProps><UseSSO vt=\"11\">-1</UseSSO></CustomProps>";
receiveLocation.ReceivePipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruReceive"];
foreach (ReceiveHandler receiveHandler in explorer.ReceiveHandlers)
{
if (receiveHandler.TransportType.Name == receiveLocation.TransportType.Name)
{
receiveLocation.ReceiveHandler = receiveHandler;
}
}
// Save
explorer.SaveChanges();
Cómo configurar una ubicación de recepción SOAP con la consola de administración de BizTalk Server
Puede establecer variables de adaptador de ubicación de recepción SOAP en 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 realizar los siguientes procedimientos, debe haber agregado un puerto de recepción. Para más información, consulte Cómo crear un puerto de recepción.
Para configurar variables para una ubicación de recepción SOAP
En la consola de administración de BizTalk Server, expanda administración BizTalk Server, 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.
En la consola de administración de BizTalk Server, en el panel izquierdo, haga clic en el nodo Puerto 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.
En el cuadro de diálogo Propiedades del puerto de recepción, en el panel izquierdo, seleccione Ubicaciones de recepción y, a continuación, en el panel derecho, haga doble clic en una ubicación de recepción existente o haga clic en Nuevopara crear una nueva ubicación de recepción.
En el cuadro de diálogo Propiedades de ubicación de recepción , en la sección Transporte junto a Tipo, seleccione SOAP en la lista desplegable y, a continuación, haga clic en Configurar.
En el cuadro de diálogo Propiedades de transporte SOAP , haga lo siguiente:
Use Para hacer esto Directorio virtual más archivo .asmx de servicio Web Indicar el archivo .asmx creado por el Asistente para publicación de servicios Web de BizTalk.
El formato del mensaje es similar al siguiente:
/PurchaseOrder/POOrchestration.asmx
Donde la ubicación completa del archivo .asmx es http://localhost/PurchaseOrder/POOrchestration.asmx. Nota: El URI de un puerto de envío o una 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 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.Uso del inicio de sesión único Indicar que el adaptador de SOAP utilice el inicio de sesión único (SSO) empresarial. Nota: El Asistente para publicación de BizTalk Web Services le permite usar SharePoint Portal Server inicio de sesión único; esta propiedad solo habilita el inicio de sesión único de Enterprise. Haga clic en OK.
En el cuadro de diálogo Propiedades de ubicación de recepción, escriba los valores adecuados para completar la configuración de la ubicación de recepción y, a continuación, 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.
La configuración de seguridad que utiliza la ubicación de recepción SOAP se establece en IIS. De forma predeterminada, la ubicación de recepción SOAP no está establecida para usar autenticación anónima.
Si bien el cliente SOAP llama al servicio Web, el adaptador de SOAP autentica el cliente SOAP 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.
Para actualizar un directorio virtual con el fin de usar ASP.NET 4.0
Inicie el Administrador de Internet Information Services (IIS). Haga clic en Inicio, todos los programas y en Administrador de Internet Information Services (IIS).
Si necesita conectarse a un servidor IIS remoto, haga clic con el botón derecho en el nodo Internet Information Services y, a continuación, haga clic en Conectar.
Escriba el nombre de equipo del servidor IIS remoto y las credenciales si es necesario.
Expanda el nombre del servidor que aloja el sitio Web o el directorio virtual que se va a actualizar.
Expanda Sitios.
Expanda Sitio web predeterminado.
Expanda el sitio web predeterminado para ver los directorios virtuales que contiene.
Haga clic con el botón derecho en el directorio virtual que desea actualizar para usar ASP.NET 4.0, haga clic en Administrar aplicacióny, a continuación, haga clic en Configuración avanzada. El campo Grupo de aplicaciones muestra el grupo de aplicaciones establecido para el directorio virtual seleccionado. Haga clic en OK.
En la ventana Administrador de Internet Information Services (IIS), haga clic en Grupos de aplicaciones. El panel de detalles muestra una lista de grupos de aplicaciones del servidor.
Haga clic con el botón derecho en el grupo de aplicaciones establecido en el paso 8 y, a continuación, haga clic en Configuración básica.
En el cuadro de diálogo Editar grupo de aplicaciones , cambie lo siguiente:
Versión de .NET Framework a 4.0
Modo de canalización administrada a clásico
Haga clic en Aceptar para aplicar los cambios.