プロジェクトをインポート

外部ソースからプロジェクトをインポートし、Test Manager を使用してテスト作業を実行できます。この機能を使用すると、テスト プロジェクト全体を異なるアプリケーション ライフサイクル管理 (ALM) システムから Test Manager に転送できます。

動作のしくみ

プロジェクトのインポートは、外部システムのプロジェクト (例: テスト アプリケーション) を Test Manager が読み取ることができる形式に変換するスキーマに従って行われます。これには、要件、テスト ケース、テスト セット、テスト結果、ラベル、カスタム フィールド、事前条件、事後条件、添付ファイルなどのオブジェクトが含まれます。インポート プロセスは非同期的に実行されます。

考慮事項

• Test Manager へのインポート中に新しいオブジェクト ID (GUID) が生成されます。
• タイムスタンプ (作成時刻、更新時刻) は保持されます。
• 作成者および更新者は、プロジェクトのインポート要求を送信したユーザーになります。ALM システムで成果物を作成した元のユーザーは保持されません。
• サイズ制限 (90 MB) を超えた添付ファイルはスキップされます。

プロジェクトをインポートできるユーザー

有効な Test Manager ライセンスを持つユーザーであれば、誰でもプロジェクトをインポートできます。

詳しくは、「ユーザーとグループのアクセス管理」をご覧ください。

スキーマのバージョンを取得する

TMH ファイルを構築するには、スキーマのバージョンが必要です。スキーマのバージョンを取得するには、Swagger で API 呼び出しを使用する必要があります。以下の手順で行います。

1. 現在使用している Test Manager エンドポイントを使用して Swagger に移動します。Swagger を Test Manager に接続するには、「 API リファレンス」をご覧ください。
2. ProjectMigrationSchema 要求に移動します。
3. GET /api/v2/migration/schema/versions を実行し、[Response Body] 内に生成されたバージョンをコピーします。
4. コピーしたスキーマ バージョンを GET/api/v2/migration/schema/{schemaVersion} のパラメーターとして入力し、API を実行します。
5. [Response Body] セクションから [Download file] を選択します。

Results: A ZIP file is downloaded, that has the schema of different testing artifacts in the TMH file.

The ZIP file contains the following folders and files:

• attachments フォルダー - 各オブジェクトに関連付けられた添付ファイルに対応するサブフォルダーが含まれています。オブジェクト ID がフォルダー名 (テスト ケース、テスト セット、要件、テスト実行など) です。

• An objects folder - contains subfolders corresponding to all types of objects available in Test Manager. * A JSON manifest file - holds basic metadata about your WebExtension. * A readme.txt file - contains instructions for preparing data that goes inside the folders.

TMH ファイルを準備する

インポートする TMH ファイルを準備する際は、ファイル サイズが 2 GB を超えないようにすることをお勧めします。ファイル サイズをこの制限内に抑えることにより、インポート プロセスが途中で中止されるのを避けられます。

各サブフォルダー内のサンプル スキーマに従って、JSON ファイルにインポートするすべてのオブジェクトを指定します。

例: テスト ケースを指定するには、以下のサンプル スキーマを使用します。

括弧で囲まれたデータは、自身のテスト ケースに対応するデータに変更します。

1. プロジェクトの各オブジェクトに対して JSON ファイルを作成したら、これらのファイルを objects フォルダー内の対応するサブフォルダーに追加します。JSON ファイルには好きな名前を付けることができますが、サブフォルダーの名前は変更できません。例: テスト ケースのデータを含む JSON ファイルを testcases サブフォルダーに追加します。
   重要:

   インポートするオブジェクトが大量にある場合は、testcases-1.json、testcases-2.json のように複数のファイルに分割します。サブフォルダーあたりの最大数である 500 個のファイルを追加することをお勧めします。

2. オブジェクトに関連付けられた添付ファイルを、フォルダー階層 /attachments/object-id/file name を使用して attachments フォルダーに追加します。
   • object-id - 関連付けられたオブジェクトの ID に置き換えます。
   • file name - 添付ファイルの名前に置き換えます。

プロジェクトをインポートできるユーザー

有効な Test Manager ライセンスを持つユーザーであれば、誰でもプロジェクトをインポートできます。

詳しくは、「ユーザーとグループのアクセス管理」をご覧ください。

