--- title: "変数" url: https://docs.catalyst.zoho.com/ja/devops/help/automation-testing/variables/ description: "Automation Testingにより、FunctionエンドポイントまたはサードパーティURLで効率的な自動APIテストを実行し、問題領域を解決できます。" last_updated: 2026-08-17T12:16:04Z service: DevOps type: general --- # 変数 ### はじめに 変数は、リクエストで渡す可能性のある動的な値のプレースホルダーです。頻繁に使用する値を変数として保存し、テストケースで参照することで、値を変更する必要がある場合に、使用している各テストケースで変更する必要がないため、作業が容易になります。設定した変数を編集するだけで済みます。 Automation Testingでは、さまざまな目的で使用されるさまざまなタイプの変数を設定できます。 変数を使用する1つの方法は、_Variables_セクションで固定パラメータの値を定義・保存し、リクエストで簡単に参照することです。これには以下の2種類の変数があります： * **グローバル変数:** グローバル変数は、任意のテストケースで使用するために定義・保存できる単一の変数セットです。これらの変数はグローバルスコープを持ち、すべてのテストケースに適用できます。 * **環境変数:** 環境変数は、異なる環境に対して同じキーの値を分類・設定するのに役立ちます。[テストプラン](https://docs.catalyst.zoho.com/ja/devops/help/automation-testing/test-plans)を設定するか、[テストケースの即時実行](https://docs.catalyst.zoho.com/ja/devops/help/automation-testing/modules-test-cases/#manage-a-test-case-and-its-requests)を実行する際に、実行に使用する環境を選択できます。その環境で定義された変数が適用されます。これらの変数は、すべてのテストケースでグローバルに使用することもできます。 Automation Testingで変数を使用するもう1つの方法は、テストケース内の個々のリクエストのレスポンスから受信した値を抽出し、チェーン設定で次のリクエストのパラメータとして渡すために変数に割り当てることです。リクエスト内で定義されたこのような変数のスコープはそのテストケースに限定され、そのテストケースの外では参照できません。この方法については、[リクエストのチェーンセクション](https://docs.catalyst.zoho.com/ja/devops/help/automation-testing/modules-test-cases/#chain-requests)で例を用いて詳しく説明します。 #### グローバル変数と環境変数の例： 各環境で1つの変数に異なる値を保存できます。たとえば、CatalystのZAIDの値は開発環境と本番環境で異なります。その場合、まず「Development」と「Production」という名前の2つの環境を作成します。次に、これらの両方の環境で「zaid」という名前の変数を作成し、それぞれの値を個別に定義します。 テストプランの設定時に_Development_を選択すると、リクエストで変数zaidを使用している箇所に、開発環境でzaidに定義された値が適用されます。 ![](https://catalyst-docs-development.zohostratus.in/images/help/automation-testing/catalyst_pilot_create_test_plan_3.webp) 同じ変数をグローバル変数として定義し、各環境で個別に定義することもできます。 たとえば、_baseURL_というグローバル変数を作成し、値を「https://globaltest.com」と定義できます。次に、DevelopmentおよびProduction環境で同じ_baseURL_変数を、それぞれ「https://developmenttest.com」と「https://productiontest.com」の値で作成できます。 ここで、[テストケースのリクエストを設定](https://docs.catalyst.zoho.com/ja/devops/help/automation-testing/modules-test-cases)する際に、_baseURL_をリクエストURLとして参照するとします。[即時実行](https://docs.catalyst.zoho.com/ja/devops/help/automation-testing/modules-test-cases/#manage-a-test-case-and-its-requests)の実行時に使用する環境変数として_Development_を選択すると、https://developmenttest.comの値がリクエストURLとして使用されます。_Production_を選択すると、「https://productiontest.com」の値が使用されます。即時実行で環境を選択しない場合、デフォルトでグローバル値「https://globaltest.com」が使用されます。 #### 覚えておくべき重要なポイント： * 同じ変数をグローバル変数および異なる環境変数として作成することは、同じキーに複数の値を割り当てることになります。 * グローバル変数を作成し、対応する環境変数を持つことができます。特定の環境でのみ新しい変数を作成した場合でも、同じ値でグローバル変数セクションに一覧表示されます。 * 環境が選択されていない場合、テストプランまたは即時実行ではデフォルトでグローバル変数が使用されます。環境を選択した場合にのみ、その環境の値がグローバル値をオーバーライドします。 * 特定のリクエスト内で作成するローカル変数は、名前で直接宣言でき、他のリクエストで\{\{\\}\} 形式の[パラメータ値として渡す](https://docs.catalyst.zoho.com/ja/devops/help/automation-testing/modules-test-cases/#configure-a-request)必要があります。 * グローバル変数と環境変数は、リクエスト内で**\{\{$\\}\}**形式で渡す必要があります。 ### グローバル変数の作成 以下の方法でグローバル変数を作成できます： 1. _Automation Testing_の**Variables**タブをクリックし、**Create Variable**をクリックします。 ![catalyst_pilot_create_variable_1](https://catalyst-docs-development.zohostratus.in/images/help/automation-testing/catalyst_pilot_create_variable_1.webp) 2. 変数の名前と値を入力し、**Save**をクリックします。 ![catalyst_pilot_create_variable_2](https://catalyst-docs-development.zohostratus.in/images/help/automation-testing/catalyst_pilot_create_variable_2.webp) > **注意:** 変数名にスペースを含めたり、数字で始めたりすることはできません。変数名は大文字と小文字が区別されます。 右上の**Bulk Add**をクリックして、複数の変数を一括で追加することもできます。ポップアップウィンドウで`key:value`形式で変数を定義し、**Save**をクリックします。![catalyst_pilot_variable_bulk_add](https://catalyst-docs-development.zohostratus.in/images/help/automation-testing/catalyst_pilot_variable_bulk_add.webp) すべての変数が追加され一覧表示されます。 ![catalyst_pilot_variable_bulk_added](https://catalyst-docs-development.zohostratus.in/images/help/automation-testing/catalyst_pilot_variable_bulk_added.webp) ### 環境変数の作成 環境変数を作成する前に、環境を作成する必要があります。 1. _Variables_セクションから**Environment Variables**をクリックします。 2. ポップアップウィンドウで環境名を入力し、**Create**をクリックします。 ![catalyst_pilot_env_variable_1](https://catalyst-docs-development.zohostratus.in/images/help/automation-testing/catalyst_pilot_env_variable_1.webp) 3. グローバル変数の作成と同じ方法で、その環境内に変数を作成できます。変数の名前と値を入力し、**Save**をクリックします。![catalyst_pilot_env_variable_2](https://catalyst-docs-development.zohostratus.in/images/help/automation-testing/catalyst_pilot_env_variable_2.webp) 環境のセクションでは、Nameテキストボックスをクリックすると、すべてのグローバル変数が一覧表示されます。いずれかを選択して、この環境でその変数に異なる値を割り当てるか、テキストボックスに入力して完全に新しい変数を作成できます。この変数はグローバルセクションにも一覧表示されます。 右上の**Bulk Add**をクリックして、グローバル変数の一括追加と同じ方法で、複数の環境変数を一括で追加することもできます。 ### グローバル変数と環境変数の管理 上部のドロップダウンをクリックして、グローバル変数または特定の環境の変数を開くことを選択できます。必要なオプションを選択します。 ![catalyst_pilot_variable_dropdown](https://catalyst-docs-development.zohostratus.in/images/help/automation-testing/catalyst_pilot_variable_dropdown.webp) * **環境名の編集:** 環境名の横にある編集アイコンをクリックします。ポップアップウィンドウで変更を行い、**Update**をクリックします。 ![catalyst_pilot_env_edit](https://catalyst-docs-development.zohostratus.in/images/help/automation-testing/catalyst_pilot_env_edit.webp) * **環境の削除:** 環境名の横にある削除アイコンをクリックします。ポップアップウィンドウで**Yes**をクリックします。 ![catalyst_pilot_env_delete](https://catalyst-docs-development.zohostratus.in/images/help/automation-testing/catalyst_pilot_env_delete.webp) > **注意:** 環境またはグローバル変数・環境変数を削除すると、設定済みのテストケースに影響を与え、データ損失が発生する可能性があります。慎重に操作してください。 * **変数の削除:** 変数名にカーソルを合わせると表示される編集アイコンをクリックして、グローバル変数または環境変数を削除できます。 ![catalyst_pilot_variable_delete_1](https://catalyst-docs-development.zohostratus.in/images/help/automation-testing/catalyst_pilot_variable_delete_1.webp) 確認ポップアップウィンドウで**Yes**をクリックします。 ![catalyst_pilot_variable_delete_2](https://catalyst-docs-development.zohostratus.in/images/help/automation-testing/catalyst_pilot_variable_delete_2.webp)