フォーム入力 ビューでは、 GUI のフォーム フィールドでパラメーター値を入力できます。

このセクションの内容:

全般オプション

フォーム入力ビューの上部には、[操作] ドロップダウン メニューがあります。[操作] ドロップダウン メニューには、呼び出して処理を実行できるメソッド/操作のリストが表示されます。


有効な WSDL URL が入力されている場合、操作のリストは自動的に作成されます。リストから処理対象の操作を選択できます。

メイン画面には、メッセージがツリー形式で表示されます。SOAP ベースのツールの場合、ビューのメイン エリアには [SOAP ボディ] タブと [SOAP ヘッダー] の 2 つのサブタブがあります。 [SOAP ヘッダー] タブについての詳細については、「Adding SOAP Headers」を参照してください。 [WSDL] タブでメッセージ タイプに Plain XML を選択した場合、 [SOAP ボディ] タブと [SOAP ヘッダー] タブは利用できません。表示されているコントロールを使用して、ツリーの各ノードに対してパラメーター値の設定方法を指定できます。以下のオプションがあります。

• 固定: フォームのフィールドに文字列などのリテラル値を入力する場合、このオプションを選択します。[値] ドロップダウン リストで [固定] を選択した場合、表示された画面でツール パラメーターのリテラル値を入力します。表示される画面の項目はメソッドによって異なります。詳細については「Specifying Literal Values」を参照してください。

• パラメータライズ: データ ソースの値を使用するには、このオプションを指定します (先に適切なデータ ソースをレスポンダー スイートまたはテスト スイートに追加しておく必要があります)。

• 自動: 自動的にパラメーター値を生成する場合、このオプションを選択します。自動パラメーター生成は、サービスの制約を評価し、どのデータ タイプが失敗するかを確認したい場合に特に便利です。[自動] を選択した場合、コントロールの右側には何も入力する必要がありません。値は自動的に生成されます。フォーム JSON では、このオプションは利用できません。

• スクリプト: 実行時にスクリプトでパラメーターを生成する場合、このオプションを選択します。[値] ドロップダウン リストで [スクリプト] を選択した場合、[スクリプトの編集] をクリックし、表示されるダイアログでメソッドの場所 (またはメソッド自体) を指定します。メソッドは、オブジェクトを返す Java のスタティックなメソッドであり (またはデフォルト コンストラクターを持つ Java クラスであり)、Web サービスが期待するシグニチャを満たさなければなりません。Parasoft はメソッドを SOAP パラメーターに変換し、テスト ケースが実行されるときに SOAP 呼び出しとしてこのパラメーターを送ります。メソッドの追加方法については、「スクリプトを使用した拡張機能の基礎」を参照してください。

• 入力: このツールが他のツールに連結されており、最初のツールの結果を 2 番目のツールのパラメーターとして使用する場合、このオプションを選択します。 

リテラル値の指定

[値] ドロップダウン リストから [固定] を選択すると、メッセージの一部としてリテラル値を送信できます。メソッドによって、さまざまなオプションが利用可能です。

オプション構成によって、リテラル値として単純なパラメーターを送信することも、配列などの複雑なオブジェクト内でネストされたパラメーターを送信することもできます。

単純なパラメーターの構成

単純なパラメーターを構成する場合、ツールでデータ ソースを指定しているかどうかおよび WSDL の XML スキーマに nil 要素があるかどうかによって、オプションが異なります。

単純なパラメーターの値を構成する場合、次のオプションがあります。

• nil: nil 属性がツールによって送信されるかどうかを指定します。このチェックボックスがオンの場合、nil 属性は送信されます。このチェックボックスがオフの場合、nil 属性は送信されません。フォーム JSON の場合、フィールドは nil ではなく null であることに注意してください。
• Fixed/Parameterized Value: ([nil] チェックボックスがオフであり、[optional] チェックボックスが表示されている場合はオンである場合にのみ使用可能) ツールが送信する値を指定します。ツールでデータソースを指定している場合、固定値 (Fixed) またはパラメーター値 (Parameterized) を選択できます。データ ソースを指定していない場合、固定値のみを使用できます。
  • Fixed: テキスト フィールドにリテラル値を入力します。
    
    
    
    上の図では、2 番目および 3 番目の固定値項目の左側にあるチェックボックスは、項目が任意であることを示しています。チェックボックスがオンの場合、要素はメッセージに含められて送信されます。チェックボックスがオフの場合、要素は省略されます。
  • Parameterized: ドロップダウン リストにデータ ソースの列の値が表示されます。パラメータライズ値を構成する場合、ドロップダウン ボックスにはデータ ソース列名が含まれます。この列名は、ツールで指定されたデータ ソースに対応します。選択したデータ ソース列のすべての値がリテラル値としてツールによって送信されます。
    
    
    
    リポジトリ データ ソースからパラメータライズしている場合は必ず、複雑な要素のパラメータライズには [レコード リスト] 列を使用し、単純な要素のパラメータライズには [プリミティブ] または [プリミティブ リスト] 列を使用してください。

