API テスト オートメーション

Studio では「新しいサービス」ウィザードによる API テスト オートメーションがサポートされており、Swagger などのさまざまな API 形式で API の定義をインポートしてテストすることができます。Studio の API テスト オートメーション機能を使用すると、さまざまなサービスにわたって、自動化されたテストを構築、管理、実行できます。

インポート後は、テスト オートメーション プロジェクトでサービスの定義を使用して、エンドポイント、応答、動作を検証できます。また、サービス ライブラリを .nupkg パッケージとしてローカルまたは Orchestrator にパブリッシュして、テスト ワークフローで依存関係として再利用することもできます。

Studio also supports Postman as an additional option for importing API collections. To import a collection, generate an API key in your Postman account and use it in the New Service wizard. Studio integrates with Newman, the command line runner of Postman, so you can validate collections directly from the command line. For more details on the Postman requirements, visit Postman collections.

Postman を使用した API テストの例

以下の例では、Postman で定義したデータ コレクションを使用します。Studio のライブラリにデータ コレクションをインポートし、そのライブラリをコレクションとともにパブリッシュしてからテスト プロジェクトにインストールして、UiPath.Testing.Activities パッケージのテスト アクティビティの部分を使用してデータの使用状況を検証します。

テスト ケースは銀行の顧客向けに設計されたもので、自動的にローンへの申し込みを行うとともに、ローンに関するデータを取得するワークフローで使用します。

To check Postman and Newman installation prerequisites read this page.

データ コレクションを定義する

Postman では、データ コレクションを定義するか、既存のコレクションを現在のワークスペースにインポートします。この例では、ローンへの申し込み、ローンに関する詳細の取得と削除に関するデータ コレクションを作成しました。このコレクションを API テスト プロジェクトで使用することで、今回のワークフローの論理が適切かどうかを確認できます。

コレクションをインポートする

Studio にコレクションをインポートするには、ライブラリ プロジェクトを作成し、[新しいサービス] ウィンドウを使用します。コレクションへのアクセスは、Postman の API キーによって許可されます。このキーを [ファイルまたはリンク] フィールドに入力して、[読み込み] をクリックします。

プロジェクトへの読み込みが必要なエンドポイントだけを選択し、必要に応じて新しい [名前空間] を追加します。

[リンクされたコレクション] ボックスをチェックし、実行時に、コレクションのローカルに保存されたバージョンではなく、リンクを使用して最新のバージョンが実行されるようにします。完了したら [保存] をクリックします。

データ コレクションを使用する

Studio のライブラリへのコレクションのインポートが完了すると、エンドポイントが自動的にアクティビティに変換され、[アクティビティ] タブの、あらかじめ設定した名前空間の下に表示されます。

この例では、エンドポイントから生成されたアクティビティごとに、別々のシーケンス ファイルを作成しました。

アクティビティの追加後、[プロパティ] パネルに Postman 環境を追加します (二重引用符 "" で囲みます)。

Postman コレクションに定義したデータ値が、引数としてインポートされます。

ライブラリは、ローカルまたは Orchestrator で .nupkg パッケージとしてパブリッシュできます。

API テスト プロジェクトにライブラリを読み込む

1. プロジェクトの種類としてテスト オートメーションを使用して、Studio 内でテスト プロジェクトを作成します。

   

2. Install the published library as a dependency using the Manage Packages window.

   

3. ライブラリで先ほど定義したシーケンス ファイルが、ライブラリの名前空間により [アクティビティ] パネルで使用できるようになります。これとともに Postman のインポートから生成されたアクティビティも使用可能になります。

   

4. これらのアクティビティを、UiPath.Testing.Activities パッケージのアクティビティ部分と組み合わせて、API テスト オートメーション プロジェクトで使用します。このデモ アプリケーションでは、ローンを申し込む際に入力したデータを検証するテスト プロジェクトを作成しました。この小さなテストでは、一連のハードコードされた変数を使用しています。それらは、下記の [プロパティ] パネルで確認できます。

   

   この簡単なテスト プロセスは、アプリケーションが適切に応答するかを確認するスモーク テストとして使用されました。Studio では、自動化のニーズに合わせて、このようなテストをいくつか作成できます。

5. To verify several scenarios in one test project, go to the ribbon, New > Data Driven Test Case. Import the data set, as explained here. Below is an example of such a test case. The values are now stored into arguments, mapped in the activity.

   

6. [ファイルを実行する] または [データ バリエーションを使用してファイルをデバッグ] を選択し、使用するデータを選択します。これは、複数のデータ セットを使用して、いくつかのシナリオをテストするときに便利です。

   

7. プロセスの実行後、結果は [出力] パネルに表示されます。