劇作家のテスト オートメーション

劇作家のオートメーションを Test Manager のオートメーションの種類として、Studio で作成されたオートメーションとともに使用します。Studio で既存のテスト スイートを書き換えることはありません。

注:

This capability is in controlled availability, delivered only to eligible tenants. It is available in Test Manager only when delivered through Test Cloud, and UiPath must enable it for your tenant before it works — contact your UiPath account team with your tenant details to request enablement.

Test Manager は、Studio が作成した (ロボット) のオートメーションに加えて、 Playwright のオートメーションを利用したテスト ケースも実行できます。すでに Playwright でエンドツーエンドのテストを記述しているチームは、Studio でテストを書き直すことなく、オーケストレーション、スケジュール設定、レポート、トレーサビリティのためにこれらのテストを Test Manager に取り込むことができます。

Playwright の自動化の仕組み

Playwright のテスト プロジェクトは、UiPath の外部にある独自のソース管理システムに存在します。そこから、オートメーションは以下のフローで Test Manager に到達します。

1. プロジェクトは、UiPath コマンド ライン インターフェイス (CLI) の tm pack コマンドを使用して UiPath オートメーション パッケージにパッケージ化され、Orchestrator の テナント全体のグローバル パッケージ フィードまたはフォルダー レベルの専用フィードにパブリッシュされます。パッケージ化の手順については、「 Test Manager 用の Playwright プロジェクトをパッケージ化する」をご覧ください。
2. パブリッシュされたパッケージは、Studio でパブリッシュされたオートメーションと同じように、オート メーションの選択 フローを通じて Test Manager で選択できるようになります。
3. パッケージが Test Manager プロジェクト キーを使用して構築された場合、一致するテスト ケースが自動作成され、Test Manager がパッケージを取り込むと、Playwright のオートメーションが各テスト ケースに自動リンクされます。それ以外の場合は、テスト ケースは個別に作成され、Studio のオートメーションの場合と同じフローを使用して、オートメーションが手動でリンクされます。
4. それ以降、テスト ケースは Test Manager の他の自動化されたテスト ケースと同様に動作します。つまり、テスト セットに配置したり、オンデマンドまたはスケジュールに従ってトリガーしたり、結果、成果物、およびトレーサビリティのリンクが他のすべてのテスト ケースとともに表示されます。

Test Manager が Playwright プロジェクトからキャプチャする内容

[Test Manager] フィールド	劇作家から来る
名前 &; 説明	テスト タイトルのみ。パッケージのメタデータには [説明] フィールドがないため、[説明] には入力されません。
ラベル	@tag / アノテーション値 (例: resilience、 observability)、フィルター処理およびテスト セットのスコープ設定用のラベルとしてテスト ケースにコピーされます。
プロジェクト/仕様ファイル	テストが属する Playwright プロジェクト ( playwright.config.tsから) と仕様ファイル。メタデータとしてキャプチャされます。テストごとに 1 つのテスト ケースが作成され、プロジェクトごとに展開はありません。
ソース ([オートメーションを選択] タブ)	[オートメーションを選択] ピッカーに表示される Playwright または UiPath のソースの値。

注:

[名前と説明]、[ラベル]、および [プロジェクト/仕様書ファイル] はすべて、自動生成されたシステム ラベルとしてテスト ケースに実装されます。[ソース] は独立したフィールドであり、[オートメーションを選択] ピッカーにはラベルとしてではなく独自の列として表示されます。

用語

• オートメーションとテスト ケースは、Test Manager では依然として別個の種類の成果物です。
• オートメーション (Playwright または Studio) がテスト ケースに割り当てられる。
• 劇作家のテストは、それ自体がテスト ケースと呼ばれることはありません。

実行とレポートのパリティ

割り当てが完了すると、Playwright が支援するテスト ケースは、Studio で作成されたテスト ケースとまったく同じように実行、スケジュール設定、レポートされます。つまり、同じトリガー、同じテスト セットのメンバーシップ ルール、同じ結果、トレーサビリティ ビューが表示されます。

