テストシナリオを実行する

:::highlight purple
テストレポートについてもっと学ぶ。
:::

テストシナリオでの実行オプション

Apidogでテストシナリオを実行する際、特定の要件に合わせてテスト実行をカスタマイズするための設定とオプションをいくつか構成できます。

以下では、これらの設定の重要な側面を探ります：

環境

シナリオ内のリクエストが向けられるサービス（基本URL）と使用する変数セットを指定します。環境とサービスで詳細を確認してください。

カスタムリクエストは独自の完全なURLを持ち、このコンテキストで設定された環境には向けられません。インポートされたステップとは異なります。

テストデータ

テストシナリオは外部のテストデータセットのインポートをサポートしています。テストシナリオが実行されると、システムはデータファイル内のすべてのデータセットをループし、データセット内のデータを対応する変数に割り当てます。データ駆動型テストを参照してください。

イテレーション

シナリオ内のすべてのステップがループで実行される回数を設定します。

処理するデータが多い場合は、ApidogクライアントではなくApidog CLIを使用して実行することをお勧めします。

スレッド

データがスレッド間で分離されて干渉を防ぐために、すべてのステップを複数のスレッドで実行します。

この機能はベータ版であり、さらなるパフォーマンス最適化が必要な場合があります。厳密な負荷テストには、パフォーマンステスト機能を使用することをお勧めします。CLIではスレッドはサポートされていません。

実行先

テストシナリオを実行するために実際にハードウェアリソースを消費するマシンです。テストシナリオで開始されたすべてのリクエストは、ここで指定されたマシンから送信されます。したがって、リクエストマシンのネットワーク環境の違いがテスト結果の変動を引き起こす可能性があります。

:::note
この設定はテストシナリオの実行構成の一部として保存されません。毎回、デフォルトでローカルマシンがテストシナリオを実行するために使用されます。また、この設定はバッチ実行やCLI実行中には有効になりません。これらの場合、リクエストは現在のマシンのリソースを使用して開始されます。
:::

テストシナリオを実行するマシンを指定する際、テストシナリオにファイル（ファイル送信、データベース接続、外部プログラム、SSL証明書など）が含まれる場合、必要なすべてのファイルが指定されたマシンにローカルに保存されている必要があります。

通知

この機能を有効にすると、手動のテストシナリオが完了した後に指定された受信者に通知が送信されます。通知にはテスト結果の概要と詳細レポートへのリンクが含まれます。テストが終了するとすぐに通知を送信するか、失敗が発生した場合にのみ通知を送信するかを設定できます。これにより、不要なアラートを最小限に抑えることができます。通知設定で詳細情報を確認してください。

共有

Advanced Settingsの右側にある「共有」オプションを有効にすると、各テストシナリオ実行後に生成されたテストレポートがプロジェクトの他のメンバーと自動的に共有されます。Test ReportsセクションのSharedタブでチーム内で共有されたすべてのテストレポートを表示できます。テストレポートで詳細を確認してください。

現在のテストシナリオに他のプロジェクトからインポートされたエンドポイントを含むステップがある場合、このガイドを参照してください：他のプロジェクトのAPIの実行環境を管理する

高度な設定

エラー時の動作

テストがエラーをどのように処理するかを設定します。これには、アサーションの失敗、データ形式の検証の失敗、サーバーエラーなどが含まれます。オプションは次のとおりです：

• 無視: エラーが発生した場合、次のステップを続行します（デフォルト設定）。
• 続行: エラーが発生した場合、現在のイテレーションを終了し、次のイテレーションを開始します。
• 実行終了: エラーが発生した場合、全体の実行を停止します。

遅延

各ステップの送信間に一時停止を設定して、実行速度を管理および制御します。

リクエスト/レスポンスの保存

デフォルトでは、Apidogはすべてのリクエストとレスポンスを保存します。リクエストやレスポンスが非常に大きい場合（数MBになる可能性があります）、かなりのディスクスペースを占有する可能性があります。このオプションを有効にして、すべてのリクエストとレスポンスを保存せず、アサーションと検証結果のみを保存することができます。

または、スペースを節約するために失敗したリクエストとレスポンスのみを保存することもできます。

