すべてのプロダクト
Search
ドキュメントセンター

Performance Testing:カスタムパラメーター

最終更新日:Sep 05, 2026

同じテストシナリオを複数の環境に対して実行する場合、環境ごとにシナリオを複製すると、保守コストが増加し、設定ドリフトのリスクも高まります。カスタムパラメーターを使用すると、再利用可能な変数を定義でき、単一の値を更新するだけで、環境、エンドポイント、またはシナリオ全体に適用されるその他の設定を切り替えられます。

Performance Testing (PTS) では、次の 2 つのパラメーター スコープをサポートしています:

  • グローバルパラメーター:テストシナリオ全体に適用されます。すべてのビジネスセッション内のすべての API は同じ値を使用します。

  • ビジネスセッションパラメーター:単一のビジネスセッション (トランザクション) 内で適用されます。各ビジネスセッションは、それぞれ独立してパラメーター値を解決します。

パラメーター参照構文

API 設定でカスタムパラメーターを参照するには、${<parameter-name>} 構文を使用します。domain という名前のパラメーターは、${domain} として参照します:

http://${domain}

サポートされるコンテンツタイプとサポートされないコンテンツタイプ

コンテンツタイプサポート
文字列はい
システム関数はい
ファイルパラメーターいいえ
出力パラメーターいいえ
重要

カスタムパラメーターでシステム関数を使用し、同じビジネスセッション内の 2 つの API がそのパラメーターを参照する場合、各仮想ユーザーに対して両方の API は同じ値に解決されます。

グローバルパラメーターの作成

グローバルパラメーターは、テストシナリオ全体で有効になります。

前提条件

開始する前に、次の項目を準備してください:

操作手順

  1. PTS コンソールにログインします。

  2. [Performance Test] > [Create Scenario] を選択し、[PTS] をクリックします。

  3. [PTS Scenario] ページで、ページ下部の [Parameters] をクリックします。

  4. [Custom Parameters] タブで、[Parameter Name] と [Parameter Logic] を入力し、[Confirm] をクリックします。

例:環境間でのドメイン名の切り替え

異なる環境に対して API をテストする場合、環境間で変更されるのはドメイン名のみです。domain パラメーターを定義することで、各 API URL を個別に編集する必要がなくなります。

  1. [Custom Parameters] タブで、domain という名前のパラメーターを作成し、その値を対象のドメインに設定します。

    たとえば、[Parameter Name] を domain に、[Parameter Logic] を www.example.com に設定します。

  2. API 設定で、URL を http://${domain} に設定します。

環境を切り替えるには、domain パラメーターの値を更新します。${domain} を参照するすべての API に変更が自動的に反映されます。

ビジネスセッションパラメーターの作成

ビジネスセッションパラメーターは、単一のビジネスセッション全体で有効になります。1 つのトランザクション内の複数の API 呼び出しで値を一貫させる必要がある一方、ビジネスセッションごとに値が異なってもよい場合に、ビジネスセッションパラメーターを使用します。

設定の詳細については、「データ設定におけるカスタムパラメーター」をご参照ください。

関連トピック