Veröffentlichen von Webdiensten mit SOAP-Headern
Beim Ausführen des Assistenten für BizTalk-Webdienstpublishing fügen Sie Ihren Webdiensten SOAP-Header hinzu. Wenn Sie einen Webdienst veröffentlichen, der SOAP-Header unterstützt, stehen diese Header Ihren Orchestrierungen und Pipelinekomponenten als Kontexteigenschaften zur Verfügung, die Zeichenfolgendarstellungen der SOAP-Header enthalten.
Definierte SOAP-Header
Wenn Sie mit dem 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 verfügen über den Namespace http://schemas.microsoft.com/BizTalk/2003/SOAPHeader. Wenn der SOAP-Adapter die SOAP-Anforderung in eine BizTalk-Nachricht umwandelt, erstellt er eine SOAP-Headerkontexteigenschaft.
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 unbekannte SOAP-Header im Assistenten 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 definierter SOAP-Header oder zum Unterstützen unbekannter SOAP-Header finden Sie unter Veröffentlichen einer Orchestrierung als Webdienst. Weitere Informationen finden Sie unter Veröffentlichen von Schemas als Webdienst.