フローパラメーターを使用すると、変数のスコープを1つのフローに限定したり、別の変数でフローを再利用したりできます。この記事では、mablトレーナーでパラメーター化されたフローを操作するさまざまな方法について説明します。
- 新しいフローにパラメーターを追加する
- デフォルトのパラメーター値をオーバーライドする
- デフォルトのパラメーター値を更新する
- 既存のフローにパラメーターを追加する
- フローパラメーターをフローの外部にエクスポートする
- フローパラメーターを削除する
新しいフローにパラメーターを追加する方法
新しいフローにパラメーターを追加するには、mablトレーナーで次の手順を実行します。
- [+ (Add step)] > [Create a flow] をクリックします。
- フローに名前を付けます。
- [Parameters] タブをクリックします。
- [Manage parameters] をクリックして、新しいパラメーターを追加します。
- パラメーターの名前とデフォルト値を指定します。静的な文字列または数値を入力したり、有効な式を使用してランダムな値を入力したり、mablの変数構文 (
{{@testVar}}
) を使用して別の変数を参照したりできます。 - [OK] をクリックして、変更内容を保存します。
フローパラメーターの値として変数を使用する場合は、フローの開始前にその変数を初期化してください。これを行わない場合、フローパラメーターを使用するステップによって [not yet evaluated]
という値が指定されます。
フローパラメーター変数は先頭にflow.
が付けられ、Trainerのカーソルが [Start flow] ステップと [End flow] ステップの内側にある場合にのみ利用できます。たとえば、フローにtestVar
というパラメーターがある場合、このパラメーターはフロー内ではflow.testVar
という変数になります。
デフォルトのパラメーター値をオーバーライドする方法
フローのデフォルトのパラメーター値をオーバーライドするには、次の手順を実行します。
- 鉛筆アイコンをクリックしてフローを編集します。
- [Parameters] タブをクリックします。
- パラメーター値を更新して、デフォルト値をオーバーライドします。
- [OK] をクリックして、オーバーライドを保存します。
1つのインスタンスでフローパラメーターをオーバーライドしても、フローの他のインスタンスのパラメーター値は (同じテスト内であっても) 更新されません。
デフォルトのパラメーターをオーバーライドする
デフォルトのパラメーター値を更新する方法
フローのデフォルトのパラメーター値を更新するには、次の手順を実行します。
- 鉛筆アイコンをクリックしてフローを編集します。
- [Parameters] タブをクリックします。
- [Manage parameters] をクリックします。
- デフォルトのパラメーター値を更新します。
- [OK] をクリックして、新しいデフォルトのパラメーター値を保存します。
デフォルトのパラメーター値を更新すると、デフォルトのパラメーター値を使用するフローのすべてのインスタンスの値が変更されます。
デフォルトのパラメーター値を更新する
既存のフローにパラメーターを追加する方法
既存のフローにパラメーターを追加するには、mablトレーナーでフローを含むテストを開き、次の手順を実行します。
- 鉛筆アイコンをクリックしてフローを編集します。
- [Parameters] タブをクリックします。
- [Manage parameters] をクリックして、新しいパラメーターを追加します。
- パラメーターの名前とデフォルト値を指定します。
フロー内のステップでパラメーター化する変数は、必ず新しく追加したパラメーターに置き換えてください。
フロー内の値をフローパラメーターに置き換える
フローパラメーターをフローの外部にエクスポートする方法
フローパラメーターをフローの外部で使用する場合は、フロー内でフローパラメーターを値として使用する新しい変数を作成します。
たとえば、flow.searchResult
という変数をフローの外部で使用する場合は、mySearchResult
という名前の新しい変数を作成し、{{@flow.searchResult}}
という値を指定します。
テスト内ですでに使用されている変数の名前を使用すると、元の変数がオーバーライドされます。
フローパラメーターを削除する方法
フローパラメーターを削除するには、mablトレーナーでフローを含むテストを開き、次の手順を実行します。
- 鉛筆アイコンをクリックしてフローを編集します。
- [Parameters] タブをクリックします。
- [Manage parameters] をクリックします。
- パラメーターを削除します。
- [OK] をクリックします。
パラメーターを削除した場合は、フロー内のステップをフローパラメーターではなく通常の変数を使用するように変更するか、フローのバージョンをパラメーターの使用を開始する前のバージョンに戻します。これを行わない場合、フローパラメーターを使用するステップによって [not yet evaluated]
という値が指定されます。
フローパラメーターを削除する