Publicación de servicios web con encabezados SOAP
Al ejecutar el Asistente para publicar servicios Web de BizTalk, se agregan encabezados SOAP a los servicios Web. Cuando publica un servicio web que admite encabezados SOAP, éstos pasan a estar disponibles para orquestaciones y componentes de canalización como propiedades de contexto que contienen representaciones de cadena de los encabezados SOAP.
Encabezados SOAP definidos
Al agregar un encabezado SOAP definido mediante el asistente, éste crea una propiedad de contexto con un nombre que se corresponde con el elemento raíz del encabezado SOAP. Todas las propiedades de contexto de encabezado SOAP definidas tienen el espacio de nombres http://schemas.microsoft.com/BizTalk/2003/SOAPHeader
. Cuando el adaptador de SOAP convierte la solicitud SOAP en un mensaje de BizTalk, crea una propiedad de contexto de encabezado SOAP.
En el siguiente ejemplo se muestra una solicitud SOAP simple:
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<OrigDest xmlns="http://SOAPHeaderWS.ItemAvailability">
<Origination>Work</Origination>
<Destination>Home</Destination>
</OrigDest>
</soap:Header>
<soap:Body>
</soap:Body>
</soap:Envelope>
Para la solicitud SOAP simple, el adaptador SOAP creó un mensaje de BizTalk con una propiedad de contexto de encabezado SOAP OrigDest y la cadena.
El siguiente ejemplo muestra la cadena creada por el adaptador de SOAP:
"<?xml version="1.0" encoding="utf-16"?><OrigDest xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://SOAPHeaderSchemas.OrigDestSOAPHeader"><Origination xmlns="">Home</Origination><Destination xmlns="">Work</Destination> </OrigDest>"
Encabezados SOAP desconocidos
Si decide admitir encabezados SOAP desconocidos en el asistente, el asistente crea una propiedad de contexto con el nombre UnknownHeaders y el espacio de nombres http://schemas.microsoft.com/BizTalk/2003/soap-properties
. La propiedad de contexto UnknownHeaders contiene todos los encabezados SOAP desconocidos recibidos.
Por ejemplo, si recibe un encabezado SOAP desconocido con el nombre del elemento raíz, CustomerGroup, la propiedad de contexto UnknownHeaders contiene la cadena:
"<?xml version="1.0" encoding="utf-16"?><UnknownHeaders><CustomerGroup xmlns="http://SOAPHeaderWS/CustomerGroup"><Id xmlns="">My Customer</Id>
</CustomerGroup></UnknownHeaders>"
Para obtener más información sobre cómo agregar encabezados SOAP definidos o admitir encabezados SOAP desconocidos, vea Publicación de una orquestación como servicio web. Consulte también Publicación de esquemas como un servicio web.