BizTalk Web サービス発行ウィザードを実行するときに、Web サービスに SOAP ヘッダーを追加します。 SOAP ヘッダーをサポートする Web サービスを発行すると、SOAP ヘッダーの文字列表現を含むコンテキスト プロパティとして、ヘッダーがオーケストレーションおよびパイプライン コンポーネントで使用できるようになります。
定義済みの SOAP ヘッダー
ウィザードを使用して定義済みの SOAP ヘッダーを追加すると、ウィザードによって、SOAP ヘッダーのルート要素に対応する名前を持つコンテキスト プロパティが作成されます。 定義されているすべての SOAP ヘッダー コンテキスト プロパティには、名前空間 http://schemas.microsoft.com/BizTalk/2003/SOAPHeaderがあります。 SOAP アダプターは、SOAP 要求を BizTalk メッセージに変換するときに、1 つの SOAP ヘッダー コンテキスト プロパティを作成します。
次の例は、単純な 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>
単純な SOAP 要求の場合、SOAP アダプターは、1 つの SOAP ヘッダー コンテキスト プロパティ OrigDest と文字列を含む BizTalk メッセージを作成しました。
次の例は、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>"
不明な SOAP ヘッダー
ウィザードで不明な SOAP ヘッダーをサポートすることを選択した場合、ウィザードは UnknownHeaders という名前のコンテキスト プロパティを作成し、名前空間 http://schemas.microsoft.com/BizTalk/2003/soap-properties。
UnknownHeaders コンテキスト プロパティには、受信したすべての不明な SOAP ヘッダーが含まれます。
たとえば、ルート要素名 CustomerGroup を持つ不明な SOAP ヘッダーを受け取った場合、 UnknownHeaders コンテキスト プロパティには次の文字列が含まれます。
"<?xml version="1.0" encoding="utf-16"?><UnknownHeaders><CustomerGroup xmlns="http://SOAPHeaderWS/CustomerGroup"><Id xmlns="">My Customer</Id>
</CustomerGroup></UnknownHeaders>"
定義済みの SOAP ヘッダーの追加または不明な SOAP ヘッダーのサポートの詳細については、「 Web サービスとしてのオーケストレーションの発行」を参照してください。 「 Web サービスとしてのスキーマの発行」も参照してください。