WS-Addressing ヘッダー情報は、メッセージ・フローから可視のローカル環境ツリーに配置できます。 WS-Addressing ヘッダー情報を処理できるのは SOAP ノードだけです。
SOAP ノードによってインバウンド情報がローカル環境に配置されるのは、ノード上でアドレッシングを採用し、SOAPInput、SOAPAsyncResponse、または SOAPRequestノードで「WS-Addressing ヘッダーを LocalEnvironment に配置」プロパティーを選択した場合だけです。
以下の表では、ローカル環境ツリー内にあるノード固有の WS-Addressing 情報について説明しています。
ノード | 取り込まれるローカル環境プロパティー |
---|---|
SOAPInput | LocalEnvironment.SOAP.Input.WSA.type |
SOAPAsyncResponse | LocalEnvironment.SOAP.Response.WSA.type |
SOAPRequest | LocalEnvironment.SOAP.Request.WSA.type |
ここで、type はローカル環境 WS-Addressing XML スキーマのサブセクションの構造です。 WS-Addressing 仕様で定義されている WS-Addressing プロパティーとの type のマップについて詳しくは、このトピックの、ローカル環境プロパティー typeセクションを参照してください。
インバウンド・メッセージのローカル環境情報は、ユーザーご自身限定の情報です。 ノードでアドレッシングを採用し、そのノードで「WS-Addressing ヘッダーを LocalEnvironment に配置」プロパティーを選択すると、WS-Addressing 情報を表示して、フローで使用できるようになります。 WS-Addressing プロパティーは、ノードによって処理された後にローカル環境に配置されます。 WS-Addressing フォルダーおよびそのすべての子は XMLNSC パーサーの所有です。このため、XMLNSC パーサーが所有する他のツリーにエレメントを直接コピーできます。 ただし、XMLNSC パーサーが所有していないツリーにこのフォルダー (またはその任意の子) をコピーすると、ターゲット・ツリーで最初に XMLNSC パーサーを作成しない限りはツリー内の情報は破棄されることに注意してください。 例えば、InputLocalEnvironment ツリーから OutputLocalEnvironment ツリーにコピーする場合などに、こうしたことが生じ得ます。
アウトバウンド WS-Addressing ヘッダー情報をローカル環境に配置できますが、そうする必要があるのはノードによって自動的に生成されたデフォルトを指定変更する場合だけです。 WS-Addressing がノード上で有効な場合に限って、アウトバウンド・アドレッシング・ヘッダーが作成されます。
以下の表では、ローカル環境ツリー内にあるノード固有の WS-Addressing 情報について説明しています。これを使用して、アウトバウンド・メッセージのデフォルトを指定変更できます。
ノード | 取り込まれるローカル環境プロパティー |
---|---|
SOAPReply | LocalEnvironment.Destination.SOAP.Reply.WSA.type |
SOAPRequest | LocalEnvironment.Destination.SOAP.Request.WSA.type |
SOAPAsyncRequest | LocalEnvironment.Destination.SOAP.Request.WSA.type |
ここで、type はローカル環境 WS-Addressing XML スキーマのサブセクションの構造です。 WS-Addressing 仕様で定義されている WS-Addressing プロパティーとの type のマップについて詳しくは、このトピックの、ローカル環境プロパティー typeセクションを参照してください。
アウトバウンド・メッセージのローカル環境情報を変更できます。 SOAPReply、SOAPRequest、および SOAPAsyncRequest の各ノードはデフォルトのローカル環境設定を生成します。これは指定変更できます。 この表には 1 つの例外があります。SOAPAsyncRequest ノードで WS-Addressing ReplyTo アドレッシングの指定変更を試行しても無視されます。
SET OutputRoot = InputRoot;
SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.To.Address = 'jms:jndi:INPUTQ';
SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.ReplyTo.Address = 'jms:jndi:RESPONSEQ?jndiConnectionFactoryName=QCF&
jndiInitialContextFactory=com.sun.jndi.fscontext.RefFSContextFactory&
jndiURL=file://C:/SOAPJNDIBindings';
SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.From.Address = 'jms:jndi:INPUTQ';
SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.FaultTo.Address = 'jms:jndi:RESPONSEQ?jndiConnectionFactoryName=QCF&
jndiInitialContextFactory=com.sun.jndi.fscontext.RefFSContextFactory&
jndiURL=file://C:/SOAPJNDIBindings';
SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.Action = 'http://WMB_BankImport/NewOperation';
SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.MessageID = 'test:my:msg:ID:1234578';
エレメント | 相当する WS-Addressing MAP 抽象名 |
---|---|
To | [destination endpoint] |
From | [source endpoint] |
ReplyTo | [reply endpoint] |
FaultTo | [fault endpoint] |
Action | [action] |
MessageId | [message id] |
RelatesTo | [relationship] |
ReferenceParameters | [reference parameters] |
Version | このエレメントは MAP に対応しませんが、WS-Addressing のバージョンを識別するために使用されます。 S-Addressing の 2 つの主なバージョンは、Submission および Final です。 すべてのノードで使用されるデフォルトのバージョンは Final です。 ですから、アウトバウンド・メッセージでこのエレメントを設定するのは、バージョンを Submission にする場合だけです。 着信メッセージの場合、このエレメントには、インバウンド・メッセージが使用した WS-Addressing ヘッダーのバージョンが自動的に取り込まれます。 |
WS-Addressing 仕様によって定義されるメッセージ・アドレッシング・プロパティーの詳細については、WS-Addressingを参照してください。
アウトバウンド WS-Addressing では、追加のローカル環境プロパティーを設定できます。
エレメント | 説明 |
---|---|
AddMustUnderstandAttribute | このエレメントは、メッセージ送信前に、各 WS-Addressing ヘッダーに SOAPmustUnderstand 属性を配置します。 |