--- title: "テストプラン変数" slug: "test-plan-variables" updated: 2023-11-27T06:01:45Z published: 2023-11-27T06:01:45Z canonical: "help.autify.com/test-plan-variables" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.autify.com/llms.txt > Use this file to discover all available pages before exploring further. # テストプラン変数 ## 概要 テストプラン変数は、テストプランに設定できるキーと値のペアで、テストプラン内のシナリオから参照することができます。テストプラン内のシナリオで共通で使われるような変数、たとえばユーザーIDや環境設定などがある場合に、テストプラン変数は便利です。 ## 変数の使用 ### 変数の優先度 Autifyには[テスト間の変数の受け渡し](/v1/docs/ja/passing-variables-between-tests)の仕組みがあるので、異なるレベルの変数を柔軟に使うことができます。テストプラン変数の話題に移る前に、Autifyでは異なる種類の変数がどのように動作するかを見てみましょう。シナリオから参照される変数は、インポート変数と呼ばれるキーと値のペアとして定義されます。インポート変数を持つシナリオがテストプラン内で実行された場合、変数は以下の順番で参照されます： 1. テストプラン内で先行するシナリオ実行から**エクスポートされた変数** 2. テストプランで定義された変数（**テストプラン変数**） 3. シナリオに設定された**インポート変数のデフォルト値** ![Variables-ja.png](https://cdn.document360.io/a099d8a2-cfd2-42ca-9906-68b4a337f4a5/Images/Documentation/Variables-ja.png?sv=2026-02-06&spr=https&st=2026-11-02T22%3A35%3A59Z&se=2026-11-02T23%3A35%3A59Z&sr=c&sp=r&sig=S0rIXOHyAfaKkN0H5p6H%2BZZQ5sf1LxrCItndCdMV79k%3D) [テスト間の変数受け渡し](/v1/docs/ja/passing-variables-between-tests)も参照してください。 ### テストプラン変数を参照するシナリオの作成 テストプラン変数を参照するには、まずインポート変数を持つシナリオを作成する必要があります。インポート変数については、ドキュメントを参照してください。 ![Screen Shot 2023-11-13 at 8.58.51.png](https://cdn.document360.io/a099d8a2-cfd2-42ca-9906-68b4a337f4a5/Images/Documentation/Screen%20Shot%202023-11-13%20at%208.58.51.png?sv=2026-02-06&spr=https&st=2026-11-02T22%3A35%3A59Z&se=2026-11-02T23%3A35%3A59Z&sr=c&sp=r&sig=S0rIXOHyAfaKkN0H5p6H%2BZZQ5sf1LxrCItndCdMV79k%3D) ### テストプラン変数の作成 シナリオができたら、テストプラン変数を作成しましょう。テストプラン詳細画面の「テストプラン変数」へ移動し、「追加」をクリックして変数を追加します。 ![Screen Shot 2023-11-12 at 21.20.27.png](https://cdn.document360.io/a099d8a2-cfd2-42ca-9906-68b4a337f4a5/Images/Documentation/Screen%20Shot%202023-11-12%20at%2021.20.27.png?sv=2026-02-06&spr=https&st=2026-11-02T22%3A35%3A59Z&se=2026-11-02T23%3A35%3A59Z&sr=c&sp=r&sig=S0rIXOHyAfaKkN0H5p6H%2BZZQ5sf1LxrCItndCdMV79k%3D) 変数のキーとデフォルト値を指定し、「作成」ボタンをクリックします。キーの名前が、シナリオに設定されたインポート変数と同じものになるようにしてください。 ![Screen Shot 2023-11-12 at 21.21.04.png](https://cdn.document360.io/a099d8a2-cfd2-42ca-9906-68b4a337f4a5/Images/Documentation/Screen%20Shot%202023-11-12%20at%2021.21.04.png?sv=2026-02-06&spr=https&st=2026-11-02T22%3A35%3A59Z&se=2026-11-02T23%3A35%3A59Z&sr=c&sp=r&sig=S0rIXOHyAfaKkN0H5p6H%2BZZQ5sf1LxrCItndCdMV79k%3D) この手順を繰り返せば、最大50個までテストプラン変数を作成することができます。 ![Screen Shot 2023-11-12 at 21.22.31.png](https://cdn.document360.io/a099d8a2-cfd2-42ca-9906-68b4a337f4a5/Images/Documentation/Screen%20Shot%202023-11-12%20at%2021.22.31.png?sv=2026-02-06&spr=https&st=2026-11-02T22%3A35%3A59Z&se=2026-11-02T23%3A35%3A59Z&sr=c&sp=r&sig=S0rIXOHyAfaKkN0H5p6H%2BZZQ5sf1LxrCItndCdMV79k%3D) ### 変数を使ったテストの実行 次に、テストプラン変数を使ったテストがどのように実行されるのか、例を見てみましょう。 #### シナリオ このシナリオは `FIRST_NAME` と `LAST_NAME` をインポート変数として取り込みます。`FIRST_NAME` のデフォルト値は "Foo"、`LAST_NAME` のデフォルト値は "Bar" とします。 ![Screen Shot 2023-11-21 at 1.16.07.png](https://cdn.document360.io/a099d8a2-cfd2-42ca-9906-68b4a337f4a5/Images/Documentation/Screen%20Shot%202023-11-21%20at%201.16.07%281%29.png?sv=2026-02-06&spr=https&st=2026-11-02T22%3A35%3A59Z&se=2026-11-02T23%3A35%3A59Z&sr=c&sp=r&sig=S0rIXOHyAfaKkN0H5p6H%2BZZQ5sf1LxrCItndCdMV79k%3D) シナリオでは、テキストを入力するステップで `FIRST_NAME` と `LAST_NAME` をそれぞれ利用しています。 ![Screen Shot 2023-11-21 at 1.15.52.png](https://cdn.document360.io/a099d8a2-cfd2-42ca-9906-68b4a337f4a5/Images/Documentation/Screen%20Shot%202023-11-21%20at%201.15.52.png?sv=2026-02-06&spr=https&st=2026-11-02T22%3A35%3A59Z&se=2026-11-02T23%3A35%3A59Z&sr=c&sp=r&sig=S0rIXOHyAfaKkN0H5p6H%2BZZQ5sf1LxrCItndCdMV79k%3D) #### テストプラン このテストプランは `FIRST_NAME` と `LAST_NAME` をテストプラン変数に持っています。`FIRST_NAME` の値は "Hatty"、`LAST_NAME` の値は "Bee" です。 ![Screen Shot 2023-11-22 at 17.48.13.png](https://cdn.document360.io/a099d8a2-cfd2-42ca-9906-68b4a337f4a5/Images/Documentation/Screen%20Shot%202023-11-22%20at%2017.48.13%281%29.png?sv=2026-02-06&spr=https&st=2026-11-02T22%3A35%3A59Z&se=2026-11-02T23%3A35%3A59Z&sr=c&sp=r&sig=S0rIXOHyAfaKkN0H5p6H%2BZZQ5sf1LxrCItndCdMV79k%3D) #### テスト結果 シナリオの「今すぐ実行」でテストが個別に実行された場合、インポート変数のデフォルト値が利用されます。 - FIRST_NAME = `Foo` (デフォルト値) - LAST_NAME = `Bar` (デフォルト値) ![Screen Shot 2023-11-21 at 1.14.52.png](https://cdn.document360.io/a099d8a2-cfd2-42ca-9906-68b4a337f4a5/Images/Documentation/Screen%20Shot%202023-11-21%20at%201.14.52.png?sv=2026-02-06&spr=https&st=2026-11-02T22%3A35%3A59Z&se=2026-11-02T23%3A35%3A59Z&sr=c&sp=r&sig=S0rIXOHyAfaKkN0H5p6H%2BZZQ5sf1LxrCItndCdMV79k%3D) 一方、シナリオが前述のテストプランの中で実行された場合は、テストプラン変数が参照されます。 - FIRST_NAME = `Hatty` (テストプラン内のデフォルト値) - LAST_NAME = `Bee` (テストプラン内のデフォルト値) ![Screen Shot 2023-11-21 at 1.15.29.png](https://cdn.document360.io/a099d8a2-cfd2-42ca-9906-68b4a337f4a5/Images/Documentation/Screen%20Shot%202023-11-21%20at%201.15.29.png?sv=2026-02-06&spr=https&st=2026-11-02T22%3A35%3A59Z&se=2026-11-02T23%3A35%3A59Z&sr=c&sp=r&sig=S0rIXOHyAfaKkN0H5p6H%2BZZQ5sf1LxrCItndCdMV79k%3D) ## ユースケース ### 異なる複数の環境に対してテストする テストプラン変数の主な用途に一つに、異なる環境に対して異なる値を利用したいケースが挙げられます。これは、URL置換機能と併用するととても強力です。たとえば、ドメインが異なる本番環境とステージング環境で、別々のユーザーIDを利用したいケースを考えてみましょう。 | | 開始URL | ユーザーID | | --- | --- | --- | | 本番環境 | https://prd.example.com | prd@example.com | | ステージング環境 | https://stg.example.com | stg@example.com | これは、以下の方法で実現することができます。 - ユーザーIDをインポート変数として取得するシナリオを作成する - 環境毎（本番・ステージング）に、以下を設定した別々のテストプランを作成する - URL置換（本番・ステージング） - ユーザーID用のテストプラン変数 このようにすれば、簡単に複数の環境に対して変数と共にテストプランを活用させることができます。 #### ステージング環境用のテストプランの設定 ![Screen Shot 2023-11-21 at 0.53.14.png](https://cdn.document360.io/a099d8a2-cfd2-42ca-9906-68b4a337f4a5/Images/Documentation/Screen%20Shot%202023-11-21%20at%200.53.14.png?sv=2026-02-06&spr=https&st=2026-11-02T22%3A35%3A59Z&se=2026-11-02T23%3A35%3A59Z&sr=c&sp=r&sig=S0rIXOHyAfaKkN0H5p6H%2BZZQ5sf1LxrCItndCdMV79k%3D) #### 本番環境用のテストプランの設定 ![Screen Shot 2023-11-21 at 0.55.19.png](https://cdn.document360.io/a099d8a2-cfd2-42ca-9906-68b4a337f4a5/Images/Documentation/Screen%20Shot%202023-11-21%20at%200.55.19.png?sv=2026-02-06&spr=https&st=2026-11-02T22%3A35%3A59Z&se=2026-11-02T23%3A35%3A59Z&sr=c&sp=r&sig=S0rIXOHyAfaKkN0H5p6H%2BZZQ5sf1LxrCItndCdMV79k%3D) みなさまがどのようにテストプラン変数を活用されるか、楽しみしています！