このセクションでは、[Parasoft] > [設定] からアクセスできる SOAtest と Virtualize の設定について説明します。
作成者の設定画面では、品質タスクの生成時にどのようにコード作成者をユーザー名および電子メール アドレスにマッピングするかを指定できます。詳細については、「"作成者と作成者" および "作成者と E-mail" のマッピングの指定」を参照してください。
[ブラウザー] パネルでは Web シナリオの記録に関連するオプションを設定できます。次の設定を利用できます。
Firefox の実行モジュールのパス: Firefox の実行可能ファイルへのパスを指定します。Windows マシン上では、SOAtest/Virtualize は Firefox のインストールを自動的に検出しようと試みます。Linux ユーザーの場合は Firefox の実行モジュールをブラウズする必要があります。
ブラウザーのタイムアウトの設定: SOAtest が、ブラウザーの起動またはユーザー操作の待機を終了し、「タイムアウト」とみなすまでの遅延の長さをミリ秒で指定します。
待ち時間のタイムアウトの設定: SOAtest が、待ち条件に指定された操作が発生するのを待機することを終了し、「タイムアウト」とみなすまでの遅延の長さをミリ秒で指定します。
デバッグ オプション > デバッグ情報を出力: Web シナリオの記録中、 SOAtest に操作を記録させないようにすることが可能です。このオプションを有効にすると、記録中にメッセージ コンソールにメッセージが表示されます。メッセージの内容は、どのイベントを SOAtest/Virtualize が扱っているか、生成されていたかもしれないロケーター、そして可能な場合は、記録中に発生した例外処理などです。
エラー レポート > ウェブサイトのスクリプト エラーのレポート: シナリオ実行中に発生したスクリプト エラーをレポートするよう指定します。Internet Explorer では、Selenium WebDriver フレームワークは、ページで発生した JavaScript エラーを SOAtestにレポートしません。このレポート オプションは、レガシー エンジンでだけサポートされています。
Browser Contents Viewer レンダリング エンジン: Browser Contents Viewer ツールで使用するブラウザーを指定できます(Browser Contents Viewer で説明)。 Browser Contents Viewer ツールは Browser Playback ツールに連結できます。
Internet Explorer を選択した場合、使用される IE のバージョンは SOAtest/Virtualize を実行しているマシンにインストールされた IE のバージョンに依存します。Internet Explorer のオプションは Windows 上でのみ利用可能です。
Firefox を選択した場合、 Firefox のバージョンは SOAtest を実行するのに使用されている Eclipse に依存します。使用している OS によって、 Firefox 3.0.1 から Firefox 10 までさまざまです。
HTML コンテンツ取得モード: 非表示のフレームのコンテンツをアクション前やアクション後の HTML ビューアーで表示するかどうかを決定できます。この設定は、記録や再生のスピード、ファイル サイズに影響を与えます。1 つのモードをチームの SOAtest マシン (例: デスクトップ インストール) で使用し、異なるモードを別のマシン (例: コマンドライン モードで実行しているサーバー マシン) で使用することができます。
すべての HTML コンテンツを取得: アクション前やアクション後の HTML ビューアー (Browser Playback tool、Browser Contents Viewer、Browser Data Bank、Browser Validation tool) で非表示のフレームのコンテンツを表示したい場合に、このオプションを選択します。この設定は、非表示の iframe で検証/抽出を作成したい場合に適しています。このモードは、記録や再生の速度を著しく落とします。さらに、アプリケーションで非表示の iframe を使用している場合、 .tst ファイルのサイズを著しく増やします。
非表示のフレームを除くすべてのコンテンツを取得: アクション前やアクション後の HTML ビューアー(Browser Playback tool、Browser Contents Viewer、Browser Data Bank、Browser Validation tool) で非表示のフレームのコンテンツを表示したい場合に、このオプションを選択します。このモードでも、ブラウザーはサーバーからすべてのフレームを取得し、非表示の iframe 上で検証と抽出を実行できます。しかし、アクション前やアクション後の HTML ビューアーで非表示のフレームのコンテンツは表示しません。
SOAtest を使用してブラウザーで Web シナリオの記録や実行をするとき、使用するブラウザーのプロキシ設定は、 SOAtest が管理する内部プロキシに設定されます。記録中や再生中のブラウザー間通信はすべて、この SOAtest プロキシを通ります。このプロキシはトラフィックをキャプチャするためか、もしくは実行を容易にするために使用される媒体です。記録中や再生中、 SOAtest は Browser Playback 設定の [プロキシ ポート] オプションで指定したポートを使用して、このプロキシを localhost 上に一時的に作成します。
内部プロキシのデフォルトのホストとポートは localhost:55555 です。マシンがこのポートをすでに使用している場合、 [プロキシ ポート] フィールド でポート番号を変更してください。ブラウザーからは変更しないでください。
独自のプロキシをマシンに設定した場合、 SOAtest/Virtualize がそのプロキシを利用するよう設定する必要があります。その後、 SOAtest/Virtualize は内部プロキシがすべてのトラフィックを指定のプロキシへ転送するよう構成します。この設定は、「Proxy Settings」で構成します。
SOAtest/Virtualize は、ブラウザーのインスタンスを起動する前にグローバル レジストリの設定を変更します。SOAtest/Virtualize を起動する前に Internet Explorer のインスタンスが実行中だった場合 (推奨しません)、既存のブラウザー インスタンスではグローバル レジストリ設定が実施されません。
その場合、 Web シナリオの実行中に既存のブラウザー インスタンスの [インターネット オプション] パネルをチェックし、設定が SOAtest/Virtualize のプロキシを指していることを確認して [OK] をクリックします。[OK] をクリックした場合、既存のブラウザー インスタンスのプロキシ設定が更新されます。[キャンセル] をクリックした場合、または [インターネット オプション] パネルを開かなかった場合、既存のブラウザー インスタンスは SOAtest/Virtualize のプロキシ設定を取得しません。操作は問題なく継続するはずです。
ブラウザー プロセスのハングなど、ブラウザーが正しく終了しなかった場合、プロキシ設定が正しくリセットされないことがあります。このような問題は、新しいブラウザー インスタンスや、インターネットに接続する他のプログラムに影響する可能性があります。この問題が発生した場合は、マシンのプロキシ設定を適切な値に再設定するか、ハングしているブラウザー プロセスを強制終了することで解決できます。
[コンソール] パネルでは、[コンソール] ビューにレポートされる情報の量と、メッセージを含む場合に自動的にアクティベートするかどうかを決定できます。
CTP および有効なライセンスがある場合、CTP への接続を設定できます。
グローバル データソースは 単一の SOAtest プロジェクトの外部で再利用および共有できます。 [グローバル データ ソース] パネルでは、グローバル データ ソースについての情報をどのように保存するかを決定できます。グローバル データソースを構成する方法については、次を参照してください テスト スイート、プロジェクト、またはグローバル レベルでのデータ ソースの追加
問題が発生している場合は、テクニカル サポート インターフェイスを使用して、関連ファイルを含む zip アーカイブを作成できます。zip ファイルを Parasoft テクニカル サポートに送信します。SOAtest では、問題が発生したときに自動的にアーカイブを作成できます。アーカイブは約 0.5 MB で、作成時間は 1 分程度です。
デフォルトでは、問題発生時にアーカイブは作成されません。手動でアーカイブを用意して任意のタイミングでサポートへ送るか、問題発生時に製品が自動的にアーカイブを用意して送信するように Parasoft のアーカイブ作成オプションを変更します。
問題発生時に製品が自動的にアーカイブを用意して送信するように構成するには、次の操作を行います。
サポート アーカイブを手動で作成するには、次の操作を行います。
最新のサポート アーカイブの確認や、 E-mail 送信、削除ができるテクニカル サポート アーカイブ マネージャーを開くには、次の操作を行います。
コマンドラインから SOAtest を起動するときに、次のシステム prpを追加することで、デバッグ ログを有効にし、サポートアーカイブの作成時にすべての関連情報が含まれるようにできます。
| プロパティ | 説明 | |
|---|---|---|
parasoft.logging.config.jar.file | ログ設定を含む、SOAtest に付属の事前構成済み JAR ファイルを指定しますこれは、ログを有効にするために使用を推奨するプロパティです。 例:
| |
parasoft.logging.config.file | ディスク上の log4j 構成ファイルを指定します。独自の log4j 構成ファイルがあり、サーバー デプロイメントの構成など、 例:
|
[ディクショナリ] パネルは、Spell Tool がスペルを間違った単語の識別に使用するディクショナリをカスタマイズできます。
ディクショナリに単語を追加するには、次の操作を行います。
スペルが間違っている単語がレポートされた場合、それを [品質タスク] ビューからディクショナリへ追加できます。レポートされたスペルが間違っている単語を右クリックし、 [ディクショナリに追加] をクリックします。
|
ispell 形式のディクショナリのセット (英語以外の言語のディクショナリや業界固有の用語のディクショナリなど) を追加することで、 SOAtest のビルトイン ディクショナリを拡張できます。各ディクショナリ セットは、1 つの名前と 1 つ以上のディクショナリを持ちます。
追加のディクショナリ セットを登録するには、次の操作を行います。
デフォルトでは、 SOAtest は非テキスト文字を空白として扱います。空白文字を含む単語はディクショナリに登録できません。指定の非テキスト文字を、1 つの空白としてではなく、単語の中の有効な文字として SOAtest に認識させるには、その文字を「許可される非テキスト文字」の一覧に追加する必要があります。そうすることで、「許可される非テキスト文字」を含む単語のスペル間違いを識別したり、許可される非テキスト文字を含む単語をディクショナリに追加したりすることが可能になります。
非テキスト文字を許可される非テキスト文字のリストに追加するには、次の操作を行います。
[MIME タイプ] パネルでは、 MIME タイプの追加や削除ができます。さらに、ユーザー好みのテキスト/XML エディターの場所を指定し、特定の MIME タイプを持つファイルの編集に使用するエディターを指定できます。
MIME タイプの追加、編集、削除は次の操作を行います。
[その他] パネルでは、次のような設定が可能です。
自動整形: メッセージが指定のサイズ以下 (デフォルトの設定は 10KB) の場合、選択したツールまたはツール (Traffic Viewer、 Diff、 Editor) の XML メッセージを自動的に整形するように SOAtest に通知します。
設定の保存: プロジェクト ファイルを保存するのに使用するファイル形式を指定します (例: .tst、 .changetemplate)。「利用可能なプロジェクトファイル形式とは」を参照。
[プロキシ] パネルは、SOAtest/Virtualize がプロキシ サーバーと連携する方法を管理します。Web シナリオに使用される独立した仲介プロキシは制御しません (他のプロキシに関する詳細については、 「Proxy Configuration Details」を参照してください)。
そうでない場合は、[プロキシの有効化] をオンにし、正しい設定を手動で入力してください。これらの設定は、 SOAtest/Virtualize の外のブラウザーで使用するものと同じであるべきです。
リモート SOAtest/Virtualize サーバーの管理に使用できるのは認証を要求しない HTTP プロキシであることに注意してください。認証を要求する HTTP プロキシは、サーバー ツリーにリモート SOAtest/Virtualize サーバーを追加する際には適用されません。
[スキャニング] パネルは、SOAtest が Web アプリケーションをスキャンする方法に関連する設定を指定します。以下のオプションがあります。
[スクリプト] パネルはカスタム スクリプトに使用される設定を指定できます。
Java: Java の場合、Java の home ディレクトリおよび javac コンパイラへのパスを指定できます。SOAtest のエディターの中で Java メソッドをコンパイルしたい場合、これらのパラメーターを指定する必要があります。
javac コンパイラは SOAtest のインストールに含まれていません。 |
Jython: Jython の場合、jython.home および jython.path 変数を指定できます。どちらの変数も Jython モジュールを設置するために使用されます。Jython モジュールをインポートしない Jython コードは、どちらの変数も設定せずに Jython スクリプトのサポートを使用できます。jython.home と jython.path 変数を設定した場合、SOAtest/Virtualize を再起動して変更を反映させます。
タイムアウト設定: SOAtest/Virtualize が応答しないスクリプトを停止してエラー メッセージをログに記録するまでの時間を指定します。単位は分です。
プロジェクトで使用する、 クライアント のデフォルトのセキュリティ設定を構成できます。ほとんどの場合、セキュリティ設定は、スイートでローカルに設定された構成によって上書きできます:
適用可能なツールに HTTP プロトコルを構成するときに使用できる、グローバルな HTTP 認証を設定します。
Kerberos 認証は、信頼できるサード パーティ製の認証メカニズムとして知られています。クライアントのリクエストは直接サービスにアクセスしないで、ネットワークにまたがる認証を管理する Key Distribution Center からアクセスします。このメカニズムは、シングル サインオン (SSO) を推進するので、クライアントは許可証明書を一定時間 (通常は 8-10 時間) に 1 回提供するだけです。認証はチケットの形式で付与されます。チケットはキャッシュに保存され、付与された期間は再認証の必要なく、再利用できます。
Kerberos に保護されたネットワークのクライアントやサーバーといったエンティティは、プリンシパルと呼ばれます。Kerberos が保護するネットワーク空間はレルムと呼ばれます。Microsoft の IIS (Internet Information Services) サービスは、ネゴシエーション プロトコルを通して、 Kerberos を使用した HTTP ベースのサービスを提供します。その他のサーバー ベンダーは、Microsoft のネゴシエーション プロトコルの独自の実装を提供します。
初期認証で取得したチケットは、Ticket Granting Ticket または TGT と呼ばれます。たとえば Windows 環境では、朝、ワークステーションに最初にログインしたときに TGT が生成されます。SOAtest/Virtualize はシステムのキャッシュからユーザーの TGT を取得することで自身を認証し、 Kerberos に保護されたサービスを使用します。
一般的な Kerberos エラーの解決方法についてのヒントは http://docs.oracle.com/javase/8/docs/technotes/guides/security/jgss/tutorials/Troubleshooting.html を参照してください。 |
設定が完了すると、ツール起動時に必要なネゴシエート トークンが自動的に生成され、 HTTP ヘッダーとして送信されます。Kerberos はいわゆる「再生」攻撃を防ぐメカニズムを提供します。再生攻撃とは、ユーザーがサービスへのアクセスを得るために、キャプチャして重複する証明書を提供することです。 負荷テストの実行で複数の仮想ユーザーが同じユーザー証明書を提示するとき、 KDC は再生攻撃が発生しているとして反応し、エラーをスローします。これは予期される動作であり、回避策があるかどうかは現時点では不明です。
あらゆる証明書を受け入れるには、[すべての証明書を信頼する] オプションを有効にします。この設定は、「信頼されていない」証明書を持つページを読み込む場合に役立ちます。
信頼できる Java 証明書ベンダーの証明書だけを許可するには、[デフォルトの Java 証明書ファイルを使用] オプションを有効にします。
クライアント キーストア オプションを通して、サーバー側とクライアント側両方の SSL 証明書の設定を指定するには、[クライアント キーストアの使用] オプションを有効にします。
XML Signature Verifier、 XML Signer、または XML Encryption といったツールを使用する操作を実行するために、 Unlimited Strength Java Cryptography Extension をダウンロードしインストールする必要があります。詳細については「JCE Prerequisite」を参照してください。 |
キーストアはテスト スイートで指定します。このオプションを選択する場合、[証明書] タブと [秘密鍵] タブで次のオプションを設定できます。
MQ SSL を介してテスト対象アプリケーションとやり取りするクライアントのトラストストア、キーストア、およびキーストア パスワードを指定できます。これらの設定は Virtualize には適用されません。
SOAtest と Virtualize には、Unlimited Strength Java Cryptography Extension を含む独自の Java インスタンスが付属しているため、 XML Signature Verifier、XML Signer、XML Encryption ツール、およびキーストアを使用するセキュリティ操作を実行できます。更新サイトからSOAtestまたはVirtualizeをインストールしていて（Eclipse p2 更新サイトからのインストール を参照）Java のインスタンスを使用している場合、無制限の JCE がまだシステムにインストールされていなければ、無制限の JCE をダウンロードしてインストールする必要があります。ダウンロードとドキュメントについては、Oracle の Web サイトを参照してください。MacOS ユーザーは、無制限の JCE を取得するために、update 161 よりも新しい Java 8 をインストールする必要があります。
[サーバー] パネルでは次の設定を SOAtest サーバーに設定できます。 この設定は、Call Back Tool や 非同期テスト、エンド ツー エンド テスト シナリオに統合した Message Stub ツールでの作業を可能にします。
サーバーの起動: SOAtest/Virtualize 起動時にサーバーを自動的に起動するかどうかを決定します。
[SOAP] パネルでは次の設定が可能です。
添付ファイルのカプセル化フォーマット: デフォルトの添付ファイルのカプセル化フォーマットに、MIME、 DIME、または MTOM を指定できます。詳細については、「添付ファイルの処理」 を参照してください。
SOAtest が 送信する SOAP オブジェクトをシリアライズする方法、および受信する SOAP メッセージをデシリアライズする方法も、カスタマイズできます。しかしこれらの設定は [設定] パネルからはできません。 SOAP メッセージは XML から何らかのネイティブ形式にデシリアライズされ、オブジェクトはレスポンスとして送信できるように XML フォーマットにシリアライズされます。 シリアライザー/デシリアライザーのペアを追加するには、register.py ファイルに 1 行追加します。 register.py ファイル は次のディレクトリにあります: Axis の場合、SOAtest がsoatest.api.SOAPUtil.getDefaultAxisRegistry() を呼び出して使用する TypeMappingRegistry を取得できます。レジストリを取得した後、必要に応じて Axis API を使用してシリアライザーを登録できます。 |
[システム プロパティ] パネルでは、必要に応じてクラスパスに JAR ファイル、クラス フォルダー、 Java プロジェクトを追加できます。利用可能なコントロールを使用して、JAR ファイル、クラス フォルダー、 Java プロジェクトの追加や削除を行います。指定された JAR ファイル、クラスパス、 Java プロジェクトはシステムのクラスパスに追加され、関連するクラスは SOAtest の再起動後に JVM に読み込まれます。
クラス パス エントリからクラスを強制的に再読み込みするには、[リロード] をクリックします。
SOAtest に、修正後や再コンパイル後に Eclipse プロジェクトからクラスのリロードを試みてほしい場合、 [自動的にクラスをリロード] オプションをオンにします。
多くの jar ファイルをすばやく追加したい場合、あるいは Parasoft ソリューションのヘッドレス インスタンスに jar を追加したい場合、単純にワークスペースの以下のディレクトリに Jar ファイルをコピーします。
ヘッドレス インスタンスでは、SOAtest/Virtualize を再起動せずに jar をリロードしたい場合、REST API から post /v<version>/preferences/systemProperties/reload を呼び出します。 |
[UDDI] パネルでは、UDDI 検索エンドポイントを設定できます。UDDI 検索エンドポイントとは、動的ルーター解決を実行するときに SOAtest に参照させたいエンドポイントです。ここで UDDI レジストリを指定する場合、 SOAP Client ツールは SOAP Client パラメーターで指定された UDDI serviceKey を使用するレジストリを問い合わせることによって、サービスを検索できます。ここで UDDI レジストリを指定しない場合、サーバー エンドポイントがルーターの値としてハード コーディングされるように SOAP Client ツールを設定する必要があります。
[WSDL 履歴] パネルでは、ツールやプロジェクトで使用された WSDL の参照や修正ができます。これらの WSDL は、ツールでドロップダウン ボックスから選択できます。そのため、同じ WSDL を複数回指定する必要がある場合に入力の手間を省くことができます。
SOAtest/Virtualize でテストの WSDL URI を保存したくない場合は、[メッセージ レスポンダー、 SOAP クライアント、 および プロジェクトで使用された WSDL を保存] チェックボックスをオフにします。SOAtest だけを使用している場合、このオプションは [SOAP クライアントとプロジェクトで使用された WSDL を保存] を読み込みます。Virtualize だけを使用している場合、このオプションは [メッセージ レスポンダーとプロジェクトで使用した WSDL を保存] を読み込みます。
[WSDL URI] フィールドは、ツールの [WSDL URI] ドロップダウン リストで利用可能な WSDL URI をリストします。デフォルトでは、関連するツールで使用された全 WSDL URI がこのリストに追加されます。既定のロケーション URL から WSDL をリフレッシュし再解析したい場合は、 [WSDL のリフレッシュ] をクリックします。
[WSDL/スキーマの解析] オプションがオンの場合、 指定のターゲットの名前空間に所属するコンポーネントを特定するために、すべてのスキーマ ロケーションがチェックされます。このオプションをオフにすると、 指定のターゲットの名前空間のコンポーネントを解決するために、最初に検出されたスキーマ ロケーションだけが使用されます。
[XML 変換] パネルは固定長メッセージのデータ モデルを登録できます。
この設定を使用する方法については「Fixed Length Client と Fixed Length Call Back」を参照してください。
[XML スキーマ履歴] パネルでは、 Messaging Client (SOAtest)、メッセージ レスポンダー (Virtualize)、およびプロジェクトで使用された XML スキーマの参照や修正ができます。これらのスキーマはツールの関連するドロップダウン ボックスで選択できます。そのため、同じスキーマを複数回指定する必要がある場合に入力の手間を省くことができます。
[XML スキーマ ロケーション] パネルでは、スキーマ ロケーションの参照、追加、削除ができます。XML Validator ツールは、関連するドキュメントの検証に使用するスキーマを探す場所を知る必要があります。多くの場合、これは URI であり、検証されているドキュメントの中で提供されます。しかし、スキーマの URI が提供されなかった場合、または異なるロケーションを使用したい場合は、XML Validator ツールの [スキーマのロケーション URI として名前空間を使用] オプションをオフにしてください。XML Validator ツールの詳細については、「XML Validator」を参照してください。このチェックボックスをオフにしてツールを実行するとき、SOAtest は [XML スキーマ ロケーション] パネル で指定されたスキーマ ロケーションを使用します。 新しいスキーマ ロケーションを設定するには、次の操作を行います。
スキップする名前空間を指定するには、次の操作を行います。
OASIS XML カタログのロケーションを追加するには、次の操作を行います。
