テストシナリオを構築したら、それを実行してテストレポートを生成できます。適切な実行方法の選択#
Apidogは、異なるテスト要件に応じた複数のテストシナリオ実行方法を提供しています。この方法はローカルマシンから開始され、小規模で迅速なテストに適してい ます。開発とテストが同時に行われる場合に特に効果的で、リアルタイムでの監視と即時調整が可能です。大規模なデータや反復シナリオを処理するのに理想的で、実行速度が向上します。オフラインでの実行が可能で、リソースが制限された環境やグラフィカルユーザーインターフェースを必要としない環境に適しています。この実行スタイルはCI/CDパイプラインに統合されており、自動化された統合と継続的デプロイメントプロセスに最適です。特に、コードの更新後にAPIの安定性を確認するために頻繁にテストが実行される設定で役立ちます。チームは自分たちのサーバーにApidogランナーをセットアップし、より強力なコンピューティングリソースを活用してテストを行うことができます。この方法はスケジュールされたタスクのサポートを含んでおり、定期的なテストが必要なシナリオや大規模なテスト要求があるシナリオに理想的です。テストシナリオでは、環境/グローバル変数が使用される場合、選択した実行方法によってこれらの変数の実際の値が異なる可能性があり、一貫性のないテスト結果を引き起こすことがあります。詳細はこちら。 始め方#
1
希望するテストシナリオに移動し、リクエストを実行したい環境を選択します。
3
現在の実行に関する合格率、実行時間、その他のデータを表示するテストレポートが表示されます。各リクエストを展開して、検証とアサーションを確認できます。
4
「詳細」をクリックして、実際のリクエストとレスポンスの詳細を確認します。
テストシナリオでの実行オプション#
Apidogでテストシナリオを実行する際、特定の要件に合わせてテスト実行をカスタマイズするための設定とオプションをいくつか構成できます。シナリオ内のリクエストが向けら れるサービス（基本URL）と使用する変数セットを指定します。環境とサービスで詳細を確認してください。カスタムリクエストは独自の完全なURLを持ち、このコンテキストで設定された環境には向けられません。インポートされたステップとは異なります。テストデータ#
テストシナリオは外部のテストデータセットのインポートをサポートしています。テストシナリオが実行されると、システムはデータファイル内のすべてのデータセットをループし、データセット内のデータを対応する変数に割り当てます。データ駆動型テストを参照してください。イテレーション#
シナリオ内のすべてのステップがループで実行される回数を設定します。処理するデータが多い場合は、ApidogクライアントではなくApidog CLIを使用して実行することをお勧めします。スレッド#
データがスレッド間で分離されて干渉を防ぐために、すべてのステップを複数のスレッドで実行します。この機能はベータ版であり、さらなるパフォーマンス最適化が必要な場合があります。厳密な負荷テストには、パフォーマンステスト機能を使用することをお勧めします。CLIではスレッドはサポートされていません。実行先#
テストシナリオを実行するために実際にハードウェアリソースを消費するマシンです。テストシナリオで開始されたすべてのリクエストは、ここで指定されたマシンから送信されます。したがって、リクエストマシンのネットワーク環境の違いがテスト結果の変動を引き起こす可能性があります。この設定はテストシナリオの実行構成の一部として保存されません。毎回、デフォルトでローカルマシンがテストシナリオを実行するために使用されます。また、この設定はバッチ実行やCLI実行中には有効になりません。これらの場合、リクエストは現在のマシンのリソースを使用して開始されます。
Advanced Settingsの右側にある「共有」オプションを有効にすると、各テストシナリオ実行後に生成されたテストレポートがプロジェクトの他のメンバーと自動的に共有されます。Test ReportsセクションのSharedタブでチーム内で共有されたすべてのテストレポートを表示できます。テストレポートで詳細を確認してください。高度な設定#
エラー時の動作#
テストがエラーをどのように処理するかを設定します。これには、アサーションの失敗、データ形式の検証の失敗、サーバーエラーなどが含まれます。オプションは次のとおりです：無視: エラーが発生した場合、次のステップを続行します（デフォルト設定）。
続行: エラーが発生した場合、現在のイテレーションを終了し、次のイテレーションを開始します。
実行終了: エラーが発生した場合、全体の実行を停止します。
リクエスト/レスポンスの保存#
デフォルトでは、Apidogはすべてのリクエストとレスポンスを保存します。リクエストやレスポンスが非常に大きい場合（数MBになる可能性があります）、かなりのディスクスペースを占有する可能性があります。このオプションを有効にして、すべてのリクエストとレスポンスを保存せず、アサーションと検証結果のみを保存することができます。または、スペースを節約するために失敗したリクエストとレスポンスのみを保存することもできます 。変数値の保持#
このオプションはデフォルトで有効になっており、テスト中に変更された場合、グローバルおよび環境変数の現在の値が最後に変更された結果を保持します。このオプションを無効にすると、グローバルおよび環境変数はテスト実行後に変更されず、実行前の値を保持します。ローカル変数はこの設定の影響を受けず、各実行後にクリアされます。保存されたクッキーで実行#
Apidogの右下隅にあるクッキーアイコンは、クッキー管理にアクセスします。ApidogはAPIリクエストを行う際に自動的にクッキーを保存します。テストシナリオ実行中に保存されたクッキーを使用したい場合は、このオプションを有効にします。実行後にクッキーを保存#
上記と同様に、テストシナリオを実行した後に保存されたクッキーを更新したい場合は、このオプションを有効にします。Apidogでこれらの高度な設定を構成することで、特定のテストニーズに合わせてテスト実行を微調整し、効率的で正確なテスト実行 を確保できます。テストシナリオ設計モードでのランタイム設定#
テストシナリオ設計モードにいる場合、関連するランタイム構成は「実行」ボタンの右側に折りたたまれています。この設定ボタンにマウスをホバーすると、このテストシナリオの詳細なランタイム構成が表示されます。機能テストの実行#
機能テストを実行した後、テストシナリオ実行ページに移動します。以下の画像の円グラフは、テストシナリオの実行中にリアルタイムで更新されるテスト結果の概要を提供します。円グラフの下には、実行中の各ステップのステータスが表示される詳細な テストステップが表示されます。機能テストの実行が完了すると、関連するエンドポイントをクリックして、テスト中のメトリクスとステータスを表示できます。これには、エンドポイント名、リクエストメソッド、リクエストURL、レスポンスステータスコード、レスポンスタイム、レスポンスコンテンツ、データ検証、およびアサーション結果が含まれます。詳細については、テストレポートを参照してください。異なる実行方法での環境/グローバル変数の使用ルール#
環境およびグローバル変数は永続的であり、複数の実 行や異なるテストシナリオにわたって長期間使用するために保存できます。ただし、選択した実行方法によって使用される実際の変数値が異なる場合があります。例えば：テストシナリオが環境変数Tokenを使用する場合、クライアント内で実行すると正常に動作するかもしれませんが、セルフホストランナーを使用して実行するとTokenの値が正しくないために失敗する可能性があります。この不一致は、実行中に環境変数Tokenの実際の値がクライアント内にローカルに保存された値から取得されるために発生する可能性があります。ただし、セルフホストランナーで実行する場合、ランナーには同じローカルに保存されたTokenがないため、失敗します。この問題に対処するために、Apidogは異なる実行方法にわたって環境/グローバル変数の値を管理するための一連のルールを提供しています：| 実行方法 | 環境/グローバル変数の使用 | 変数の保存場所 |
|---|
| ローカル（クライアント、Web） | 環境/グローバル変数の現在の値を使用して実行します。 | ローカルに保存されます 。手動で変更または前/後処理を通じて更新できます。環境管理 > 環境/グローバル変数 > 現在の値で表示されます。 |
| CLI、CI/CD | リアルタイムオンライン実行の場合：- 環境/グローバル変数の初期値を使用して実行します （デフォルト）。
- テストシナリオを実行するマシン上のファイルに保存された環境/グローバル変数の値を使用するように
--variables pathオプションを指定します。詳細はこちら。
- エクスポートされたファイルに含まれる環境/グローバル変数の値を使用して実行します。
| - 初期値はApidog Cloudに保存され、クライアント内で手動での み変更できます。
--variables pathオプションで指定されたファイルに保存され、手動で変更または前/後処理を通じて更新できます。- エクスポートされたファイルに保存されます。手動で変更または前/後処理を通じて更新できます。
|
| セルフホストランナー | - 環境/グローバル変数の初期値を使用して実行します （デフォルト）。
- ランナー内にローカルに保存された値を使用して実行します。詳細はこちら。
| - 初期値はApidog Cloudに保存され、クライアント内で手動でのみ変更できます。
- 指定されたランナー内に保存されます。手動で変更または前/後処理を通じて更新できます。製品のユーザーインターフェースまたはランナー内の
/opt/runner/variablesファイルで表示されます。
|
他のプロジェクトからのエンドポイントを含むテストシナリオの実行#
テストシナリオに他のプロジェクトからインポートされたエンドポイントが含まれる場合、実行中のこれらのエンドポイントのリクエストURLは環境関連付けで設定した構成によって決定されます。現在のプロジェクトの「開発環境」が他のプロジェクトの「本番環境」と関連付けられている場合、「開発環境」を使用してテストシナリオを実行すると、インポートされたエンドポイントは「本番環境」からのURLに送信されます。他のすべてのエンドポイントは、現在のプロジェクトの「開発環境」からのURLを使用します。様々なテストの実施#
ここで説明したステップは、テストシナリオの基本的な実行を表しています。テストシナリオを設定する際、さまざまな高度な設定を組み込んで、多様なテスト要件を満たすことができます。データ駆動テスト: 多様なデータセットを使用してテストを実施し、さまざまなシナリオでのシステムの動作を検証します。 パフォーマンステスト: さまざまな負荷条件下でシステムのパフォーマンスを評価し、スケーラビリティと応答性を評価します。 CI/CD統合: ビルド、テスト、デプロイメントプロセスを自動化し、信頼性の高い頻繁なソフトウェアリリースを確保します。 
