設定済みの自動テストシナリオを指定した時刻に自動実行し、タスク実行結果を取得して、スケジュールテストや回帰テストの要件を満たすために、「スケジュールされたタスク」を設定できます。スケジュールされたタスクは現在 Beta 版です。
スケジュールされたタスクへのアクセス#
「スケジュールされたタスク」にアクセスするには、Tests モジュールに移動し、「Scheduled Tasks」をクリックします。ここでは、すべてのスケジュールされたタスクが明確な構造のフォルダー形式で整理されていることを確認できます。フォルダーツリー内で、新しいスケジュールされたタスクや、タスクをグループ化するためのフォルダーを簡単に作成できます。さらに、特定のタスクやフォルダーの編集、削除などの操作を実行できます。Scheduled Tasks をクリックすると、右側にすべてのタスクの一覧が表示されます。この一覧には基本的な詳細情報と管理オプションが含まれており、タスクをより効率的に管理できます。スケジュールされたタスクの詳細#
既存のスケジュールされたタスクをクリックするか、新しいタスクを作成すると、右側にタスクの詳細が開きます。スケジュールされたタスクの詳細では、次の設定を構成できます。タスク名と説明: スケジュールされたタスクを区別し、その目的を詳細に説明するために使用します。
有効化/無効化: 必要に応じてトグルスイッチを使用し、スケジュールされたタスクを有効化または無効化します。
テストシナリオ: スケジュールされたタスクで実行する 1 つ以上のテストシナリオを選択します。各テストシナリオは展開して、実行時設定を個別に構成できます。Environment、test data、iterations、delay、saving requests/responses は標準の実行時設定です。 これらの設定の詳細はこちらを参照してください。環境/グローバル変数の値: このテストシナリオで使用する環境変数またはグローバル変数の実際の値を指定します。2 つのオプションがあり、詳細な説明はこちらで確認できます。Runner に保存された変数を使用することを選択した場合は、変数スコープをさらに定義する必要があります。これにより、実際のニーズに基づいて変数を分離し、実行中の変数競合によってタスクが失敗することを防げます。スコープを定義すると、ユーザーインターフェイス上で Runner に保存されている現在のテストシナリオ変数を確認 できます。 | 環境/グローバル変数スコープ | 環境/グローバル変数の読み取り/書き込み | 説明 |
|---|
| 現在のテストシナリオ内でのみ共有 | - 現在指定されている Runner 内で、このテストシナリオには環境/グローバル変数を永続的に保存するための専用ファイルがあります。
- 現在のテストシナリオのみが、このファイル内の変数を読み書きできます。
| 影響が最小限の、最も小さい変数スコープです。このテストシナリオの前回実行結果を次回実行で使用する必要がある場合に適しています。 |
| 現在のスケジュールされたタスク内のすべてのテストシナリオで共有 | - 現在指定されている Runner 内で、スケジュールされたタスクには、そのすべてのテストシナリオで使用できる環境/グローバル変数を保存するファイルがあります。
- 現在のスケジュールされたタスク内のすべてのテストシナリオが、このファイル内の変数を読み書きできます。
| 影響が中程度の、推奨される変数スコープです。同じスケジュールされたタスク内の異なるテストシナリオ間でデータを共有する必要がある場合に適しています。 |
| 現在のスケジュールされたタスクフォルダー内のすべてのスケジュールされたタスクで共有 | - 現在指定されている Runner 内で、スケジュールされたタスクフォルダーには、そのすべてのスケジュールされたタスクとテストシナリオで使用できる環境/グローバル変数を保存するファイルがあります。
- 現在のフォルダー内のすべてのスケジュールされたタスクに含まれるすべてのテストシナリオが、このファイル内の変数を読み書きできます。
| 最も大きく、最も大きな影響を与える変数スコープです。特定のスケジュールされたタスクを実行すると変数値が変更され、他のスケジュールされ たタスクが失敗する可能性があります。同じフォルダー内の複数のタスク間でデータを共有する必要がある場合に適しています。 |
テストシナリオ設計ページの Keep variable values オプションを有効にして、実行中にプリ/ポストプロセッサー経由で設定された変更中の環境/グローバル変数が、Runner 内の指定された変数スコープに保存されるようにする必要があります。
同じ実行設定を使用: 下記のタスク内のすべてのテストシナリオに同じ実行時設定を適用します。
実行サイクル: 毎週日曜日の午後 11 時や 6 時間ごとなど、タスクのスケジュールを設定します。
実行場所: Apidog Cloud（近日公開予定）または Self-hosted Runner など、タスクを実行する場所を指定します。チー ム内に複数の Runner がデプロイされている場合は、いずれかを選択できます。
通知: 通知を有効にすると、完了時にタスク結果を指定した受信者へ送信できます。毎回の実行後、または失敗時のみ通知をトリガーするように設定することで、不要なアラートを最小限に抑えられます。詳細については、通知設定を参照してください。 スケジュールされたタスクの実行#
スケジュールされたタスクが完了すると、その結果は Runner からサーバーへ自動的にアップロードされます。スケジュールされたタスクの詳細な結果はすべて、Apidog クライアント内の「Scheduled Tasks - Run History」で確認できます。スケジュールされたタスクでは通知を有効にすることをお勧めします。これにより、テストシナリオが完了した直後に通知メッセージを受信でき、結果を速やかに確認できます。
