スイート変数の作成と使用
Eggplant Functionalの設定タブでは、特別なユーザー定義型の事前定義された変数であるスイート変数を定義できます。スイート変数は、スイート内の任意のスクリプトとSenseTalkのマージフォーマットを使用したAPIテストにアクセス可能です。設定タブには、Eggplant Functional Suiteウィンドウの左下にあるSettingsボタンをクリックしてアクセスできます。
変数のスコープ
スイート変数のスコープはローカルと見なされます。(さまざまな変数スコープの説明については、SenseTalkの変数を参照してください。)ただし、スイートに対してそれらを定義するため、スクリプトの実行またはハンドラーの開始時に値を持つことができ、初期値を割り当てる必要がありません。次のハンドラーの開始時にはデフォルトに戻るので、スクリプトの実行中に変数を使用して値を上書きすることができます。
SenseTalk内では、スイート変数はthe suiteVariables
グローバルプロパティに格納されます。したがって、グローバルプロパティを通じてスクリプト実行中にスイート変数のデフォルト値を変更することが可能です。スイート変数は複数のスクリプトやAPIテストからアクセスされる可能性があるため、この方法で値を更新するときは注意が必要で、どのコンテキストを変更しているのかを知っている場合にのみ行うべきです。
スイ ート変数の作成
スイート変数は基本的にキー/値のペアで、変数名(キー)と変数に割り当てる値です。設定タブのSuite Variablesセクションでスイート変数を作成できます。
Eggplant Functionalの設定タブのスイート変数セクション
新しいスイート変数を作成するには:
- Addをクリックします。
- Keyフィールドに変数名を入力します。定義している変数を明確に識別できる一意の名前を使用してください。たとえば、スクリプトで通常
myVar
のような名前を使用する場合、スイート変数の名前としてそれを使用することは避けたいでしょう。 - Valueフィールドにこの変数の値を入力します。
スイート変数は自動的に保存されます。ここで必要なだけのスイート変数を追加できます。
Eggplant Functionalのスイート変数セクションに定義された変数が表示されています
Suite Variablesセクションで既存のスイート変数を編集するには、編集したい変数のKeyまたはValueフィールドをクリックし、情報を更新します。
既存のスイート変数のキー名を変更することは可能ですが、おすすめしません。ここで名前を変更しても、スクリプトやこのスイート変数を既に参照している他の場所での名前は変更されません。したがって、キー名を変更すると予期しない結果につながる可能性があります。
スイート変数を削除するには、削除したい変数の右側にあるDelete rowボタンをクリックします。変数の削除は、スクリプトや他の場所で含めた変数への参照を削除しませんが、変数は事前定義された値を持つことはありません。
グローバルプロパティの使用方法
SenseTalkスクリプト内のthe suiteVariables
グローバルプロパティを通じて、直接スイート変数を作成または更新することも可能です。
set the suitevariables to (baseURL:"http://examples.com")