オートメーションを選択する

推奨される直接選択メソッドを使用して、Orchestrator がパブリッシュしたオートメーションを Test Manager のテスト ケースにリンクします。

To link automations with test cases, select an automation published to Orchestrator. Selecting an Orchestrator automation directly in Test Manager is the recommended method to connect an automation to a test case.

Orchestrator automations include packages published by the tm pack command of the UiPath Command Line Interface (CLI) from Playwright projects, not only packages published from Studio — refer to Playwright test automation. Test Manager falls back to automations linked from Studio if you have not selected an Orchestrator automation.

また、テスト ケースに Studio のオートメーションのみがリンクされていて、Orchestrator のオートメーションがリンクされていない場合、Test Manager は Orchestrator で同等のオートメーションを見つけて実行しようとします。

注:

Test Manager のテスト ケースが Studio と Orchestrator の両方からオートメーションにリンクされている場合、Studio からリンクされているオートメーションよりも、Orchestrator から選択したオートメーションが優先されます。

前提条件

注:

オートメーションを Test Manager で直接選択する場合、[ レガシの実行コンテキストを許可 ] 設定が有効化されていると (たとえば、プロジェクト レベルまたはテスト セット レベルで実行フォルダーが選択されていないと)、選択したオートメーションが考慮されません。そのため、オートメーションを Test Manager で直接選択する場合は、[ レガシの実行コンテキストを許可 ] のテナント設定を無効化することをお勧めします。

Orchestrator からオートメーションを選択するには、必ず次の手順を実行します。

• Studio プロジェクトをテナントのパッケージ フィードまたは別の Orchestrator フォルダー フィードにパブリッシュします。
• For a Playwright package, package the project with the UiPath CLI instead — refer to Packaging Playwright projects for Test Manager. The same Orchestrator folder role and permission prerequisites apply identically to Playwright packages.
• 次のいずれかのロールを自分に割り当てます。
  • Orchestrator のフォルダー ロール Automation User
  • 管理者権限を持つ任意の既定のロール
  ヒント:

  ユーザーが Test Manager で直接オートメーションを選択するには、まずテスト ケースを編集するための権限が必要です。このコンテキストで役立つその他の権限として、 Automation User ロール、または管理者権限を持つ任意のロールがあります。

既定のテナント ロールについて詳しくは、テナントの既定のロールをご覧ください。

手順

テスト ケースのオートメーションを選択するには、以下の手順に従います。

1. プロジェクトの [テスト ケース] セクションに移動します。
2. テスト ケースを開きます。
3. [オートメーション] タブを選択します。
4. [ オートメーションを設定] を選択します。右側に [ オートメーションを設定 ] メニューが開きます。
   1. [パッケージ ソース] ドロップダウン リストから、対応する Orchestrator インスタンスのフィードを選択します。 このフィードには、Test Manager のテスト ケースにリンクする Studio のテスト ケースが含まれている必要があります。既定では [テナントのパッケージ フィード] が選択されています。 [パッケージ ソース] ドロップダウン リストには、専用のフィードを持つフォルダーのみが表示されます。フォルダー階層がある場合は、親フォルダーのみがドロップダウン リストに表示されます。これは、すべてのサブフォルダーで同じフィードが共有されるためです。
      注:

      利用可能なパッケージ フィードのオプションは、自身が管理者権限を持っているフィードのオプションです。

   2. パッケージ フィードを選択したら、その場所からオートメーションを選択できます。

オートメーション名が [テスト ケース名] 列に表示され、パブリッシュされたパッケージ名が [パッケージ] 列に表示されます。

注:

[テスト ケース名] 列には、オートメーションのパブリッシュ先の Orchestrator フォルダーと、その後にオートメーション名が表示されます。たとえば、Studio から Orchestrator の Accounts フォルダーにパブリッシュされたCreate Checking Accountテスト ケースを選択する場合、このオートメーションのテスト ケース名は Accounts/Create Checking Accountになります。

5. [保存] を選択して、変更を確定します。

Automations display a Source value of Playwright or UiPath in the picker, sorted by last-updated timestamp. For a Playwright automation, the Test Case Name column shows the full spec file path, followed by the describe-chain and test title (for example, tests/checkout.spec.ts > Checkout > cancelling the information step returns...), capped at 255 characters — refer to Playwright test case fields.

Playwright projects for test sets

When adding packages to a test set (Configure Automation > Add Packages), a Playwright package exposes a Playwright Projects dropdown listing the Playwright projects defined in that package's playwright.config.ts. Selecting one or more projects scopes the test set's execution to only the tests belonging to those projects, instead of running every test case in the set.

Because the dropdown is populated from the specific package added to the test set, the list of available projects is scoped to that package at that version:

• Adding a newer version of the same package as its own entry surfaces that version's project list, rather than merging with an older version's selection.
• Switching the version in the panel refreshes the available-projects list to that version's.
• Each execution freezes the package, version, and selected projects into a snapshot at creation time — re-executions replay that exact selection even if the test set is edited afterward.

Orchestrator パッケージ フィードからオートメーションを選択すると、[割り当てられたオートメーション:] の以下のフィールドでオートメーションの詳細を確認できます。

• パッケージのテスト ケース名: オートメーションのパブリッシュ先の Orchestrator フォルダーの後にオートメーション名が付いた名前です ( FolderName/TestCaseName)。

• パッケージ名: 選択したオートメーションのパブリッシュに使用されたパッケージの名前です。* パッケージ ソース: パッケージをパブリッシュした Orchestrator フィードです。

オートメーションを更新する

Orchestrator フィードから選択したオートメーションを更新するには、以下の手順に従います。

1. プロジェクトの [テスト ケース] セクションに移動します。
2. テスト ケースを開きます。
3. [オートメーション] タブを選択します。
4. [オートメーションを更新] を選択します。 右側に [オートメーションを設定] メニューが開きます。
   1. [パッケージ ソース] ドロップダウン リストから、対応する Orchestrator インスタンスのフィードを選択します。 このフィードは、Test Manager のテスト ケースにリンクする Studio のテスト ケースが含まれるフィードです。 既定では [テナントのパッケージ フィード] が選択されています。
      注:

      利用可能なパッケージ フィードのオプションは、自身が管理者権限を持っているフィードのオプションです。

   2. パッケージ フィードを選択したら、その場所からオートメーションを選択できます。 オートメーション名が [テスト ケース名] の下に表示され、パブリッシュされたパッケージ名が [パッケージ] の下に表示されます。
5. [保存] を選択して、変更を確定します。

These same steps point a test case to a newer Playwright package version. Prior execution history is preserved across the update.

テスト ケースを転送する

If you need to transfer your test cases to a different tenant, the Orchestrator automations selected for each test case are preserved when you export and then re-import the test cases in another tenant, including automations selected from Playwright packages. For more information on exporting test cases and importing test artefacts, visit Exporting test cases and Import project.

次のステップ

Orchestrator から選択したオートメーションを使用するテスト ケースを含むテスト セットを実行するには、テスト ケースを実行する特定のパッケージとバージョンを指定します。これにより、Test Manager は、Orchestrator フィード内の複数のパッケージからオートメーションにリンクされたテスト ケースを、選択したパッケージとバージョンのみを使用して実行できます。

特定の実行フォルダーの設定、およびパッケージとバージョンの選択について詳しくは、「特定の実行フォルダーとロボットに対してテスト セットを設定する」をご覧ください。

結果

オートメーションがテスト ケースにリンクされます。パッケージとテスト ケース名が [オートメーション] タブの [割り当てられたオートメーション] の下に表示され、テスト ケースの自動実行の準備が整います。