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

TMH ファイルを外部システムから Test Manager へ新規または既存のプロジェクトとしてインポートし、要件、テスト ケース、テスト セット、添付ファイルを移行します。

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

動作のしくみ

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

考慮事項

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

注:

プロジェクトを別のテナントにインポートした後、各テスト ケースのオートメーションのリンクを解除し、移行先テナントの Orchestrator 内の対応するオートメーションに再度リンクします。そうしないと、そのテスト ケースの自動実行は保留ステートでスタックしたままになります。

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

有効な 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] を選択します。

結果

ZIP ファイルがダウンロードされます。このファイルには、TMH ファイル内のさまざまなテスト成果物のスキーマが含まれています。

ZIP ファイルには、次のフォルダーとファイルが含まれています。

• attachments フォルダー - 各オブジェクトに関連付けられた添付ファイルに対応するサブフォルダーが含まれています。オブジェクト ID がフォルダー名 (テスト ケース、テスト セット、要件、テスト実行など) です。
• objects フォルダー - Test Manager で利用可能なすべての種類のオブジェクトに対応するサブフォルダーが含まれています。
• JSON マニフェスト ファイル - WebExtension に関する基本的なメタデータが含まれています。
• readme.txt ファイル - フォルダーに入れるデータを準備する手順が記載されています。

TMH ファイルを準備する

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

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

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

{
  "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"
    }
  ]
}

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

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 にプロジェクトをインポートする

プロジェクトをインポートすると、エクスポートした TMH ファイルから新しい Test Manager プロジェクトが作成されます。

重要:

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

手順

1. Test Manager にサインインします。
2. [プロジェクトをインポート] を選択します。
3. TMH ファイルを追加します。プロジェクトの詳細は自動的に取得され、[プロジェクト内のオブジェクト] セクションに表示されるため、インポート プロセスを開始する前に確認できます。
4. [ プロジェクト内のオブジェクト] セクションを確認し、プロジェクト ファイルに含まれるデータ オブジェクトを確認します。
5. (任意)インポートにオートメーションを含めるには、[ テスト ケースのオートメーションの情報を含める ] チェック ボックスをオンにします。
6. (任意)プロジェクトの設定をインポートの一部として含めるには、[ プロジェクトの設定をインポート ] チェック ボックスをオンにします。
7. (任意) プロジェクト名、プレフィックス、および説明を編集します。
8. 情報を確認し、[インポート] を選択してプロセスを開始します。
   注:

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

9. プロセスの完了後の通知として Test Manager に表示されるインポートのプロジェクト レポートを確認します。インポートの概要の PDF ファイルには、インポートしたオブジェクトのステータスが表示されます。インポートされていないオブジェクトは、オブジェクト移行ログの CSV ファイルで個別に調査できます。
   注:

   プロジェクトのインポートに失敗した場合は、 UiPath® サポートにお問い合わせください。

結果

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

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

既存のプロジェクトにインポートすると、TMH ファイルの要件、テスト ケース、テスト セット、その他の成果物が対象のプロジェクトにマージされます。

手順

1. Test Manager にサインインします。

2. [プロジェクトをインポート] を選択します。

3. こちらからダウンロードした TMH ファイルを追加します。 プロジェクトの詳細は自動的に取得され、[プロジェクト ファイル内のオブジェクト] セクションに表示されるため、インポート プロセスを開始する前に確認できます。

4. [ プロジェクト ファイル内のオブジェクト] セクションを確認し、プロジェクト ファイルに含まれるデータ オブジェクトを確認します。

5. (任意)インポートにオートメーションを含めるには、[ テスト ケースのオートメーションの情報を含める ] チェック ボックスをオンにします。

6. (任意)プロジェクトの設定をインポートの一部として含めるには、[ プロジェクトの設定をインポート ] チェック ボックスをオンにします。

7. [ターゲット] の下にある [既存のプロジェクト] を選択します。

8. [プロジェクト] ドロップダウンから、データのインポート先のプロジェクトを選択します。

   ヒント:

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

9. 情報を確認し、[インポート] を選択してプロセスを開始します。

   警告:

   テスト結果はエクスポートされないため、[ テスト結果 ] フィールドは常に 0されます。

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

    

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

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

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

    注:

    プロジェクトのインポートに失敗した場合は、 UiPath® サポートにお問い合わせください。

結果

TMH ファイルのデータが選択したプロジェクトにインポートされ、「 プロジェクトのインポートが完了しました」 という通知でインポートが確定されます。

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

インポートにオートメーションの情報を含めていれば、インポートしたテスト ケースの [ 詳細 ] タブに、そのテスト ケースを生成したオートメーションが表示されます。

手順

1. [プロジェクトをインポート] ページの下部にある [テスト ケースのオートメーションの情報を含める] を選択します。

2. インポートを完了し、インポートしたテスト ケースに automationcleared ラベル フィルターを適用して絞り込みます。

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

   

3. 返されたテスト ケースをそれぞれ開いて [詳細] タブに移動し、そのテスト ケースを生成したオートメーションに関する情報を取得します。

結果

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

• オートメーション ID
• AutomationProjectName
• AutomationTestCaseName

関連記事

• TMH ファイル形式の仕様