Testim Docs JA

Tricentis Testim ユーザー制作日本語翻訳ドキュメント

パラメーター

Testim Docs

パラメーターは、テストステップ/テスト/テストスイートへ情報を受け渡すための変数です。事前に値を固定せずに、異なるシナリオを切り替えて検証できます。定義方法には複数あり、方法ごとに有効範囲(スコープ)が異なります。

パラメーターの定義方法

事前定義(標準)パラメーター

BASE_URLTESTIM_ITERATORnetworkRequests は標準で利用できる特別なパラメーターです。通常のパラメーターと異なり、事前の定義は不要でそのまま参照できます。

Base URL パラメーター

テスト実行のベース URL(テスト定義の値、または上書き値)が入ります。パラメーターが使える場所ならどこでも利用可能です。

データ駆動テストでの動的なベース URL としても有用です。例えば複数サイトに同一テストを流す場合、与えるデータに応じて BASE_URL を切り替えられます。
詳細は Base URL を参照してください。

Testim Iterator パラメーター

TESTIM_ITERATOR はグループのループ内でのみ利用でき、現在の反復回数を示します。ループのたびに 1 ずつ増加します。

詳細は ループイテレーターパラメーターの使用 を参照してください。

Network Requests パラメーター

networkRequests は、実行中に発生したネットワークリクエストをオブジェクト配列として収集します。ネットワーク検証ステップ内でのみ利用できます。詳細は ネットワーク検証の追加 を参照してください。

パラメーターの使用方法

定義したパラメーターは、名前をそのまま(引用符なし)で記述して参照します。

myParam が定義済みパラメーターです

myParam が定義済みパラメーターです。定義したパラメーターは、次の場所で使用できます。

  • プロパティパネルの任意のテキスト入力欄 - プロパティパネルの任意のテキスト入力欄で利用できます。例: テキスト検証の「期待値」、ステップの実行条件(要素テキスト)の「期待値」など。以下の入力欄はパラメーターの使用に非対応です:
  • Variable Name
  • Description
  • Date Format
  • プロパティパネルの Param セクションにある式入力欄 - パラメーターを定義すると式入力欄が表示され、そこに別の定義済みパラメーターを設定して値を連鎖させることもできます。
  • 任意の関数エディターパネル - 一部のステップ(例: カスタム検証)やカスタム条件には関数エディターパネルがあります。定義済みパラメーターをこのエディター内で参照可能です。詳細は 高度な JS エディター を参照してください。
  • API ステップ - API ステップには、定義済みパラメーターの使用をサポートする以下のテキストセクションがあります:
  • Request URL - このセクションでは二重または三重ブラケットでパラメーターを参照します(例: {{{param}}})。
  • Header - このセクションでは二重または三重ブラケットでパラメーターを参照します(例: {{{param}}})。
  • Body - このセクションでは二重または三重ブラケットでパラメーターを参照します(例: {{{param}}})。
  • Assertion
  • Function editor

パラメーターを非表示にする

パラメーターに機微情報を含む場合は、非表示パラメーター の手順で値の保存・表示を抑制できます。