既知の制限事項

制限事項	意味
Chromium のみ	実行ポッドは Chromium のみをインストールします。Firefox または WebKit を使用するように設定されたプロジェクトは引き続き選択できますが、そのブラウザーでは実行が実行されません。
サーバーレス実行のみ	Playwright のテストは UiPath サーバーレス インフラストラクチャでのみ実行され、実行ごとに専用のポッドが使用されます。オンプレミスまたはローカルのロボットの実行はまだサポートされていません。
Node.js (JavaScript/TypeScript) のみ	Node.jsベースのみ劇作家プロジェクトがサポートされています。playwright-python、 playwright-java、 playwright-dotnet のプロジェクトはサポートされていません。
自己完結型プロジェクトが必要です。	各プロジェクトは自己完結型ディレクトリからパッケージ化し、依存関係はパックされたルートで解決可能である必要があります。mono-repo サブフォルダーは、自己完結型の場合にのみ機能します。
アサーション レベルの詳細がない	Test Manager は Playwright のアサーションを個別に公開しません。これは、Playwright 独自の試行ごとの成功/失敗の結果と設定された添付ファイルに依存します。
外部で実行された結果のインポートなし	Test Manager の外部で実行される Playwright スイートの結果 (顧客自身の CI など) はインポートできません。
1 つの実行につき 1 つのジョブ	All test cases in one Playwright test set execution run within a single Orchestrator job — an oversized test set risks a job timeout.
Execution time limit	A Playwright test set execution has a 45-minute time limit, separate from the video-recording time limits that apply elsewhere in Test Manager.
マルチポッド シャーディングなし	スイート全体は、1 回の実行につき 1 つのポッドで実行されます。Playwright 独自のワーカー並列処理は設定どおりに適用されますが、ポッド間での分散シャーディングはまだ利用できません。
フィクスチャーごとのレポートなし	Playwright の備品 (test.extend()) は正常に動作しますが、Test Manager はテスト ケース レベルまたは備品ごとのレポートを使用してモデル化しません。
自己修復機能はありません。	エージェンティック自己修復機能は、Playwright のオートメーションではまだ利用できません。
強制的な実行順序はありません	テスト ケースの順序は playwright.config.tsに従います。Playwright のテスト セットで [ 実行順序を適用]、[ RPA アクティビティ カバレッジ]、または [ Healing Agent ] を有効化すると、実行がすぐに失敗します。
パッケージ間またはバージョン間の混在は禁止されています	1 つのテスト セット内で 2 つの異なる Playwright パッケージのテスト ケース、または 2 つの異なるバージョンの同じパッケージのテスト ケースを混在させることはブロックされます。
データ ドリブンなテスト セットですべてのバリエーションが実行されます	パラメーター化された Playwright テストの各バリエーションは、それ自体のテスト ケースです。テスト セットに 1 つのバリエーションを追加すると、そのテストのすべてのバリエーションが実行されます。
UiPath のビデオ録画やライブ ストリーミングは利用できません	Playwright のテスト セットで ビデオ録画 を有効化しても効果はなく、[ 録画 ] タブとライブ ストリーミング アクションにデータが表示されません。Playwright自身のビデオキャプチャ(playwright.config.tsのuse: { video })は影響を受けず、これらの.webmファイルは引き続きアーティファクトとして添付されます。

ライセンス

Test Manager を介して Playwright のテストを実行すると、基になるロボット実行レベルでは、他のサーバーレス テスト実行と同じプラットフォーム容量が消費されます。Playwright とネイティブの UiPath テスト オートメーションの使用率に違いはありません。詳しくは、「 ユニファイド プライシング: Test Manager のライセンス」をご覧ください。

関連

• Playwright アーティファクト キャプチャの仕組み
• Test Manager 用の Playwright プロジェクトをパッケージ化する
• Playwright テスト用の成果物キャプチャの構成
• オートメーションを選択する