Postmanユーザーは、リクエストボディ、事前リクエスト、およびテストスクリプトとともに動的な値を保存および再利用するために、変数を使用することがよくあります。
変数の表記
mablでAPIテスト変数を操作するときには、Postmanの変数表記 {{variableName}} を使用できます。
Postmanの変数タイプ
Postmanには5つの変数タイプがあり、既存のコレクションをmablにインポートするときは、この点に注意する必要があります。下の図は、Postman変数とmabl変数のマッピングの概要を示しています。
Postmanとmabl間の変数マッピング
この変数マッピングを踏まえると、以下のアクションが必要となる場合があります。
- 環境変数は対応するmabl環境に直接インポートできます。Postmanの環境変数をmabl環境にインポートするには、環境編集ページの [Import Postman variables] ボタンをクリックします。
- Postmanのグローバル変数は、mablの環境レベルで定義するか、エクスポートされるPostmanコレクションに追加する必要があります。
- Postmanのコレクションレベルの変数は、自動的にインポートされ、それぞれのmabl APIテストに関連付けられます。これらの変数は、テスト詳細ページのデータ駆動型変数セクションの下に表示されます。
- リクエスト内でpm.iterationData.get("variable_name") などのPostmanのデータレベル変数を使用する場合は、mablでDataTableを作成し、それぞれのAPIテストに関連付けます。テストの実行時に、mablはDataTable内の一致する変数名に基づいてpm.iterationData変数に値を割り当てます。
- Postmanのローカル変数はmablではテスト生成変数と見なされるため、後続のAPIリクエストに渡されるだけでなく、テストの変数の共有が有効な場合はプラン内の他のテストと共有されます。
テストデータを含むCSVまたはJSONファイルのインポート
mablにインポートしたPostmanコレクションとともにCSVまたはJSONファイルのテストデータを使用するには、テストデータをmablのDataTableに変換する必要があります。mablのDataTableはCSVファイルのインポートから簡単に作成できますが、現時点ではJSONファイル形式はサポートされていません。
ベースURLのインポート
mablアプリケーションは、api.urlと呼ばれるシステムレベルの変数に割り当てられたベースAPI URLを使用します。Postmanコレクション内のベースURLに同じ変数名であるapi.urlを使用して、mablとPostmanの間でコレクションを簡単にインポート/エクスポートできるようにすることをお勧めします。
このように、Postmanコレクションをmablにインポートすると、APIリクエストのURLは、mabl環境用に設定されたapi.url値に基づいて自動的に作成されます。
Postmanの動的変数
Postmanには、APIリクエストのダミーデータを生成するのに役立つ動的変数の概念もあります。このような動的変数は、mablで期待どおりに機能します。