Condividi tramite


Pubblicazione di servizi Web con intestazioni SOAP

Puoi aggiungere intestazioni SOAP ai tuoi servizi Web quando esegui la Creazione guidata per la pubblicazione dei servizi Web di BizTalk. Quando si pubblica un servizio Web che supporta le intestazioni SOAP, le intestazioni diventano disponibili per orchestrazioni e componenti della pipeline come proprietà di contesto che contengono rappresentazioni di stringa delle intestazioni SOAP.

Intestazioni SOAP definite

Quando si aggiunge un'intestazione SOAP definita tramite la procedura guidata, la procedura guidata crea una proprietà di contesto con un nome che corrisponde all'elemento radice dell'intestazione SOAP. Tutte le proprietà del contesto dell'intestazione SOAP definite hanno lo spazio dei nomi http://schemas.microsoft.com/BizTalk/2003/SOAPHeader. Quando l'adapter SOAP converte la richiesta SOAP in un messaggio BizTalk, crea una proprietà di contesto dell'intestazione SOAP.

L'esempio seguente illustra una semplice richiesta SOAP:

<?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>  

Per la semplice richiesta SOAP, l'adapter SOAP ha creato un messaggio BizTalk con una proprietà di contesto dell'intestazione SOAP OrigDest e la stringa.

Nell'esempio seguente viene illustrata la stringa creata dall'adapter 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>"  

Intestazioni SOAP sconosciute

Se si sceglie di supportare intestazioni SOAP sconosciute nella procedura guidata, la procedura guidata crea una proprietà di contesto con il nome UnknownHeaders e lo spazio dei nomi http://schemas.microsoft.com/BizTalk/2003/soap-properties. La proprietà di contesto UnknownHeaders contiene tutte le intestazioni SOAP sconosciute ricevute.

Ad esempio, se si riceve un'intestazione SOAP sconosciuta con il nome dell'elemento radice, CustomerGroup, la proprietà di contesto UnknownHeaders contiene la stringa:

"<?xml version="1.0" encoding="utf-16"?><UnknownHeaders><CustomerGroup xmlns="http://SOAPHeaderWS/CustomerGroup"><Id xmlns="">My Customer</Id>  
</CustomerGroup></UnknownHeaders>"  

Per altre informazioni sull'aggiunta di intestazioni SOAP definite o sul supporto di intestazioni SOAP sconosciute, vedere Pubblicazione di un'orchestrazione come servizio Web. Vedere anche Pubblicazione di schemi come servizio Web.

Vedere anche

Intestazioni SOAP con servizi Web pubblicati