Publication de services web avec des en-têtes SOAP
Vous ajoutez des en-têtes SOAP à vos services Web lors de l'exécution de l'Assistant Publication de services Web BizTalk. Lorsque vous publiez un service Web prenant en charge les en-têtes SOAP, les en-têtes deviennent disponibles pour les orchestrations et composants de pipeline en tant que propriétés de contexte contenant des représentations sous forme de chaîne des en-têtes SOAP.
En-têtes SOAP définis
Lorsque vous ajoutez un en-tête SOAP défini à l'aide de l'Assistant, ce dernier crée une propriété de contexte dotée d'un nom qui correspond à l'élément racine de l'en-tête SOAP. Toutes les propriétés de contexte d’en-tête SOAP définies ont l’espace de noms http://schemas.microsoft.com/BizTalk/2003/SOAPHeader. Lorsque l'adaptateur SOAP convertit la demande SOAP en message BizTalk, il crée une propriété de contexte d'en-tête SOAP.
L'exemple suivant illustre une requête 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>
Pour la requête SOAP simple, l’adaptateur SOAP a créé un message BizTalk avec une propriété de contexte d’en-tête SOAP OrigDest et la chaîne.
L'exemple suivant illustre la chaîne créée par l'adaptateur 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>"
En-têtes SOAP inconnus
Si vous choisissez de prendre en charge les en-têtes SOAP inconnus dans l’Assistant, l’Assistant crée une propriété de contexte avec le nom UnknownHeaders et l’espace de noms http://schemas.microsoft.com/BizTalk/2003/soap-properties. La propriété de contexte UnknownHeaders contient tous les en-têtes SOAP inconnus reçus.
Par exemple, si vous recevez un en-tête SOAP inconnu avec le nom de l’élément racine , CustomerGroup, la propriété de contexte UnknownHeaders contient la chaîne :
"<?xml version="1.0" encoding="utf-16"?><UnknownHeaders><CustomerGroup xmlns="http://SOAPHeaderWS/CustomerGroup"><Id xmlns="">My Customer</Id>
</CustomerGroup></UnknownHeaders>"
Pour plus d’informations sur l’ajout d’en-têtes SOAP définis ou la prise en charge d’en-têtes SOAP inconnus, consultez Publication d’une orchestration en tant que service web. Consultez également Publication de schémas en tant que service web.