- 基本情報
- Studio
- Orchestrator
- Testing ロボット
- Test Manager
- CI/CD との連携
プロジェクトをインポートする
外部ソースからプロジェクトをインポートし、Test Manager を使用してテスト作業を実行できます。この機能を使用すると、テスト プロジェクト全体を異なるアプリケーション ライフサイクル管理 (ALM) システムから Test Manager に転送できます。
プロジェクトのインポートは、外部システムのプロジェクト (例: テスト アプリケーション) を Test Manager が読み取ることができる形式に変換するスキーマに従って行われます。これには、要件、テスト ケース、テスト セット、テスト結果、ラベル、カスタム フィールド、添付ファイルなどのオブジェクトが含まれます。インポート プロセスは非同期的に実行されます。
- Test Manager へのインポート中に新しいオブジェクト ID (GUID) が生成されます。
- タイムスタンプ (作成時刻、更新時刻) は保持されます。
- 作成者および更新者は、プロジェクトのインポート要求を送信したユーザーになります。ALM システムで成果物を作成した元のユーザーは保持されません。
- サイズ制限 (90 MB) を超えた添付ファイルはスキップされます。
有効な Test Manager ライセンスを持つユーザーであれば、誰でもプロジェクトをインポートできます。
詳しくは、「ユーザーとグループのアクセス管理」をご覧ください。
TMH ファイルを構築するには、スキーマのバージョンが必要です。スキーマのバージョンを取得するには、Swagger で API 呼び出しを使用する必要があります。以下の手順で行います。
- 現在使用している Test Manager エンドポイントを使用して Swagger に移動します。Swagger を Test Manager に接続するには、「API リファレンス」をご覧ください。
- ProjectMigrationSchema 要求に移動します。
- GET /api/v2/migration/schema/versions を実行し、[Response Body] 内に生成されたバージョンをコピーします。
- コピーしたスキーマ バージョンを GET/api/v2/migration/schema/{schemaVersion} のパラメーターとして入力し、API を実行します。
- [Response Body] セクションから [Download file] を選択します。
結果: Zip ファイルがダウンロードされます。このファイルには、TMH ファイルのさまざまなテスト成果物のスキーマが含まれています。ZIP ファイルには、次のフォルダーとファイルが含まれています。
- attachments フォルダー - 各オブジェクトに関連付けられた添付ファイルに対応するサブフォルダーが含まれています。オブジェクト ID がフォルダー名 (テスト ケース、テスト セット、要件、テスト実行など) です。
- objects フォルダー - Test Manager で利用可能なすべての種類のオブジェクトに対応するサブフォルダーが含まれています。
- JSON マニフェスト ファイル - WebExtension に関する基本的なメタデータが含まれています。
- readme.txt ファイル - フォルダーに入れるデータを準備する手順が記載されています。
例: テスト ケースを指定するには、以下のサンプル スキーマを使用します。
{
"testCases": [
{
"id": "string (100)",
"version": "string (100)",
"name": "string (100)",
"inputParams": "string",
"description": "string",
"automationId": "string (100)",
"automationTestCaseName": "string (100)",
"automationProjectName": "string (100)",
"foreignRef": "string",
"connectorTestCaseId": "string",
}
]
}{
"testCases": [
{
"id": "string (100)",
"version": "string (100)",
"name": "string (100)",
"inputParams": "string",
"description": "string",
"automationId": "string (100)",
"automationTestCaseName": "string (100)",
"automationProjectName": "string (100)",
"foreignRef": "string",
"connectorTestCaseId": "string",
}
]
}括弧で囲まれたデータは、自身のテスト ケースに対応するデータに変更します。
-
プロジェクトの各オブジェクトに対して JSON ファイルを作成したら、これらのファイルを objects フォルダー内の対応するサブフォルダーに追加します。JSON ファイルには好きな名前を付けることができますが、サブフォルダーの名前は変更できません。
例: テスト ケースのデータを含む JSON ファイルを testcases サブフォルダーに追加します。
重要: インポートするオブジェクトが大量にある場合は、testcases-1.json、testcases-2.jsonのように複数のファイルに分割します。サブフォルダーあたりの最大数である 500 個のファイルを追加することをお勧めします。 -
オブジェクトに関連付けられた添付ファイルを、フォルダー階層
/attachments/object-id/file nameを使用して attachments フォルダーに追加します。object-id- 関連付けられたオブジェクトの ID に置き換えます。file name- 添付ファイルの名前に置き換えます。
有効な Test Manager ライセンスを持つユーザーであれば、誰でもプロジェクトをインポートできます。
詳しくは、「ユーザーとグループのアクセス管理」をご覧ください。
インポートしたプロジェクトは [プロジェクト] ページに表示され、インポート プロセスが完了するまで灰色表示されます。
インポート後の手順
プロセスの完了後の通知として Test Manager に表示されるインポートのプロジェクト レポートを確認します。インポートの概要の PDF ファイルには、インポートしたオブジェクトのステータスが表示されます。インポートされていないオブジェクトは、オブジェクト移行ログの CSV ファイルで個別に調査できます。プロジェクトのインポートに失敗した場合は、UiPath のサポートにお問い合わせください。
