このセクションでは、Web アプリケーションをスキャンするように SOAtest を設定する方法について説明します。「静的解析の実行」で説明しているように、アクセスされたページに対して静的解析を実行できます。
このセクションの内容:

スキャニングの構成

スキャニング テストとは、テスト ケースが実行されるときに、指定した Web アプリケーションをスキャンするテストのことです。Web アプリケーションをスキャンするよう SOAtest を構成するには、次のようにスキャニング テストを追加します。

1. 次のいずれかを実施します。
   • 新しい .tst ファイルにスキャニング テストを追加するには: 新しい .tst ファイルを追加するプロジェクト ノードを右クリックし、[テスト (.tst) ファイル] を選択します。新しい .tst ファイルの名前を入力して [次へ] をクリックし、[Web] > [Web アプリケーションのスキャン] を選択します。
   • 既存のプロジェクトにスキャニング テストを追加するには: 新しいテストを追加するテスト スイート ノードを右クリックし、[テストまたは出力の追加] を選択します。
     
     
     
     表示された [テストの追加 ] ウィザードで、左側から [標準テスト] を選択し、右側から [Scanning Tool] を選択します。[終了] をクリックします。
2. HTTP、FTP、ローカル ソースのどれからスキャンするのかを指定します。

   • [FTP] または [ローカル] を選択した場合、フィールドの入力が完了すれば、構成は完了です。残りのステップはスキップできます。

     FTP オプション

     FTP ソースを指定するとき、次のオプションがあります。

     • 大文字 / 小文字を区別しないサーバー: サーバーが大文字と小文字を区別しないことを示します。
     • シンボリック リンクに従う: オンの場合、FTP サイト上の実際のファイルまたはフォルダーであるかのように SOAtest はシンボリック リンクをスキャンします。リンクがフォルダーを指している場合、SOAtest はそのフォルダーの内容をスキャンします。
   • [HTTP] を選択した場合、以下のステップで説明している設定を行います。
3. [HTTP ツール設定] の [必須の基本設定] タブをクリックし、以下の設定を完了します。
   • 開始 URL: 単一の URL または .urls ファイルを指定します。

     • URL のユーザー名とパスワードが「*」として入力された場合、SOAtest はまず「この URL の直前の URL で同じドメインに属する URL」に使用されるのと同じ認証情報を使用しようとします。この認証情報がこの URL に適用しない場合、SOAtest はレルム パスワード ダイアログを開き、正しい認証情報の入力をユーザーに求めます。

       .urls ファイルの使用

       プロジェクトに正の制限を追加し、プロジェクト作成パネルで指定されたデフォルトの深さで、ファイルで指定された URL で開始するすべての適切なサイトのロードを開始する場合、.urls ファイルを使用します。ユーザー名とパスワードが保護 URL に指定されている場合、認証情報はプロジェクトに自動的に追加されます。

       .urls ファイルの書式は次のとおりです。URL は別々の行で指定します。URL に認証情報を指定する場合、「URL、ユーザー名、パスワード」の順番で URL と同じ行で指定しなければなりません。URL、ユーザー名、およびパスワードはカンマで区切ります。これらの項目でカンマを使用している場合、その項目を二重引用符で囲む必要があります。これらの項目で二重引用符を使用している場合、二重引用符をさらに別の二重引用符でエスケープし、項目全体を二重引用符で囲む必要があります。例:
       http://url1.com/
       http://url2.com/, username, password
       http://url3.com/, "user,name", ",password,"
       http://url4.com/, "username", "pass""word"

   • ロードする階層数の上限: サイト全体をロードしたくない場合、このオプションを使ってロードの深さを制限します。サイトをロードするクリック (リンク) の数で深さを指定します。0 は最初のページだけをロードすることを意味します。このオプションは、サイト中の特定のパスだけを指定してテストしたい場合やログ ファイル エントリに記録されたトラフィックに基づいてサイトの構造とパスを自動的に作成したい場合に特に役立ちます。
   • スキャンを開始 URL の下層ディレクトリに制限する: 開始 URL のサブディレクトリだけをロードしたい場合、このオプションをオンにします。詳細については、「開始 URL の最も深いサブディレクトリにスキャンを制限する」を参照してください。
   • テーブルで制限されていないリダイレクトに従う: 許可 URL として指定されていないサイトへのリダイレクトを追うよう SOAtest を設定したい場合、このオプションをオンにします。リダイレクト処理の詳細については、「Understanding and Configuring Redirect Handling」を参照してください。
   • 許可 / 制限する URL: 特定のページ (たとえばログアウト ページ) へのアクセスによってサイトが正しくロードされなかったり完全にロードされない可能性がある場合、そのようなページを制限 URL として指定してアクセスしないようにできます。詳細については、「Preparing SOAtest to Load Sites that Use JavaScript」 を参照してください。
   • フォーム オプション: 次のオプションが利用可能です。
     • デフォルト入力でフォームをスキャン: デフォルトはオフ。
     • アクティブな入力を手動で入力: デフォルトはオン。
