SOAPEnvelope ノードを使用して、SOAP エンベロープを既存のメッセージ上に追加します。 このノードは、SOAPExtract ノードと共に使用するように設計されています。
このトピックには、以下のセクションが含まれています。
対応する SOAPExtract ノードなしで、フロー内のノードを使用することもできます。ノードには、デフォルトの SOAP エンベロープを作成するオプションがあります。
SOAPEnvelope ノードは、パレットの 「Web サービス」 ドロワーにあり、WebSphere® Message Broker Toolkit では、次のアイコンで表されます。
このノードは、SOAPExtract ノードと共に使用するように設計されています。SOAPExtract ノードを参照してください。
SOAPEnvelope ノードのインスタンスをメッセージ・フローに入れると、それを構成することができます。メッセージ・フロー・ノードの構成を参照してください。 ノードのプロパティーが、「プロパティー」ビューに表示されます。
SOAP メッセージに対して完全な妥当性検査は行われません。単に BODY 要素を含む必要があるだけです。
SOAPInput node-> SOAPExtract node->SOAPEnvelope node
<?xml version="1.0"?>
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:tns="http://ws3.st.mqsi.ibm.com/App/DocLiteral1"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Header>
<tns:requestHeader>
<tns:assessorUrl>header1</tns:assessorUrl>
</tns:requestHeader>
</soapenv:Header>
</soapenv:Envelope>
<?xml version="1.0"?>
<tns:requestAvailability
xmlns:tns="http://ws3.st.mqsi.ibm.com/App/DocLiteral1"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<tns:carDetails>body1</tns:carDetails>
<tns:claimID>body2</tns:claimID>
<tns:location>body3</tns:location>
<tns:reqDate>body4</tns:reqDate>
</tns:requestAvailability>
<?xml version="1.0"?>
<soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:tns="http://ws3.st.mqsi.ibm.com/App/DocLiteral1"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<soapenv:Header>
<tns:requestHeader>
<tns:assessorUrl>header1</tns:assessorUrl>
</tns:requestHeader>
</soapenv:Header>
<soapenv:Body>
<tns:requestAvailability>
<tns:carDetails>body1</tns:carDetails>
<tns:claimID>body2</tns:claimID>
<tns:location>body3</tns:location>
<tns:reqDate>body4</tns:reqDate>
</tns:requestAvailability>
</soapenv:Body>
</soapenv:Envelope>
SOAPEnvelope ノードのターミナルについては、次の表に説明されています。
| ターミナル | 説明 |
|---|---|
| In | ノードが処理する SOAP メッセージを受け入れる入力ターミナル。 |
| Out | SOAP メッセージ本体および SOAP エンベロープから構成された SOAP メッセージを出力する出力ターミナル。 |
| Failure | 処理で障害が検出された場合に、メッセージがルーティングされる出力ターミナル。 |
以下の表は、ノード・プロパティーについて説明しています。 M の見出しの列は、プロパティーが必須 かどうかを示します (デフォルトが定義されていない場合に値を入力することが必要なら、アスタリスクのマークが付きます)。 C の見出しの列は、プロパティーが構成可能 (メッセージ・フローを BAR ファイルに追加してデプロイするとき、値を変更できる) かどうかを示します。
SOAPEnvelope ノードの「説明」プロパティーについては、次の表に説明されています。
| プロパティー | M | C | デフォルト | 説明 |
|---|---|---|---|---|
| ノード名 | いいえ | いいえ | ノード・タイプ | ノードの名前。 |
| 簡略説明 | いいえ | いいえ | ノードの簡単な説明 | |
| 詳細説明 | いいえ | いいえ | メッセージ・フロー内のノードの目的を説明するテキスト |
SOAPEnvelope ノードの基本プロパティーについては、次の表に説明されています。
| プロパティー | M | C | デフォルト | 説明 |
|---|---|---|---|---|
| 新規エンベロープの作成 | いいえ | いいえ | 選択されていない | このプロパティーは、ノードが SOAP エンベロープを作成するか、またはメッセージ・ツリーから既存のエンベロープを取得するかを制御します。チェック・ボックスを選択すると、ノードは新規のエンベロープを作成します。チェック・ボックスのチェックを外した場合は、ノードは「既存のエンベロープの場所」プロパティーに入力された値からエンベロープをコピーします。 |
| 既存のエンベロープの場所 | いいえ | いいえ | $LocalEnvironment/SOAP/Envelope | ノードが SOAP エンベロープをコピーするコピー元の場所を表す XPath 式。以下の相関名を使用できます。
|
| プロパティー | M | C | デフォルト | 説明 |
|---|---|---|---|---|
| イベント | なし | なし | なし | ノードに対して定義したイベントが、このタブに表示されます。デフォルトでは、メッセージ・フローのどのノードに対してもモニター・イベントは定義されません。ノードのモニター・イベントを作成、変更、または削除するには、「追加」、「編集」、および「削除」を使用します。詳しくは、モニター・プロパティーを使用したモニター・イベント・ソースの構成を参照してください。 「使用可能」チェック・ボックスを選択またはクリアすることによって、ここに表示されているイベントを使用可能および使用不可に設定できます。 |