ネストされたパラメーターの構成

ツールで指定された WSDL がオブジェクト配列を持つ場合、[Value] フィールドの下に [Index] および [Value] 列が表示されます。メッセージの一部としてツールが送信するパラメーター値をネストできます。

Data Repository データ ソースの階層データを使ったパラメータライズ

Parasoft Data Repository データ ソース列から複雑な XML 要素をパラメータライズすることができます。ゼロ、1 個、または複数の階層レコード値を参照できます。

1. それには、「リポジトリ データ ソースの作成」で説明するように Parasoft Data Repository データ ソースを追加します。

2. そして「フォーム ビューによる階層的パラメータライズ」で説明するように該当の列をパラメータライズします。

詳細オプション

フォーム入力ビューでは、次の詳細オプションを設定できます。

SOAP ヘッダーの追加

フォーム入力 ビューの [SOAP ヘッダー] タブでは、ヘッダー パラメーターを指定できます。ヘッダーを追加するには、[SOAP ヘッダー] タブで次の操作を行います。

1. [追加] をクリックします。[新規 SOAP ヘッダーの追加] ダイアログが表示されます。

2. 利用可能なヘッダー タイプから、Custom、WS-Security、SAML 1.1 Assertion、SAML 2.0 Assertion、WS Addressing、WS ReliableMessaging、Import Schema Element as Header のいずれかを選択し、[OK] をクリックします。 利用可能なオプションの詳細については、次のセクションを参照してください。
   • WS-Security Options
   • WS Addressing Options
   • SAML 1.1 Assertion Options
   • SAML 2.0 Assertion Options
   • WS Reliable Messaging Options

WS-Security オプション

利用可能なヘッダー タイプから WS-Security を選択した場合、[タイムスタンプ] タブ、 [ユーザー名トークン] タブ、 [BinarySevurity トークン] タブ、そして [オプション] タブから次のオプションを設定できます。

[タイムスタンプ] タブ

[タイムスタンプ] タブでは、次のオプションを設定できます。

[ユーザー名トークン] タブ

[ユーザー名トークン] タブでは、次のオプションを設定できます。

[BinarySecurity トークン] タブ

次のオプションを設定できます。

[オプション] タブ

[オプション] タブでは、次のオプションを設定できます。

WS Addressing オプション