4. 接続パスワードを入力する場合、[レルム パスワード] タブをクリックして [追加] をクリックし、パスワードを指定します。
5. 詳細なスキャニング オプションを指定する場合、[拡張設定] タブを選択して以下のように指定します。
   • デフォルト ページ: * (これがデフォルト設定です)
   • ロボット制限に従う: オフ (サイトの Web マスターによって、ロボットの制限を無視する権限が許可されている場合)
   • Cookie を渡す: オン
   • すべての引数で CGI を呼び出す: オン
   • 大文字 / 小文字を区別しないサーバー: 使用するサーバーによる。
   • エイリアス: サイトによる。サイトがエイリアスを使用する場合、[追加] ボタンをクリックしてエイリアスを入力します。エイリアスは、プロジェクト中のサイトのドメインと同等であると SOAtest が見なすドメインです。 たとえば、 http://www.parasoft.com のエイリアスとして parasoft.com と www.parasoft.com を指定できます。
6. [保存] をクリックします。

ここまでの操作が終了すると、テスト スイートまたは個別のスキャニング ツールに対して任意のテスト コンフィギュレーションを実行できます。 テストを実行すると、SOAtest は静的ページと動的ページを網羅し、アクセスした各ページのインスタンスを少なくとも 1 つロードします。

推奨される HTTP 構成オプションを選択していて、サイトにフォームがある場合、フォーム入力ダイアログからフォームにデータを投入できます。サイトのロード中にフォーム入力ダイアログが表示された場合、「Populating Forms」の説明にあるように入力します。

特別なロードの問題の処理

このセクションでは、以下の特別なロードの問題に対処する方法について説明します。

• スキャン中に許可または制限する URL の設定
• Preparing SOAtest to Load Sites that Use JavaScript
• Populating Forms
• Managing Authentication During Loading

スキャン中に許可または制限する URL の設定 

[許可/制限する URL] テーブルに許可または制限を追加することで、SOAtest がロードまたは無視するサイト URL をコントロールできます。

URL が「制限する」として指定されている場合、SOAtest のスキャン中にその URL は無視されます。特定のディレクトリやファイルを SOAtest にアクセスさせたくない場合、それらを「制限 URL」 として指定できます。たとえばログアウト ページがある場合、このページを制限 URL として指定すれば、他のページのロードが妨げられたり他のページが不正になることを防止できます。パスを作成したり仮想ユーザーを使ってサイトを実行したりするときなどに、SOAtest は制限 URL を回避します。サイトに Web サーバー ソースがある場合にはサイトにロードする前に制限 URL を指定できます (このセクションで説明します)。

URL が「許可する」としてマークされている場合、SOAtest はスキャン中にその URL に遭遇すると、その URL をロードします。[開始 URL] フィールドで指定した URL の最も深いディレクトリ URL パターンが自動的に「許可 URL」として追加されます。この URL を「許可するサブディレクトリ URL」と呼びます。ここで http(s)://... を使って URL を HTTP と HTTPS の両方で許可または制限することができます。詳細については「URL Restriction Examples」を参照してください。

さらに許可 URL を追加することもできます。この機能は、関連サイトをロードするよう SOAtest を設定するのに特に役立ちます。関連サイト とは、プロジェクトのサイトにリンクされているサイトで、ホスト名がプロジェクト サイトとは異なるサイトのことです。たとえば、プライマリ プロジェクト ソースが http://www.parasoft.com であり、このサイトが http://forums.parasoft.com と http://www2.parasoft.com にリンクしている場合、これらの 2 つのサイトは現行プロジェクトの関連サイトです。現行プロジェクトのコンテキストで SOAtest が関連サイトに遭遇したときに自動的に関連サイトをロードするには、関連サイトを許可 URL に指定する必要があります。

制限と許可はどちらも Scanning Tool の [許可/制限する URL] テーブルで指定します。許可はプラス記号でマークされ、制限はマイナス記号でマークされます。許可と制限は大文字と小文字を区別します。

制限と許可を組み合わせて、高度なスキャニング方法を作成できます。許可/制限は順番に処理されます。テーブルの先頭のエントリから開始し、テーブルの最後のエントリで終了します。

[許可/制限する URL] テーブルにエントリを追加するには、次の操作を行います。

1. [追加] ボタンをクリックします。新しい行が [許可/制限する URL] テーブルに追加されます。
2. 新規に追加された行のテキスト フィールドで、制限または許可する URL を入力します。
   • ワイルドカードのアスタリスク (*) を URL 中の任意の箇所で使って、0 個以上の文字に一致させることができます。 "*" は文字の任意の組み合わせを意味します。任意にワイルドカードを組み合わせて [許可/制限する URL] テーブルのエントリを作成できます。例については 「ワイルド カードの例」を参照してください。
   • URL の最後にスラッシュ (/) がある場合、比較前にスラッシュは削除されます。
3. 必要に応じて +/- 記号を切り替えて、指定された URL を許可するか制限するかを指定します。
   • プラス記号 (+) は、許可 URL をマークするために使用されます。
   • マイナス記号 (-) は、制限 URL をマークするために使用されます。

