WSDL メッセージ・プロパティー

オペレーションのヘッダー・プロパティー

WSDL ファイルに組み込むそれぞれのオペレーションでは、メッセージと一緒に送信できる一連のヘッダー・プロパティーを定義します。これらのプロパティーは、WSDL ファイルの処理時にオペレーションから抽出され、オペレーションのメッセージが選択されると、IBM® DevOps Test Integrations and APIs (Test Integrations and APIs) メッセージのヘッダー・プロパティーに自動的に追加されます。通常、これらのプロパティーは、メッセージの Content-Type (通常は XML またはテキスト) と SOAP アクションで構成されます。

SOAP Fault

Web サービス要求がサーバーでエラーになると、SOAP Body 要素の代わりに SOAP Fault 要素が含まれた応答メッセージが、サーバーから送信されます。この SOAP Fault は、SOAP エンベロープの XML スキーマ定義で定義されています。 SOAP Fault を受け取ると、RPC エンコード・フォーマッターでも文書リテラル・フォーマッターでも、同じ構造の Test Integrations and APIs メッセージが生成されます。どちらの場合も SOAP Fault 要素が抽出され、XML テキスト・メッセージ・フォーマッターの場合と同じ要領で標準の XML メッセージ構造が生成されます。 SOAP Fault は、WSDL ファイル内で定義されていないため、標準の XML スキーマ・プロセスを使用して管理されます。

Test Integrations and APIs 内では、SOAP エンベロープの XML スキーマ定義を参照する XSD スキーマを定義できます。このスキーマにはいくつかの定義があり、それぞれ内容が異なる場合があります。

予期される SOAP Fault の定義を含む SOAP エンベロープを選択できます。要求から SOAP Fault が返される可能性がある場合は、受信された要求内でそのメッセージのスキーマとして必要な SOAP エンベロープの XSD を選択できます。その後、Fault のルートを選択し、必要な検証を使用して予期される構造を作成できます。

XML と SOAP メッセージのプロパティー

Test Integrations and APIs でメッセージ・プロパティーを使用することにより、テスト・アクション (「パブリッシュ」や「サブスクライブ」など) でのメッセージ・コンテンツの管理方法を構成できます。メッセージ・プロパティーを表示したり変更したりするには、メッセージ・エディターの要件または本文で SOAP メッセージのルートを右クリックします。

「フィールド・プロパティー」ダイアログ・ボックスを使用して、メッセージ・プロパティーを表示または編集します。

ヒント:

いつでも「プレビュー」をクリックして、変更したプロパティーを使用して適用されたメッセージを表示できます。

「フィールド・プロパティー」ダイアログで構成できるタブは、以下のとおりです。

XML

「XML」タブでは、メッセージの XML コンテンツの管理方法を構成できます。

各オプションについて、次の表で説明します。

表 1. XMLのプロパティー
オプション	説明
フォーマット設定	XML は、`単一行` または`複数行インデント` のいずれかのメッセージとしてフォーマットされます。
エンコード	使用する必要がある文字エンコード。指定した場合、XML 宣言に含める必要があります。
文書の正規化	XML では、余分なスペースが削除されます。
NULL 値の送信	生成される XML に `null` 値の Elements、Attributes、または Comments が含まれているかどうか。
XML 宣言を組み込む	XML 宣言はメッセージの先頭に組み込まれます。
テキストとして処理	処理する際、CDATA ノードはテキスト・ノードに変換されます。
空白文字を保持	`xml:space` のルート・ノードのデフォルトを `preserve` に設定するかどうかを制御します。

ヒント:

XMLオプションのデフォルト値は、「設定」ウィンドウ(Test Integrations and APIs)を使用して変更できます(「ウィンドウ」 > 「設定」を選択してから、「XML」オプションを選択します)。

SOAPヘッダー

「SOAP ヘッダー」タブで、メッセージに含まれる SOAP ヘッダーの送信を使用可能または使用不可にしたり、現在のメッセージに含まれているすべてのヘッダーを表示したりできます。
SOAPヘッダー

「使用可能にする」チェック・ボックスを選択またはクリアして、現在のメッセージへの SOAP ヘッダーの組み込みを切り替えることができます。

ヒント:

SOAPヘッダーのデフォルト設定は、「設定」ウィンドウ(Test Integrations and APIs)を使用して指定できます(「ウィンドウ」 > 「設定」を選択してから、「SOAP」オプションを選択します)。

SOAP

「SOAP」タブで、SOAP のバージョン (1.1 または 1.2) およびメッセージに適用可能なその他のパラメーターを指定できます。
SOAP フィールド・プロパティー

リストから SOAP バージョンを選択し、メッセージ本文内で使用する名前空間 URI を指定することによって、SOAP メッセージを構成できます。指定する名前空間は、本文の名前空間 URI がオーバーライドします。しかし、「XML」タブから「プレビュー」をクリックしたときに、プレビューに表示されません。

制約事項:

指定する名前空間は、RPC エンコードのメッセージにのみ適用されます。

ヒント:

(子属性 を追加することで) 接頭部を含む任意の数のカスタム名前空間を SOAP Headers に追加できます。 Body 要素の名前空間 URI をオーバーライドするには、Value ホルダー・ノード (トークン) を右クリックしてから、「xmlns:tns」オプションを選択して、Body 要素のカスタム名前空間 URI を指定する必要があります。

デフォルトの接頭部を適用しない場合は、「エンベロープ名前空間接頭部」フィールドで、メッセージのエンベロープ名前空間接頭部を指定できます。 SOAP 1.1 メッセージに使用されるデフォルトの SOAP エンベロープ名前空間接頭部は SOAP-ENV、SOAP 1.2 メッセージの場合は env です。

ヒント:

SOAPのデフォルト設定は、「設定」ウィンドウ(Test Integrations and APIs)を使用して指定できます(「ウィンドウ」 > 「設定」を選択してから、「SOAP」オプションを選択します)。

WS-Addressing

「WS-Addressing」タブで、メッセージ構成体 (エンドポイントおよび情報ヘッダーを含む) を SOAP メッセージとともに送信することを有効または無効にします。送信されるWS-Addressingのプロパティーは変更することもできます。

ヒント:

「設定」ウィンドウ(Test Integrations and APIs)でWS-Addressing構成体のデフォルト送信を有効または無効にできます(「ウィンドウ」 > 「設定」を選択してから、「WS-*拡張」オプションを選択します)。

WS-Security

「WS-Security」タブで、WS-Security アクションを SOAP メッセージとともに送信するかどうかを指定できます。

ヒント:

「設定」ウィンドウ(Test Integrations and APIs)でWS-Securityアクションのデフォルト送信を有効または無効にできます(「ウィンドウ」 > 「設定」を選択してから、「WS-*拡張」オプションを選択します)。