このセクションでは、さまざまな環境を構成して使用する方法について説明します。このセクションの内容:
環境とは
環境は、 レスポンダーまたはアクション スイートのフィールドの中で参照できる変数のコレクションです。環境変数を使用して、エンドポイント、データベース テーブル名、ログイン資格情報などの接続プロパティ、その他を指定できます。変数の名前は、アクティブな環境で割り当てられた値に置き換えられます。“アクティブな”環境を切り替えることで、実行時に環境固有の値を動的に切り替えることができます。
環境は仮想アセット モードの切り替えにも使用できます。たとえば、外部システムのエンドポイントにトラフィックを転送するレスポンダーを構成したと仮定します。エンドポイントに固定値の代わりに環境変数を使用することによって、異なるエンドポイントにメッセージ転送を簡単にリダイレクトできます。これは、 .pva ファイルがプロキシのような働きをすることを可能にします。 1 つの環境は実アセットを指し、同時に別の環境は仮想アセットを指すことができます。
環境は、WSDL などの定義から Parasoft アセットを生成すると自動的に定義されますが、以下で説明するように手動で定義することもできます。
手動での環境定義
環境の作成と切り替えは、
レスポンダー スイートの Virtual アセット エクスプローラー ノードの [環境] ブランチで行います。
[環境] ブランチは、新規にレスポンダー スイートを作成したときに自動的に作成されます。
新しい環境を追加するには、以下の操作を行います:
- [環境] ノードを右クリックし、[新規環境] をクリックします。
- 環境の名前を変更し (オプション)、テーブル内のフィールドをクリックして、環境変数と値を定義します。
変数値のマスキング
変数を右クリックして [変数値のマスク] を選択すると、インターフェイスで値を非表示にできます。
テストとツールでの環境変数の使用
環境変数はツールのコンフィギュレーション フィールドで特別な構文を使用してアクセスできます。変数を参照するには、次の文字シーケンスで変数名を囲みます: ${env_name}
たとえば変数名が HOST の場合、変数名を参照するには、フィールドに${HOST}
と入力します。変数はフィールド内のどこからでも参照できます。環境変数の値には、Extension Tool/拡張 API を介したスクリプトからアクセスできます。ExtensionToolContext は環境変数の現在の値を返す getEnvironmentVariableValue(String) というメソッドを持っています。そのため、ユーザーは Virtualize スクリプト内で値を使用できます。
注意
${}
という文字列を使用する必要がある場合、バックスラッシュを付加することで文字列をエスケープできます。たとえば、\${HOST}
という文字列があった場合、${HOST}
という値が使用され、変数の解決は行われません。環境変数名では大文字/小文字が区別される点にも注意してください。GUI から環境を変更
アクティブな環境を変更するには、次の操作を行います。
- アクティブにする環境を表すノードを右クリックし、[アクティブな環境として設定] をクリックします。
環境のエクスポート、インポート、参照
サーバー名やポートなどの多くのコンフィギュレーション設定が、多くのプロジェクトで共通していることがわかったとします。これらの設定を何度も指定する代わりに、環境設定を外部ファイルにエクスポートし、ファイルをインポートしたり、他のプロジェクトの値を参照することができます。
環境のエクスポート
環境をエクスポートするには、以下の操作を行います:
- エクスポートする環境のノードを右クリックし、[環境のエクスポート] をクリックします。
- ファイル選択ダイアログが開いたら、環境のエクスポート先ファイルの場所を指定します。
環境設定は XML ベースのテキスト ファイルに書き込まれます。1 つの環境を選択した場合、1 つの環境を保存した *.env という拡張子のファイルが 1 つ作成されます。 複数の環境を選択した場合、選択されたすべての環境を保存した *.envs という拡張子のファイルが 1 つ作成されます。
環境のインポート
環境をインポートすると、環境の外部ファイルからプロジェクトに値がコピーされます。その後、XML ファイルを変更しても、変更はプロジェクトに反映されません。
環境をインポートするには、以下の操作を行います:
- [環境] ノードを右クリックし、[環境のインポート] をクリックします。
- ファイル選択ダイアログが開いたら、インポートする環境ファイルの場所を指定します。
環境の参照
環境の参照は、1 つの環境設定を複数のプロジェクトで共有する最も効率的な方法です。環境の参照を使用すると、複数のプロジェクトの環境設定を 1 箇所で簡単に変更できます。
環境を参照するには、以下の操作を行います:
- [環境] ノードを右クリックし、[環境の参照] をクリックします。
- 画面右側に構成パネルが開いたら、参照する環境ファイルの場所を指定します。
環境構成を参照した後は、環境変数を直接に編集できなくなることに注意してください。プロジェクトは、常に参照された *.env ファイルの変数を使用するようになります。*.env ファイルを変更すると、それを参照するすべてのプロジェクトに変更が反映されます。