[許可/制限する URL] テーブルのエントリの位置を変更するには:

• 移動するエントリを選択し、 [上へ] または [下へ] ボタンをクリックします。

[許可/制限する URL] テーブルのエントリを削除するには:

• 削除するエントリを選択し、[削除] ボタンをクリックします。

URL の制限の例

以下は http(s)://... の制限の例です。

• デフォルトの http(s)://... の制限は、http:// または https:// に一致します。たとえば、デフォルトの制限の http(s)://www.google.com/* は
  http://www.google.com/amazing_page.html と
  https://www.google.com/amazing_page.html
  の両方に一致します。
• 文字列 "http(s)://" は、URL の先頭以外では URL 制限で意味を持ちません。 たとえば、
  *http(s)://www.google.com/*
  という制限を設定して以下に一致させることはできません。
  http://www.google.com/amazing_page.html
  文字列 "http(s)://" は大文字と小文字を区別します。そのため、HTTP(S)://www.google.com/*
  は
  http://www.google.com/amazing_page.html に一致しません。
• 括弧を使用できるのは、特別な文字列の "http(s)://" だけです。 たとえば、次の制限
  http://www.para(s)oft.com/*
  を使用して、
  http://www.parasoft.com/*
  あるいは
  http://www.paraoft.com/*
  に一致させることもできません。

ワイルド カードの例

以下はワイルドカードの使い方の例です。

*.parasoft.com は www.parasoft.com および articles.parasoft.com に一致します。

*parasoft* は www.parasoft.com、www.parasoft.net、parasoft.com などに一致します。

