Freigeben über


Veröffentlichen von Webdiensten mit SOAP-Headern

Sie fügen SOAP-Header zu Ihren Webdiensten hinzu, wenn Sie den Assistenten zum Veröffentlichen von BizTalk-Webdiensten ausführen. Wenn Sie einen Webdienst veröffentlichen, der SOAP-Header unterstützt, werden die Header für Orchestrierungen und Pipelinekomponenten als Kontexteigenschaften verfügbar, die Zeichenfolgendarstellungen der SOAP-Header enthalten.

Definierte SOAP-Header

Wenn Sie mithilfe des Assistenten einen definierten SOAP-Header hinzufügen, erstellt der Assistent eine Kontexteigenschaft mit einem Namen, der dem Stammelement des SOAP-Headers entspricht. Alle definierten SOAP-Headerkontexteigenschaften weisen den Namespace http://schemas.microsoft.com/BizTalk/2003/SOAPHeaderauf. Wenn der SOAP-Adapter die SOAP-Anforderung in eine BizTalk-Nachricht konvertiert, wird eine SOAP-Headerkontexteigenschaft erstellt.

Das folgende Beispiel zeigt eine einfache SOAP-Anforderung:

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

Für die einfache SOAP-Anforderung hat der SOAP-Adapter eine BizTalk-Nachricht mit einer SOAP-Headerkontexteigenschaft OrigDest und der Zeichenfolge erstellt.

Das folgende Beispiel zeigt die vom SOAP-Adapter erstellte Zeichenfolge:

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

Unbekannte SOAP-Header

Wenn Sie im Assistenten unbekannte SOAP-Header unterstützen, erstellt der Assistent eine Kontexteigenschaft mit dem Namen UnknownHeaders und dem Namespace http://schemas.microsoft.com/BizTalk/2003/soap-properties. Die UnknownHeaders-Kontexteigenschaft enthält alle empfangenen unbekannten SOAP-Header.

Wenn Sie beispielsweise einen unbekannten SOAP-Header mit dem Stammelementnamen "CustomerGroup" erhalten, enthält die UnknownHeaders-Kontexteigenschaft die Zeichenfolge:

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

Weitere Informationen zum Hinzufügen von definierten SOAP-Headern oder zur Unterstützung unbekannter SOAP-Header finden Sie unter Veröffentlichen einer Orchestrierung als Webdienst. Siehe auch Veröffentlichungsschemas als Webdienst.

Siehe auch

SOAP-Header mit veröffentlichten Webdiensten