SOAtest は OpenAPI/Swagger 定義に記述されたエンドポイントに基づいて .tst ファイルを自動生成します。OpenAPI/Swagger ウィザードで生成した .tst には、定義されたすべてのエンドポイントに対応する REST Client が作成されます。
以下の仕様をサポートします。
- Swagger 1.0 - 2.0。これらの仕様と互換性がある Swagger core バージョンもサポートされています (Swagger core 1.0.0、1.2.4、1.3.12、1.5.0-M1、1.5.0)。
- OpenAPI/Swagger 3.0。
この機能を使用するには、Java 7 以降が必要です (Mac では Java 8 以降)。
有効な OpenAPI/Swagger 定義からテスト スイートを作成するには、次の操作を行います。
- テスト ケース エクスプローラーで [新規追加] > [テスト (.tst)] を選択します。
- ファイル名を指定し、[次へ] をクリックします。
- [REST] > [OpenAPI/Swagger] オプションを選択し、[次へ] をクリックします。テスト作成ウィザードにアクセスする方法については、「既存プロジェクトへ新規 .tst ファイルを追加 」および「Adding a New Test Suite」を参照してください。
- OpenAPI/Swagger 定義を指す URI の絶対パスを入力するか、[参照] ボタンをクリックしてローカル システムのファイルを指定します。
- [次へ] をクリックします。[環境の作成] ダイアログが開きます。
- (任意) 既存の環境を参照するか、新しい環境を作成するかを指定します。
- 新しい環境を作成するには、次の操作を行います。
- [プロジェクトの新規環境を作成] チェックボックスをオンにします。
- [環境名] および [変数接頭辞] フィールドに入力します。
- 既存の環境を参照するには、[既存の環境の参照] をオンにし、適切な環境ファイルを指定します。
- 環境についての詳細は、「異なる環境でのテスト構成」を参照してください。
- 新しい環境を作成するには、次の操作を行います。
- [終了] ボタンをクリックします。
生成された .tst には、OpenAPI/Swagger 定義に記述されたリソース/メソッドのペアごとに 1 個の REST Client が作成されます。
- 各 REST Client は、指定されたサービス定義およびスキーマ (適用可能な場合) の制約を受けるよう設定されています。
- REST Client のリソース URL、HTTP メソッド、およびペイロード (適用可能な場合) も、定義に従って構成されています。
- サービスのベース URL は "BASEURL" 変数として構成されます。各 リソース URL は、"BASEURL" 変数を使ってパラメータライズされます。
- クエリー パラメーターは、サービス定義に従ったデフォルト値またはサンプル値 (利用可能な場合) と共に記録されます。
- サービス定義にスキーマが含まれている場合、サンプル ペイロードはスキーマから構築され、スキーマの制約を受けます。