変数値の保持

このオプションはデフォルトで有効になっており、テスト中に変更された場合、グローバルおよび環境変数の現在の値が最後に変更された結果を保持します。このオプションを無効にすると、グローバルおよび環境変数はテスト実行後に変更されず、実行前の値を保持します。

ローカル変数はこの設定の影響を受けず、各実行後にクリアされます。

保存されたクッキーで実行

Apidogの右下隅にあるクッキーアイコンは、クッキー管理にアクセスします。ApidogはAPIリクエストを行う際に自動的にクッキーを保存します。テストシナリオ実行中に保存されたクッキーを使用したい場合は、このオプションを有効にします。

実行後にクッキーを保存

上記と同様に、テストシナリオを実行した後に保存されたクッキーを更新したい場合は、このオプションを有効にします。

Apidogでこれらの高度な設定を構成することで、特定のテストニーズに合わせてテスト実行を微調整し、効率的で正確なテスト実行を確保できます。

テストシナリオ設計モードでのランタイム設定

テストシナリオ設計モードにいる場合、関連するランタイム構成は「実行」ボタンの右側に折りたたまれています。この設定ボタンにマウスをホバーすると、このテストシナリオの詳細なランタイム構成が表示されます。

機能テストの実行

機能テストを実行した後、テストシナリオ実行ページに移動します。以下の画像の円グラフは、テストシナリオの実行中にリアルタイムで更新されるテスト結果の概要を提供します。円グラフの下には、実行中の各ステップのステータスが表示される詳細なテストステップが表示されます。

機能テストの実行が完了すると、関連するエンドポイントをクリックして、テスト中のメトリクスとステータスを表示できます。これには、エンドポイント名、リクエストメソッド、リクエストURL、レスポンスステータスコード、レスポンスタイム、レスポンスコンテンツ、データ検証、およびアサーション結果が含まれます。詳細については、テストレポートを参照してください。

異なる実行方法での環境/グローバル変数の使用ルール

環境およびグローバル変数は永続的であり、複数の実行や異なるテストシナリオにわたって長期間使用するために保存できます。ただし、選択した実行方法によって使用される実際の変数値が異なる場合があります。例えば：

テストシナリオが環境変数Tokenを使用する場合、クライアント内で実行すると正常に動作するかもしれませんが、セルフホストランナーを使用して実行するとTokenの値が正しくないために失敗する可能性があります。

この不一致は、実行中に環境変数Tokenの実際の値がクライアント内にローカルに保存された値から取得されるために発生する可能性があります。ただし、セルフホストランナーで実行する場合、ランナーには同じローカルに保存されたTokenがないため、失敗します。

この問題に対処するために、Apidogは異なる実行方法にわたって環境/グローバル変数の値を管理するための一連のルールを提供しています：

他のプロジェクトからのエンドポイントを含むテストシナリオの実行

テストシナリオに他のプロジェクトからインポートされたエンドポイントが含まれる場合、実行中のこれらのエンドポイントのリクエストURLは環境関連付けで設定した構成によって決定されます。

例えば：

現在のプロジェクトの「開発環境」が他のプロジェクトの「本番環境」と関連付けられている場合、「開発環境」を使用してテストシナリオを実行すると、インポートされたエンドポイントは「本番環境」からのURLに送信されます。他のすべてのエンドポイントは、現在のプロジェクトの「開発環境」からのURLを使用します。

様々なテストの実施

ここで説明したステップは、テストシナリオの基本的な実行を表しています。テストシナリオを設定する際、さまざまな高度な設定を組み込んで、多様なテスト要件を満たすことができます。

• データ駆動テスト: 多様なデータセットを使用してテストを実施し、さまざまなシナリオでのシステムの動作を検証します。
• パフォーマンステスト: さまざまな負荷条件下でシステムのパフォーマンスを評価し、スケーラビリティと応答性を評価します。
• スケジュールされたタスク: テスト活動の範囲、アプローチ、タイミングを詳細に計画します。
• CI/CD統合: ビルド、テスト、デプロイメントプロセスを自動化し、信頼性の高い頻繁なソフトウェアリリースを確保します。