メインコンテンツまでスキップ

動的値

EchoAPIでインターフェースをデバッグする際、リクエストパラメータやリクエストボディにさまざまなデータ（値、名前、住所など）を構築する必要があることがよくあります。このプロセスを簡素化するために、「ダイナミックバリュー」機能を導入しました。ダイナミックバリューを使用すると、リクエストを送信するたびに、あらかじめ設定されたルールに基づいて新しいデータを自動的に生成できます。これにより、テストの効率が向上するだけでなく、各リクエストにユニークな情報が含まれることが保証されます。

ダイナミックバリューの利点：​

  • 実データをシミュレートできます：ダイナミックバリューを使用してさまざまなテストデータを生成し、テストカバレッジを向上させます。
  • ユニークな値を生成できます：（例：注文番号、ユーザーID）
  • データ処理を簡素化できます：ダイナミックバリューは手動でデータを変更する作業を減らし、テストの効率を向上させます。

次に、この機能を効果的に使用して、テスト作業をより効率的かつ便利にする方法を探ります。

機能1：変数の参照​

パラメータ値で環境変数/グローバル変数を使用する必要がある場合、入力ボックスに直接 {{ を入力すると、既存の変数を引き出して迅速に追加できます。

さらに、入力ボックスの横にあるアイコンをクリックして追加することもできます。この方法を使用すると、変数値を参照するだけでなく、変数値に対して 暗号化 や 復号化 などの関数処理を追加できます。

  1. アイコンをクリックし、「変数を参照」を選択します。

image.png

  1. ここで、環境変数またはグローバル変数をドロップダウンから選択できます。

image.png

  1. 変数を選択すると、下部に変数値をプレビューできます。また、関数による処理を追加することも可能です。

image.png

  1. 処理関数を追加すると、プレビューで関数を追加した後の値を確認できます。カスタム関数もサポートされています。使用方法を確認する

image.png

image.png

  1. 「挿入」または「置換」をクリックして、内容をパラメータ値の入力ボックスに書き込みます。
    • 挿入： 最後に追加します。
    • 置換： 入力ボックス内のすべての内容を置き換えます。

image.png

tip

注意：ここでプレビューされている変数値は、この時点でのローカル値です。もし事前実行操作や他の場所で変数を変更した場合、実際に送信される値は最終的な変数値に基づきます。実際に送信したデータは、レスポンスセクションで確認できます。

  1. 追加された値を修正したい場合は、マウスをホバーして「編集」をクリックできます。

image.png

機能2：実データのシミュレーション​

実データをモックする必要がある場合は、モックを選択できます。私たちのモックはFakerによる方法に基づいています。詳細についてはFakerを参照してください。

  1. アイコンをクリックし、「モック」を選択します。

image.png

  1. ドロップダウンからモックするデータの種類を選択します：携帯番号、メールアドレス、タスク名、動物名など。

image.png

  1. 一部の関数では、より適した実データを生成するためにパラメータの設定を行うことができます。パラメータの使用方法についてもFakerのこちらを参照できます。Faker

image.png

  1. 同様に、モックデータに処理関数（暗号化など）を追加することもできます。カスタム関数もサポートされています。使用方法を確認する

image.png

  1. 「挿入」または「置換」をクリックして、内容をパラメータ値の入力ボックスに書き込みます。
    • 挿入： 最後に追加します。
    • 置換： 入力ボックス内のすべての内容を置き換えます。

image.png

  1. 追加された値を修正したい場合は、マウスをホバーして「編集」をクリックできます。

image.png

機能3：固定値で関数処理を行う​

特定のリクエストパラメータに関数処理を追加するだけで、変数やモックが不要な場合、固定値を選択することができます。具体的な値を入力し、処理関数を追加します。

  1. アイコンをクリックし、「固定値」を選択します。

image.png

  1. 入力ボックスに処理を行いたいパラメータ値を入力します。例えば、123456 を md5 で暗号化する場合は、123456 と入力します。

image.png

  1. 処理関数を追加し、md5 を選択すると、プレビューでmd5暗号化後の値が表示されます。カスタム関数もサポートされています。使用方法を確認する

image.png

image.png

  1. 「挿入」または「置換」をクリックして、内容をパラメータ値の入力ボックスに書き込みます。
    • 挿入： 最後に追加します。
    • 置換： 入力ボックス内のすべての内容を置き換えます。

image.png

  1. 追加された値を修正したい場合は、マウスをホバーして「編集」をクリックできます。

image.png

body-rawでの適用​

bodyがrawフォーマットの場合も、ダイナミックバリューを挿入することができます。挿入したい位置にマウスカーソルを置いてからアイコンをクリックし、ダイナミックバリューの設定を行います。方法は同様です。

image.png

image.png

送信されたダイナミックバリューの確認​

ダイナミックバリューを挿入した後、送信をクリックすると、レスポンスセクションのActual Requestで実際に送信されたデータを確認できます。

image.png