direc*ry/* は directory/dir2、direcHELLOry/dir2/dir3、および direc12345fry/images に一致します。

SOAtest のスキャン経験則

プロジェクトのスキャンとリフレッシュの最中、可能性のある URL が [許可/制限する URL] テーブルに対して照合され、その URL にアクセスするべきかどうかが判断されます。URL にアクセスするべきかどうかの判断は、以下のように行われます。

1. [許可/制限する URL] テーブルで最後に一致する URL を探します。
2. 最後に一致する URL の記号がプラスの場合、その URL が許可されます。記号がマイナスの場合、URL は制限されます。

「スキャン中に許可または制限する URL の設定」で説明している [許可/制限する URL] テーブルでは、サイトのどの部分をスキャンするかをコントロールできます。たとえば、サイト中のある部分にある特定の URL を「禁止」にして、本来であればスキャンされる URL をスキャン対象から外すことができます。あるいは、サイト中のある場所にある特定の URL に対してスキャンを許可し、本来であればスキャンされない URL をスキャンすることができます。

例 1

http://www.dev.parasoft.com/products/dir/page.html は、上記のテーブルの以下の URL に一致します。

+ http(s)://www.dev.parasoft.com/*
- http(s)://www.dev.parasoft.com/products/*
+ http(s)://www.*.com/products/dir/*

最後に一致する URL は http(s)://www.*.com/products/dir/* です。この URL はプラス記号であるため (つまり許可 URL であるため)、http://www.dev.parasoft.com/products/dir/page.html は許可されます。

URL http://www.dev.parasoft.com/products/soap.html は上記のテーブルからの以下の URL に一致します。

+ http(s)://www.dev.parasoft.com/*
- http(s)://www.dev.parasoft.com/products/*

最後に一致する URL は http(s)://www.dev.parasoft.com/products/* です。この URL はマイナス記号であるため (つまり制限 URL であるため)、http://www.dev.parasoft.com/products/soap.html は制限されます。この URL はプラス記号であるため (つまり許可 URL であるため)、http://www.dev.parasoft.com/products/dir/page.html は許可されます。

例 2

サイト http://www.dev.parasoft.com には、数千種類のソフトウェアに関連する情報があります。しかし、2 種類のハードウェア (ルーターとディスク) だけにスキャンを制限したいものとします。また、サイト中の古い部分を除き、他のすべての部分を処理したいものとします。

URL http://www.dev.parasoft.com/index.html からスキャンを開始するには、この URL を [開始 URL] フィールドに入力します。

許可 URL は [許可/制限する URL] テーブルに自動的に追加されます。

+ http(s)://www.dev.parasoft.com/*

hardware ディレクトリ内の Routers フォルダーと Disks フォルダーだけをスキャンするには、以下の順序で以下のエントリをテーブルに追加する必要があります。

-  http(s)://www.dev.parasoft.com/newdir/hardware/*
+  http(s)://www.dev.parasoft.com/newdir/hardware/Routers/*
+  http(s)://www.dev.parasoft.com/newdir/hardware/Disks/*

 古いディレクトリのスキャンを制限するには、以下のエントリを追加する必要があります。

- http(s)://www.dev.parasoft.com/olddir/*

操作が完了すると、テーブルは次のようになります。

開始 URL の最も深いサブディレクトリにスキャンを制限する

[スキャンを開始 URL の下層ディレクトリに制限する] オプションがオンの場合、SOAtest は自動的に開始 URL を取り、最も深いサブ ディレクトリに対して許可 URL を作成します。そしてこの URL を [許可/制限する URL] テーブルの先頭に追加します。このオプションをオフにした場合、デフォルトの「許可するサブディレクトリ URL」が [許可/制限する URL] テーブルに追加されます。また、最初のリダイレクト先が、同じ完全修飾ドメイン名の URL である場合にも、SOAtest はこのように動作します。

例:

リダイレクト処理の理解と設定

指定された開始 URL がリダイレクトである場合、SOAtest はそのリダイレクトとそれに続くリダイレクトをロードします。さらに、それらのリダイレクトごとに、許可するサブディレクトリ URL を自動的に追加します。これらのエントリはすべて [許可/制限する URL] テーブルの先頭に追加されます。

URL として追加されないリダイレクトを追うよう SOAtest を設定するには、[テーブルで制限されていないリダイレクトに従う] オプションをオンにします。このオプションがオンの場合、スキャン中にリダイレクトに遭遇し、このリダイレクトが [許可/制限する URL] テーブルで指定されていない場合、リダイレクトはロードされます。SOAtest は、このリダイレクトに対する許可するサブディレクトリ URL を [許可/制限する URL] テーブルに追加します。

JavaScript を使用するサイトをロードするための準備

JavaScript を含むサイトをロードする前に、[JavaScript の読み込み] チェックボックスがオンであることを確認します  (このオプションはデフォルトでオンです)。このオプションがオンの場合、SOAtest は JavaScript を実行し、関連するリンクをロードします。

このオプションがオンであることを確認するには、次の操作を行います。

1. [Parasoft] メニューの [設定] をクリックします。
2. [Parasoft] > [スキャニング] を選択します。
   
   

JavaScript イベント シミュレーションのカスタマイズ

JavaScript イベント (他のウィンドウのオープンとクローズ、タイマーの実行など) を SOAtest がシミュレートする方法をカスタマイズしたい場合、このタブで JavaScript オプションを変更することができます。以下の表に従って、どのオプションを選択するかを決定してください。

Alert、Confirm、Prompt メッセージの利用

サイトのスキャン中に JavaScript の Alert、Confirm、または Prompt メッセージに遭遇すると、SOAtest は GUI パネルの右側の結果エリアにメッセージを出力し、デフォルトのアクションを実行します。デフォルトでは、SOAtest は次のメッセージを出力し、次のアクションを実行します。

これらのメッセージの処理方法を変更したい場合、スクリプトを使ってカスタム動作を定義することができます。詳細については、「スクリプト フックによるスキャンのカスタマイズ」を参照してください。

フォームへのデータ投入

HTTP の設定の [アクティブな入力を手動で入力] チェックボックスをオンにした場合 (デフォルトはオンです)、SOAtest はユーザー入力が必要なフォームを検出するたびに、フォーム入力ダイアログを表示します。フォームがサブミットされた後に返されるページを SOAtest で解析したい場合、フォームのさまざまな入力要素 (テキスト フィールド、選択ボックス、チェックボックス、ラジオボタンなど) に SOAtest がどのようにデータを投入するかを設定する必要があります。ロード処理中にダイアログで入力の固定値を指定することで、この設定を行うことができます。

各フォームでテスト入力を追加する必要はありません。サイトのすべての主要エリアにアクセスするために必要な入力だけを追加することを推奨します。必要に応じてダイアログをスキップできます。さらに、特定のフォーム入力をサブミットすることなくすべてのサイト エリアに SOAtest が到達できる場合、ロード処理中にフォーム入力をユーザーが指定する必要はありません。

どのフォームにも入力を指定しないことを設定するには、次の操作を行います。

• 最初のダイアログで [すべてスキップ] をクリックします。

一部またはすべてのフォームで入力を指定するには、次の操作を行います。

• 以下の表に従って、表示された各ダイアログでどの操作を行うかを決定してください。

フォーム入力の目的とオプション

サイトがフォームを使用していて、フォームがサブミットされた後に返されるページを SOAtest でロードしてテストしたい場合、フォームのさまざまな入力要素 (テキスト フィールド、選択ボックス、チェックボックス、ラジオボタンなど) にどのようにデータを投入するかを指定する必要があります。より多くの異なるページ インスタンスをテストしたければ、フォームへのデータ投入に使用するために、より多くの異なる入力が必要です。

フォームにデータを投入する方法はいくつかあります。

• 関連するフォームに SOAtest が出会うたびに使用される固定値を入力します (これを「固定入力」と呼びます)。
• コードで指定されているようにデフォルトの入力を使用するよう SOAtest を設定します (これを「デフォルト入力」と呼びます)。
• フォームが出現するページから値を抽出するよう SOAtest を設定します。たとえば、正しいフォーム値が JavaScript で動的に設定される場合です (これを「抽出入力」と呼びます)。
• 入力を完全に無効にします。
• カスタム メソッドの返却値を使用するよう SOAtest を設定します (これを「スクリプト入力」と呼びます)。

フォーム入力パネルでの設定

表示されたフォーム入力パネルで固定値を追加または変更するには、次の操作を行います。

1. (オプション) [フォーム テスト名] フィールドで入力ラベル名を変更します。
2. (オプション) [フォーム アクション] フィールドでフォーム アクションを変更します。
   • コードで指定されているように、デフォルトのフォーム アクションを使用する場合、[デフォルト] オプションを選択します。なお、デフォルト値が変わる場合、SOAtest はフォーム アクションを自動的に更新します。ユーザーがフォーム テストを自動的に更新する必要はありません。
   • 固定値を指定する場合、[固定] オプションを選択し、テキスト フィールドで目的のフォーム アクションを指定します。
3. フォーム入力コントロールを使って、各フォーム入力要素に対して入力を追加または変更します。
   • コードで指定されているように、デフォルト入力を使用する場合、[デフォルト] オプションを選択します。なお、デフォルト値が変わる場合、SOAtest はフォーム アクションを自動的に更新します。ユーザーがフォーム テストを自動的に更新する必要はありません。
   • 固定値を指定する場合、[固定] オプションを選択し、テキスト フィールドで目的のフォーム アクションを指定します。
     • チェックボックス、ラジオボタン、および選択入力には [ユーザー定義] オプションがあります。このオプションを使用すると、この入力のための値として送られる単純な文字列を指定できます。
     • ラジオボタンおよび選択入力には、[Index] オプションもあります。このオプションを使用すると、ラジオボタンまたは選択入力クリックのインデックスを指定できます。インデックスを選択すると、オプションがどのように変わるかに関係なく、そのラジオボタンまたはオプションの値が送られます。 このインデックスは 0 を基底とします。たとえば、常に 2 番目のオプションを選択したい場合、[Index] オプションで「1」を選択します。ラジオボタンの場合、そのインデックスでのラジオボタンの現行値がインデックスごとに表示されます。選択入力の場合、オプションの現在の表示値が各インデックスと共に表示されます。
     • 選択入力は、サーバーに送られる値ではなく、選択に対する表示値を格納します。したがって、サブミット値が変わるときにユーザーがテストを変更する必要はありません。
   • フォームが出現するページから値を抽出するよう SOAtest を設定する場合 (たとえば、正しいフォーム値が JavaScript で動的に設定される場合)、[Extracted] を選択します。[Left-hand text] フィールドには、抽出する値の左側に常に出現するテキスト文字列を入力します。[Right-hand text] フィールドには、抽出する値の右側に常に出現するテキスト文字列を入力します。たとえば、テキスト pre123post から値 123 を抽出するには、[Left-hand text] に「pre」と入力し、[Right-hand text] に「post」と入力します。
   • 有効化された入力を無効化するには、[無効] を選択します。無効化された入力を有効化するには、[有効] を選択します。
   • カスタム メソッドの戻り値を使用する場合、[スクリプト] を選択します。[スクリプトの編集] ボタンをクリックしてメソッドを作成または編集し、目的のメソッドを [メソッド] ドロップダウン メニューから選択します。複数のメソッドがある場合、フォーム パネルのドロップダウン メニューから別のメソッドを選択することもできます。
4. (フォームに OnSubmit ハンドラーがある場合) テスト中に OnSubmit ハンドラーを使用するかどうかによって、[フォーム送信時に OnSubmit ハンドラーを処理] を有効または無効にします。
   • フォームに OnSubmit ハンドラーがある場合、ブラウザーでパスを記録している最中にフォームが作成されたのでない限り、このオプションはデフォルトで true に設定されています。ブラウザーでパスを記録している最中にフォームが作成された場合、このオプションは false に設定されます。なぜなら、ブラウザーからパスを記録するとき、SOAtest は OnSubmit ハンドラーを処理する必要がないようにフォーム テストをセットアップするからです (実際、この場合に OnSubmit ハンドラーを処理するならば、パスの実行中に問題が発生する可能性があります)。
5. (オプション) デフォルトのフォーム サブミッション方法を変更します。
   • 単純な JavaScript サブミッションを模倣するか、Enter キーを押してユーザーがフォームをサブミットする状況を模倣するには、[暗黙のサブミット] オプションを選択します。
   • ユーザーがサブミット ボタンをクリックしてフォームをサブミットする状況を模倣するには、そのサブミット ボタンを表すオプション (たとえば Image: "Anonymous") を選択します。あるいはフォーム入力パネル中にサブミット画像がある場合、サブミット画像の特定の部分をクリックします。

ロード中の認証管理

認証が必要なページに SOAtest が到達した場合、パスワード ダイアログが表示されます。有効なユーザー名とパスワードを入力できます。

有効なユーザー名とパスワードを入力し、プロジェクト ファイルにパスワードを保存するかどうかを指定して [OK] をクリックします。

ロードとサイト スキャンの FAQ

スクリプト フックによるスキャンのカスタマイズ

SOAtest のスキャン動作をカスタマイズできます。それには、SOAtest を設定して、「フック」に関連付けられたイベントが SOAtest プログラム内で発生したときにカスタム スクリプトを実行するようにします。

フックとは

カスタマイズしたフックを使って、スキャニング ツールの特定の実行ポイントで渡される値を記録したり変更したりすることができます (たとえば、警告ダイアログが開いたときにユーザーは応答を求められたりパスワード入力を求められたりします)。

たとえば、SOAtest のフックのひとつに Alert フックがあります。Alert フックは、SOAtest のスキャニング ツールが JavaScript の alert に遭遇するたびに呼び出されます。SOAtest でこの警告情報を記録して SOAtest Message ウィンドウにレポートしたい場合、Alert フックを定義したスクリプトを作成し、Alert フックに遭遇したときの SOAtest の振る舞いを記述します。このスクリプトが呼び出された後、SOAtest はこのスクリプトにアクセスし、指定された JavaScript の alert に遭遇するたびに、指定されたアクション、つまり警告情報の記録とレポートを実行します。

フックは、カスタム メソッドを使用したスクリプトで定義してカスタマイズします。同じファイル内に複数のフックを定義できます。1 つのフックに 2 つ以上のメソッドを追加した場合、フックを呼び出すと、そのフックで定義されたすべてのメソッドが実行されます。

SOAtest で他のスクリプトを作成、適応、呼び出すときと同じ方法で、フックを定義するスクリプトを作成、適応、呼び出すことができます。起動時 (JavaScript および Jython スクリプトだけ)、Extension Tool を作成し適用することによって、および指定のパス ノードにスクリプトを追加することによって、作成、適応、呼び出しが可能です。ユーザーは、目的の機能を使用するために、その時々にフックを呼び出すことができます。たとえば、SOAtest のすべてのプロジェクトとサイトでスクリプトのフック機能を使用したい場合、そのフックを定義して使用する JavaScript または Jython のスクリプトを <INSTALL>/plugins/com.parasoft.ptest.libs.web_<VERSION>/root/startup ディレクトリに追加します。すると、プログラムがフックを呼び出すときに、関連付けられたユーザー定義メソッドが実行されます。プログラムがフックを呼び出すたびに、関連するユーザー定義メソッドが実行されます。メソッドは、フックで clear () を呼び出すまで実行されます。

一般的なフック オプションの完全な説明については、SOAtest Extensibility API を参照してください。それには、[Parasoft] メニューの [ヘルプ] をクリックし、 [Parasoft SOAtest Extensibility API] ブックを探します。

利用できるフック

SOAtest では、以下のフックをスクリプトで定義して操作できます。

• Alert
• Confirm と Prompt
• Realm Password
• URL Logging

Alert

JavaScript の alert() メソッドに遭遇したとき、デフォルトでは SOAtest は [OK] ボタンをクリックして SOAtest のコンソール ビューに JavaScript Alert: "message" を出力します。Alert フックを使用すると、このデフォルト動作を変更できます。

デフォルトでは、Alert フックは SOAtest が JavaScript の alert に遭遇するたびに呼び出されます。Alert フックにメソッドを追加することで、JavaScript の alert に遭遇したときに SOAtest がどのように振る舞うかを決定します。Alert フックが呼び出されると、SOAtest はスクリプト中で指定された場所に JavaScript Alert: "message" メッセージを出力します (場所が指定されていない場合は SOAtest コンソール ビューに出力します)。

Alert フックは一般的に、 alert メッセージの結果を特別な SOAtest メッセージ ウィンドウに出力するために使用されます。たとえば、"Alert Messages" という SOAtest メッセージ ウィンドウにすべての alert メッセージをレポートしたい場合、次の Jython スクリプトを作成して <INSTALL>/plugins/com.parasoft.ptest.libs.web_<VERSION>/root/startup ディレクトリに追加できます。

from com.parasoft.api import Application
def myAlertHook(msg):
   # Print the alert message to SOAtest Messages
   Application.showMessage("    JavaScript Alert: %s" % str(msg))    
   # Add the contents of the alert message to a Result Window named
   # "Alert Messages".  This ResultWindow can later be used
   # as part of a test suite in a regression test, to make sure the 
   # contents of the window, which contains the alert message,
   # are what you expect them to be.
   Application.report("Alert Messages", str(msg))
# Add your method to the Alert Hook Application.getHook("Alert").set(myAlertHook)

myAlertHook メソッドに渡される引数は alert メッセージです。これは、alert が持つメッセージ文字列です。

また、Alert フックを使用すると、不正なフォーム値をユーザー (または SOAtest) がサブミットしたときに、不正なデータの入力を警告する警告ダイアログをアプリケーションが表示することを検証できます。このテストを実装するには、SOAtest メッセージ ウィンドウに警告メッセージを記録する (上記のような) スクリプトを作成して呼び出します。次に、次のテスト ケースを使って SOAtest メッセージ ウィンドウの内容をチェックするテスト スイートを実装します。

1. SOAtest メッセージ ウィンドウをクリアする Extension Tool 。
2. 警告メッセージを引き起こすクリック パスを実行する Test Path ツール。
3. メッセージ ウィンドウのテキストを返す以下のようなスクリプトを持った Extension Tool 。正しい警告メッセージがメッセージ ウィンドウに表示されることを検証する回帰コントロールがアタッチされている。

#Script to return text of result window named "Alert Messages" from soaptest.api import *
def return(): 
    return SOAPUtil.getResultWindowText("Alert Messages")
#Script to clear text of result window named "Alert Messages" from soaptest.api import *
def clear(): 
    SOAPUtil.clearResultWindow("Alert Messages")

Confirm と Prompt

JavaScript の confirm() メソッドに遭遇したとき、デフォルトでは SOAtest は [キャンセル] ボタンをクリックし、false を返し、SOAtest コンソール ビューに JavaScript Confirm: "message" を出力します。JavaScript の prompt() メソッドに遭遇したときは、[キャンセル] ボタンをクリックし、null を返し、SOAtest コンソール ビューに JavaScript Prompt: "message" を出力します。Confirm フックまたは Prompt フックをスクリプトで定義してカスタマイズすることで、このデフォルト動作を変更できます (使用されるフックは、戻り値を変更したい JavaScript メソッドによって決まります)。

Confirm

Confirm フックをカスタマイズすることで、confirm() メソッドに遭遇したときに SOAtest がどのように振る舞うかを決定します。

たとえば、confirm() メソッドに遭遇するたびに、カスタマイズされた (デフォルトではない) レスポンスを SOAtest が返すようにする方法のひとつは、以下のステップを実行することです。

まず、startup.py という Jython ファイルを作成し、1 個の引数を取る 1 個のメソッドを定義します。この引数は、JavaScript の confirm() メソッドがこの引数に渡すのと同じ値を持ちます。 必要なロジックに基づいて、confirm() が true を返すのか false を返すのかを決定し、定義したメソッドからその値を返します。定義したメソッドを SOAtest が使用するようにするには、以下の方法で Confirm フックにメソッドを追加します。ここで、 set に渡す引数は定義したメソッドの名前です。この例では、定義したメソッドの名前を myConfirmHook とします。

from com.parasoft.api import Application
# msg will have the same value that gets passed to confirm() def myConfirmHook(msg):
    if msg == "Yes or no?":
        return 1
    return 0
Application.getHook("Confirm").set(myConfirmHook)

次に、このファイルを <INSTALL>/plugins/com.parasoft.ptest.libs.web_<VERSION>/root/startup ディレクトリに追加します。次回 SOAtest を起動したとき、confirm() メソッドに遭遇するたびに上記のスクリプトが実行されます。

Confirm フックが呼び出されると、確認アクションに従って、SOAtest はスクリプトで指定された場所に次のいずれかのメッセージを出力します (場所が指定されていない場合は SOAtest コンソール ビューに出力します)。

• Based on the script, SOAtest clicked the "OK" button
• Based on the script, SOAtest clicked the "CANCEL" button

Prompt

Prompt フックをカスタマイズすることで、prompt() メソッドに遭遇したときに SOAtest がどのように振る舞うかを決定します。

Prompt フックの動作は Confirm フックに非常に似ています。ひとつの違いは、Prompt フックは 2 個の引数を取り、この引数を JavaScript の prompt() メソッドに渡すことです。もうひとつの違いは Confirm フックに定義するメソッドは論理値を返しますが、 Prompt フックに定義するメソッドは文字列または "null" (Jython では "None") を返さなければならないことです。

prompt() メソッドに渡される引数に基づいて返却値を決定するロジックを定義できます。"null" を返すことは、prompt() メソッドが呼び出されたときにブラウザーが開くダイアログで [キャンセル] をクリックすることに相当します。confirm() のためのカスタム メソッドを追加したときと同じように、Prompt フックにメソッドを追加します。以下は、prompt() の値として "http://www.parasoft.com" を返すスクリプトの例です。

from com.parasoft.api import Application
def myPromptHook(msg, defaultMsg):
    return "http://www.parasoft.com"
Application.getHook("Prompt").set(myPromptHook)

Prompt フックが呼び出されると、prompt の応答に従って、SOAtest はスクリプトで指定された場所に次のいずれかのメッセージを出力します (場所が指定されていない場合は SOAtest コンソール ビューに出力します)。

• Based on the script, SOAtest entered "[message- string that the script returns]"
• Based on the script, SOAtest clicked the "CANCEL" button

異なる状況で異なる値を返却

Confirm フックまたは Prompt フックのために定義するメソッドに適切なロジックを追加することで、異なる状況で異なる confirm() または prompt() の値を SOAtest が返すようにできます。 Confirm または Prompt フックに追加しているメソッドへの第一引数のテキストを使って、どの値を返すかを決定します。たとえば、"Enter a URL" という問い合わせ (prompt) には http://www.parasoft.com を返したいが、 "Enter your name" という問い合わせには John を返したいものとします。この機能は以下のように実装できます。

def myPromptHook(msg, defaultMsg):
  if msg == "Enter a URL":
    return "http://www.parasoft.com"
elif msg == "Enter your name":
  return "John"
else:
  return None

Realm Password

Realm Password フックは、以下のすべての条件が満たされたときに呼び出されます。

• SOAtest がサーバーにリクエストを送信する。
• サーバーがチャレンジで応答し、レルム パスワードまたは NTLM パスワードを求める (SOAtest はどちらも同じように処理します)。
• ユーザーがまだレルム パスワードも NTLM パスワードも入力していない。

これらの条件を満たす前にカスタムの Realm Password フックを定義した場合、SOAtest は、手動でのパスワード入力をユーザーに求める前にカスタム フック メソッドを実行します。このメソッドが (プロジェクト中のサイト、または負荷テスト仮想ユーザーに) パスワードを追加する場合、SOAtest はそのパスワードを使用し、ユーザーにパスワードの入力を求めません。以前にパスワードが入力されている場合、このフックは実行されません。フックに対して定義したパスワードを必ず SOAtest が使用するようにしたい場合、フックから新しいパスワードを SOAtest に追加させる前に、サイト パスワードを消去するべきです。

特定のコンテキストによってユーザー名とパスワードを変化させたい場合にこのフックは特に役立ちます (たとえば使用している特定のパスに基づいて、あるいは仮想ユーザーの負荷テストのコンテキストでは異なるユーザー名とパスワードを使用したい、など)。

以下の Java のサンプル ファイルは、Realm Password フックのとても基本的な例です。このスクリプトは、コンテキストに関係なく同じパスワードを追加します。

import com.parasoft.api.*;
import java.lang.reflect.*;
import java.net.*;
import soaptest.api.*;
public class RealmPasswordHook {
    static public void returnPassword(String realm, String url, boolean ntlm, Context context)
throws MalformedURLException {
         SOAPUtil.addSitePassword(realm, "user1", "password1", url, ntlm);
    }
    public void setHook() throws UserMethodException, NoSuchMethodException
{
        Hook hook = Application.getHook("RealmPassword");
        Method userMethod = getClass().getMethod("returnPassword", new Class[] {String.class,
String.class, boolean.class, Context.class});
        hook.set(userMethod);
    }
}

以下の Jython のサンプル ファイルは、前の Java ファイルに似ています。ただし、この Jython スクリプトは Realm Password フックにアクセスするときに既存のすべてのパスワードを消去します。

from com.parasoft.api import *
from soaptest.api import *
def returnPassword(realm, url, ntlm, context):
  SOAPUtil.addSitePassword(realm, "user1", "password1", url, ntlm)
def setHook():
  hook = Application.getHook("RealmPassword")
  hook.set(returnPassword)
  // Remove all previous passwords to the new one being added above is the one that gets used.
  SOAPUtil.removeSitePasswords()

以下の JavaScript のサンプル ファイルは、フックがアクセスされたときに (仮想ユーザーの負荷テストが実行されるときに)、既存のレルム パスワードを削除し、現在アクセスされている URL に基づいてパスワードをサブミットします。

// This method uses a different password based on the URL.
var Application = Packages.com.parasoft.api.Application
function returnPassword(realm, url, ntlm, context) {
  Packages.soaptest.api.SOAPUtil.removeSitePasswords()
  // Adds password to a virtual user in load test
   if (url.indexOf("http://toad.parasoft.com:90" == 0) {
     Packages.soaptest.api.SOAPUtil.addSessionPassword(realm, "user1", "password1", url, ntlm, context)
  } else {
     Packages.soaptest.api.SOAPUtil.addSessionPassword(realm, "user2", "password2", url, ntlm, context)
  }
}
function setHook() {
  var hook = Application.getHook("RealmPassword")
  hook.set(returnPassword)
  Packages.soaptest.api.SOAPUtil.removeSitePasswords()
}

URL Logging

URL Logging フックは、SOAtest が URL を訪問するたびに呼び出されます。このフックを使って、 SOAtest がアクセスした各 URL を出力することができます。

URL Logging フックにアタッチするメソッドは、3 個または 4 個の引数を持つ必要があります。 第一引数は、訪問した URL を指定する文字列にします。第二引数は、URL を使ってサブミットされる POST データにします (これは NULL の可能性があります)。第三引数は java.util.Hashtable であり、リクエストで送られた他の HTTP プロパティを持ちます (たとえば referer)。第四引数はオプションであり、メソッドのシグニチャに追加する場合、com.parasoft.api.Context です。

さらに、SiteUtil.enableLogging を true に設定し、UrlLogging を Application.getHook() に渡す必要があります。

たとえば、SOAtest が訪問した各 URL をコンソール ビューに出力したい場合、以下の Jython スクリプトを作成して <INSTALL>/plugins/com.parasoft.ptest.libs.web_<VERSION>/root/startup ディレクトリに追加できます。

from com.parasoft.api import *
from webtool.site import SiteUtil

count = 1

def setHook():
    SiteUtil.enableLogging = 1
    hook = Application.getHook("UrlLogging")
    hook.set(loggingHook)
def loggingHook(url, post, props):
    global count
    if post:
        Application.showMessage(str(count) + ". " + url + " [POST=" + post + "]")
    else:
        Application.showMessage(str(count) + ". " + url)
   count = count + 1
setHook()