利用可能なヘッダー タイプで WS Addressing を選択した場合、次の 4 つのヘッダー タイプがデフォルトで送信されます: Action、To 、MessageID、および Reply/To。 次のヘッダーはデフォルトでは送信されません: RelatesTo、From、FaultTo。これらのヘッダー タイプは [Action/To] タブ、 [MessageID/ReplyTo] タブ、および [RelatesTo/From/FaultTo] タブで構成できます。また、デフォルトで 2004/08 名前空間が使用されます (たとえば http://schemas.xmlsoap.org/ws/2004/08/addressing)。

[Action/To] タブ

[Action/To] タブでは、次のオプションを設定できます。

[MessageID/ReplyTo] タブ

[MessageID/ReplyTo] タブでは、次のオプションを設定できます。

[RelatesTo/From/FaultTo] タブ

[RelatesTo/From/FaultTo] タブでは、次のオプションを設定できます。

SAML 1.1 Assertion オプション

利用可能なヘッダー タイプから SAML 1.1 Assertion を選択した場合は、「Adding SAML Headers」を参照してください。

SAML 2.0 Assertion オプション

利用可能なヘッダー タイプから SAML 2.0 Assertionを選択した場合、OASIS SAML Token Profile に対応するさまざまなオプションを利用できます。詳細については、 http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=security を参照してください。

WS Reliable Messaging オプション

利用可能なヘッダー タイプから WS Reliable Messaging を選択した場合、次のオプションを設定できます。

Custom オプション

利用可能なヘッダー タイプから Custom を選択した場合、次のオプションを設定できます。

Import Schema Element as Header オプション

利用可能なヘッダー タイプから Import Schema Element as Header を選択した場合、ダイアログが表示され、宣言済み要素をスキーマ ロケーションからロードできます。要素をロードすると、SOAP ヘッダーに対して複数の要素を選択できます。[OK] をクリックすると、選択した要素の構造と新しいヘッダーがツールに追加されます。

SAML ヘッダーの追加

フォーム入力 ビューの [SOAP ヘッダー] タブでは、 ヘッダー パラメーターを指定できます。SAML 1.1 ヘッダーを追加する場合、次の 4 種類の SAML 確認方法を選択できます。

• Sender-Vouches: 署名なし: 最小限の sender-vouches SAML アサーションを含みます。リクエスト メッセージの作成にオプション要素は含まれません。SAML アサーションに署名または証明書は必要とされません。
  • 詳細については「Sender-Vouches:SenderVouches Unsigned署名なし」を参照してください。
• Sender-Vouches: 署名なし: SSL: 最小限の sender-vouches SAML アサーションを含みます。署名は必要とされませんが、トランスポートが SSL を介すため、トランスポート層で SSL をサポートするために証明書が必要とされます。
  • 詳細については「Sender-Vouches: 署名なし:Form Input View OptionsSSL 」を参照してください。
• Sender-Vouches: 署名あり: sender-vouches SAML アサーションを含みます。アサーションとボディ要素の両方が署名される一方、署名の検証に使用する証明書への参照はヘッダーで提供されます。
  • 詳細については「Sender-Vouches:SenderVouches Signed署名あり」を参照してください。
• Holder-of-Key: holder-of-key SAML アサーションを含みます。エンベロープされた署名は、発行者キーストアを使って Assertion 要素に渡され、署名の検証に使用する証明書はアサーションの署名に含まれます。ボディは、アサーションの SubjectConfirmation 要素に格納されるユーザー証明を使って署名されます。
  • 詳細については「Sender-Vouches:SenderVouches Signed署名あり」を参照してください。

Sender-Vouches: 署名なし

「Sender-Vouches: 署名なし」の確認メソッドを追加するには、フォーム入力ビューの [SOAP ヘッダー] タブで次の操作を行います。

1. [追加] をクリックします。[新規 SOAP ヘッダーの追加] ダイアログが表示されます。
   
   
   
   
2. [SAML 1.1 Assertion] を選択し、 [OK] をクリックします。[SAML 確認メソッドの選択] ウィザードが表示されます。
   
   
   
   
3. [Sender-Vouches: 署名なし] を選択し、[次へ] をクリックします。
   
   
   
   
4. 目的の SAML ステートメント タイプを選択し、 [次へ] をクリックします。
   
   
   
   
5. [認証ステートメント] の必要なフィールドに入力し、 [終了] をクリックします。認証ステートメントの詳細については、 「Adding and Modifying SAML Statements」を参照してください。

Sender-Vouches: 署名なし: SSL

「Sender-Vouches: 署名なし: SSL」確認メソッドを追加するには、フォーム入力ビューの [SOAP ヘッダー] タブで次の操作を行います。

1. [追加] をクリックします。[新規 SOAP ヘッダーの追加] ダイアログが表示されます。
   
   
   
   
2. [SAML 1.1 Assertion] を選択し、 [OK] をクリックします。[SAML 確認メソッドの選択] ウィザードが表示されます。
3. [Sender-Vouches: 署名なし: SSL] を選択し、[次へ] をクリックします。
   
   
   
   
4. 必要に応じて [条件の使用] チェックボックスをオンにします。
   • [条件の使用] チェックボックスをオンにする場合、目的の条件のタイプ、または [なし] を選択します。
   • [オーディション制約] を選択し 0 より大きい値を入力する場合、 [次へ] をクリックすると [Audience Restriction Condition] を設定できます。
5. [次へ] ボタンをクリックします。
   
   
   
   
6. 目的の SAML ステートメント タイプを選択し、 [次へ] をクリックします。
   
   
   
   
7. [認証ステートメント] の必要なフィールドに入力し、 [終了] をクリックします。認証ステートメントの詳細については、 「Adding and Modifying SAML Statements」を参照してください。

Sender-Vouches: 署名あり

「Sender-Vouches: 署名あり」確認メソッドを追加するには、フォーム入力ビューの [SOAP ヘッダー] タブで次の操作を行います。

1. [追加] をクリックします。[新規 SOAP ヘッダーの追加] ダイアログが表示されます。
   
   
   
   
2. [SAML 1.1 Assertion] を選択し、 [OK] をクリックします。[SAML 確認メソッドの選択] ウィザードが表示されます。
   
   
   
   
3. [Sender-Vouches: 署名あり] を選択し、[次へ] をクリックします。
   
   
   
   
4. 目的の署名オプションを選択し、[次へ] をクリックします。
   
   
   
   
5. 必要に応じて [条件の使用] チェックボックスをオンにします。
   • [条件の使用] チェックボックスをオンにする場合、目的の条件のタイプ、または [なし] を選択します。
   • [オーディション制約] を選択し 0 より大きい値を入力する場合、 [次へ] をクリックすると [Audience Restriction Condition] を設定できます。
6. [次へ] ボタンをクリックします。
   
   
   
   
7. [発行者キーストア] ドロップダウン リストから、アサーションとボディの発行者署名に使用するキーストアを選択し、[Next] ボタンをクリックします。
8. 目的の SAML ステートメント タイプを選択し、 [次へ] をクリックします。
   
   
   
   
9. [認証ステートメント] の必要なフィールドに入力し、 [終了] をクリックします。認証ステートメントの詳細については、 「Adding and Modifying SAML Statements」を参照してください。

Holder-of-Key

「Holder-of-Key」 確認メソッドを追加するには、 フォーム入力ビューの [SOAP ヘッダー] タブで次の操作を行います。

1. [追加] をクリックします。[新規 SOAP ヘッダーの追加] ダイアログが表示されます。
   
   
   
   
2. [SAML 1.1 Assertion] を選択し、 [OK] をクリックします。[SAML 確認メソッドの選択] ウィザードが表示されます。
   
   
   
   
3. [Holder-of-Key] を選択し、[次へ] をクリックします。
   
   
   
   
4. 必要に応じて [条件の使用] チェックボックスをオンにします。
   • [条件の使用] チェックボックスをオンにする場合、目的の条件のタイプ、または [なし] を選択します。
   • [オーディション制約] を選択し 0 より大きい値を入力する場合、 [次へ] をクリックすると [Audience Restriction Condition] を設定できます。
5. [次へ] ボタンをクリックします。
   
   
   
   
6. Assertion 要素に渡す発行者のエンベロープ署名に使用するキーストアと、ユーザーがボディ要素の署名に使用するキーストアを選択します。[次へ] ボタンをクリックします。
7. 目的の SAML ステートメント タイプを選択し、 [次へ] をクリックします。
   
   
   
   
8. [認証ステートメント] の必要なフィールドに入力し、 [終了] をクリックします。認証ステートメントの詳細については、 「Adding and Modifying SAML Statements」を参照してください。

SAML ステートメントの追加と変更

SAML ステートメントは、アサーションの作成時に追加する必要があります。次の選択が可能です。

• Authentication Statement
• Authorization Decision Statement
• Attribute Statement

SAML ステートメントは、アサーションの作成後に追加および変更して、アサーションを拡張したりカスタマイズしたりできます。それには、次の操作を行います。

1. [SOAP ヘッダー] タブで SAML Assertion を選択します。
2. [変更] をクリックします。
   
   
   
   
3. [編集] ダイアログでアサーションの編集と、 SAML ステートメントの追加/編集を行います。
   • ステートメントを追加/変更する場合は、すべての有効なフィールドを入力してください。最小限必要なステートメントとなります。必要に応じて、デフォルトで無効になっているその他のフィールドを有効にし、入力してください。
   • WS-Security SAML プロファイル設定のように、デフォルトでは SAML アサーション要素は wsse:Security 要素に含まれます。直接ヘッダーに含ませる場合 (たとえば、 SAML アサーション要素が 直接 SOAP エンベロープ ヘッダーの下にあることを期待し、 WSSecurity を認証しない システムとの互換性を許可する場合) には、[WS-Security 属性] タブで [wsse:Security 要素でラップする] オプションをオフにします。