Test Manager にプロジェクトをインポートする

エクスポートした TMH ファイルを準備してから、Test Manager でプロジェクトのインポートの詳細を確認します。

重要:

インポートする TMH ファイルを準備する際は、ファイル サイズが 2 GB を超えないようにすることをお勧めします。ファイル サイズをこの制限内に抑えることにより、インポート プロセスが途中で中止されるのを避けられます。

1. Test Manager にサインインします。
2. [プロジェクトをインポート] を選択します。
3. Add the TMH file. Project details are automatically fetched and listed in the Objects in project section so you can review before starting the import process. 3a. Review the Objects in project file. Under Objects in project file, check the data objects included in the project file. To include automation as part of your import, select the Include automation information for test cases check box. To include the project configuration as part of your import, select the Import project configuration check box.
4. (任意) プロジェクト名、プレフィックス、および説明を編集します。
5. 情報を確認し、[インポート] を選択してプロセスを開始します。
   注:

   プロジェクトのインポートには通常約 10 分から 15 分かかりますが、大規模なプロジェクトの場合はさらに時間がかかる場合があります。

インポートしたプロジェクトは [プロジェクト] ページに表示され、インポート プロセスが完了するまで灰色表示されます。

Test Manager の既存のプロジェクトにインポートする

TMH ファイルを既存の Test Manager プロジェクトにインポートして、要件、テスト ケース、テスト セットなどの外部テスト成果物をターゲット プロジェクトに結合します。

1. Test Manager にサインインします。
2. [プロジェクトをインポート] を選択します。
3. ダウンロードした TMH ファイルをここに追加します

Project details are automatically fetched and listed in the Objects in project file section so you can review before starting the import process. 3a. Review the Objects in project file. Under Objects in project file, check the data objects included in the project file.

To include automation as part of your import, select the Include automation information for test cases check box. To include the project configuration as part of your import, select the Import project configuration check box. 4. Select Existing project under Target. 5.

Select the target project, where the data is imported, from the Project dropdown. :::tip

• サイズが大きい TMH ファイルがある場合は、複数のファイルに分割して、同じターゲット プロジェクト内に別々にインポートできます。

• If you export multiple projects, you can import them back inside an existing project. :::

6. Review information and select Import to start the process. :::warning The Test Results field is always 0, because test results are not exported. :::

既存のプロジェクトのインポート プロセスが完了すると、このイベントに関する「プロジェクトのインポートが完了しました。」という通知が表示されます。

8. 通知を選択して新しいプロジェクトの 「添付ファイル 」タブに移動します。以下の内容を確認できます。

1. 移行手順のログ (ZIP ファイル)
2. 移行されたオブジェクトのログ (zip ファイル)
3. インポートの概要 (TXT ファイル) - エンティティの総数と、インポートまたはスキップされたエンティティの数を確認できます。

インポート後の手順

インポート後の手順

プロセスの完了後の通知として Test Manager に表示されるインポートのプロジェクト レポートを確認します。インポートの概要の PDF ファイルには、インポートしたオブジェクトのステータスが表示されます。インポートされていないオブジェクトは、オブジェクト移行ログの CSV ファイルで個別に調査できます。プロジェクトのインポートに失敗した場合は、 UiPath® のサポートにお問い合わせください。

オートメーションの情報を表示する

特定のテスト ケースを生成したオートメーションに関する情報を表示するには、以下の手順を実行します。

1. [プロジェクトをインポート] ページの下部にある [テスト ケースのオートメーションの情報を含める] を選択します。
2. インポートを完了し、インポートしたテスト ケースに automationcleared ラベル フィルターを適用して絞り込みます。
3. 返されたテスト ケースをそれぞれ開いて [詳細] タブに移動し、そのテスト ケースを生成したオートメーションに関する情報を取得します。

図 1.automationcleared ラベルが表示された [ラベル] ドロップダウン リスト

[詳細] タブに表示されるオートメーションの情報には以下が含まれます。

• オートメーション ID

• AutomationProjectName

• AutomationTestCaseName

  

「TMH ファイル形式の仕様」もご覧ください。

結果

プロジェクトが Test Manager にインポートされ、プロセスが完了すると [ プロジェクト ] ページに表示されます。「プロジェクトのインポートの完了」という通知でインポートが確認されます。