変数と環境

Restorm の変数は 変数フォルダー の中にあります。 1 つのフォルダーは、環境ごとに複数の変数セットを持てます。

環境とサブ環境

環境 はキーと値の組の一覧です。 その中に サブ環境 を持つこともでき、サブ環境は親を継承し、再定義した部分だけを上書きします。

staging → staging / customer A、staging / customer B のような構成をモデル化するのに向いています。 共通のベースは一度だけ書き、違う部分だけを繰り返します。

アクティブな環境を選ぶ

環境セレクターは、各リクエストタブの smartbar の左側にあります。 色付きのバッジと環境名が表示されます。

ポップオーバーには 「すべてのリクエストに適用」 チェックボックスがあります。 チェックするとフォルダー全体をまとめて切り替えられるので、 プロジェクト全体を local から staging に移すときに使います。

値の型

変数は単なる文字列ではありません。Restorm が用意している型は次のとおりです。

型	内容
文字列	リテラルな値。そのまま 送信されます
式	Handlebars テンプレート。{{ }} が評価される唯一の型です
数値	数値。表示形式を指定できます
ブール値	真 / 偽
日時	ISO 形式の日付。形式を指定できます
色	16 進数の色
シークレット	シークレットのソースへの参照。値がプロジェクトファイルを通ることはありません
リスト	値のリスト
列挙型 / 複数選択列挙型	インポートした列挙型によって制約される値
カスタムリスト / 複数選択カスタムリスト	カスタム値リスト のラベルから選択する値
変数	別の変数への参照
環境	環境への参照
Null	明示的な null 値

文字列か、式か？

これが最大の落とし穴です。 Bearer {{token}} を含む 文字列 型の変数は、波かっこも含めてそのまま送信されます。 置換を行わせるには、値の型を 式 にする必要があります。

解決順序

一般的なものから具体的なものへ。最後のものが優先されます。

1. ルートの環境、続いてその連鎖にある各サブ環境。
2. 環境自身の変数を、宣言された順に 解決します。 つまり、ある変数はその上で定義された変数を利用できます。
3. シナリオが設定した実行変数（変数を設定 アクション）。 これは実行中のあいだ環境を上書きします。
4. リクエスト固有の値（ヘッダー、クエリパラメーター、パスパラメーター）。 各グループは、それまでに積み上がったコンテキストの上で解決されます。
5. 最後に、リクエストのフィールドに直接書かれた {{ }}。 インライン変数 を参照してください。

さらに Restorm は複数回のパスを行うため、親環境の式が子で再定義された値を取得することもできます。

無効化した変数

各変数には有効化のチェックボックスがあります。 無効にした変数はコンテキストに入りません。 オーバーライドを削除せずに一時的に無効化する、すっきりした方法です。

インポート時には、値が空に解決されるキーと値の組が自動的に無効化されます。 そのため、最初の実行で空のヘッダーが大量に送られることはありません。

ヘルパーについて

すべての式は Handlebars テンプレートであり、 100 を超える 利用可能なヘルパー があります。 文字列、数学、日付、リスト、エンコード、ハッシュ、ランダムデータなどです。

変数はヘルパーより優先されます

min という名前の変数があり、同名の min ヘルパーも存在する場合、 {{min}}（引数なし）は 変数 を読み取り、 {{min a b}}（引数あり）は ヘルパー を呼び出します。