オブジェクトリポジトリについて

オブジェクトリポジトリでは、UI 要素を DOM に類似したリポジトリ内にプロジェクト間で共有可能なオブジェクトとしてキャプチャすることで、UI 要素の管理性、再利用性、信頼性を確保します。オートメーションプロジェクト内部、および複数のオートメーションプロジェクトで、UI の分類情報を作成・再利用できるようにします。オブジェクトリポジトリを使用すれば、数分でアプリケーションの UI API を構築し、チームと共有できます。

オブジェクトリポジトリの主な機能を以下に示します。

プロジェクト全体の UI 要素を 1 か所で管理、更新、変更できます。
[オブジェクトリポジトリ] パネルの [UI アクティビティ] タブを使用して、プロセス内のすべての UI アクティビティのリストを表示できます。
要素をキャプチャ ウィザードを使用して、オートメーションに必要な要素をすばやくキャプチャできます。
要素をアンカーと一緒にキャプチャする「要素をキャプチャ」レコーダーにより、セレクターの信頼性が向上します。
アンカーの機能により、少し新しくなった UI をアプリケーションが取得した場合でも、オブジェクトの信頼性が保たれます。
[オブジェクトリポジトリ] パネルから要素をドラッグアンドドロップできます。
ライブラリとしてパッケージ化されているオブジェクトを、ローカルプロジェクトまたは複数のプロジェクトで再利用できます。
UI ライブラリを使用して、アプリケーションとプロセス UI 要素を一度にアップグレードできます。

前提条件

The Object Repository works with UiPath.UIAutomation.Activities package versions 20.10.x and above. Note that UiPath.UIAutomationNext.Activities package has been deprecated as of 20.10. The activities from UI Automation Next are now found in the UI Automation package.

[オブジェクトリポジトリの使用を強制] トグルが [はい] に設定されている場合は、UI Automation パッケージのアクティビティ部分がオブジェクトリポジトリの要素を参照する必要があります。

The classic UI Automation activities are hidden by default. However, they are still available under the Classic category in the Activities panel and can be added to a project from the Activities panel or the Add activity search bar.

主な概念

UI 記述子

UI 記述子はセレクターの上位セットです。画面上の要素を一意に識別するための情報を保持しています。

UI 記述子はワークフロー内のアクティビティから抽出され、それらのアクティビティをアプリケーション、アプリケーションのバージョン、画面、UI 要素ごとにグループ化する、構造化されたスキーマに追加されます。このタクソノミー構造のうち、記述子情報を保持しているのは画面と要素だけです。残りはグループ化に使用されますが、その役割はアプリケーションのバージョン間のアップグレードが確実に行われるようにすることです。

UI 記述子は次のものの一部になる可能性があります。

幅広い再利用を目的とした 1 つのプロジェクト
テストを目的としたスニペットリポジトリ
プロジェクト間のグローバルな共有を目的とした UI ライブラリ

UI 要素

UI 要素には、完全または部分的な要素セレクター、アンカーセレクター、画面および要素画像のキャプチャコンテキスト、画面上の要素について記述するその他のメタデータが含まれます。

画面

画面とは、ワークフロー内のアクティビティから抽出された UI スコープ、または要素のキャプチャ時間で生成される UI スコープです。画面では、同じ画面に属する複数の要素が 1 つにまとめられます。

UI アプリケーション

UI アプリケーションとは、複数のバージョンを持つ対象のアプリケーションであり、各バージョンに複数の画面を含めることができます。アプリケーションには複数の種類があります。

デスクトップ/Web アプリケーション
モバイルアプリケーション

モバイルアプリケーションを定義する場合は、UiPath.MobileAutomation.Activities パッケージを使用する必要があります。

オブジェクトブラウザーで作成した UI ライブラリには、次のような階層構造になっています: アプリケーション > バージョン > 画面 > UI 要素。

UI ライブラリ

UI ライブラリとは、要素をアプリケーション、アプリケーションのバージョン、画面ごとにまとめてカプセル化したものです。定義した要素は UI ライブラリとして抽出でき、パブリッシュ後は他のプロジェクトに依存関係としてインストールすることができます。

UI ライブラリには複数のアプリケーション (ただし、1 つのアプリケーションにつき 1 つのバージョンのみ) を含めることができます。このメカニズムにより、依存関係をアップグレードするときに、プロジェクト内で使用していたアプリケーションのバージョンも確実にアップグレードされます。

既存のアプリケーションの新しいバージョンを作成するときは、既存の要素を再利用する必要があることに注意してください。要素には一意の識別子があり、アクティビティから参照されるときに使用されます。要素の内容 (記述子やその他のメタデータ) はいつでも変更できます。

再利用性

オブジェクトリポジトリにより、UI 要素をプロジェクト全体で再利用できます。

ローカルに保存された要素はプロジェクトレベルで再利用できます。
テストのために、[スニペット] パネルを使用してアプリケーションを保存し、プロジェクト間で受け渡しすることができます。[スニペット] から、ローカルプロジェクトリポジトリにアプリケーションを追加できます。
グローバルレベルで再利用する場合は、UI ライブラリに要素を抽出し、依存関係としてプロジェクト内にインストールします。再利用性を優先して、すべてのオートメーションプロジェクトで必要となる要素を持つ UI ライブラリの作成から始めることもできます。

オブジェクトリポジトリの構造

オブジェクトリポジトリはツリー構造になっています。各ノードが画面または要素を表すオブジェクトであり、すべてがアプリケーションの下で階層化されています。ツリーの構成要素は以下のとおりです。

アプリケーション - UI Automation で使用される技術に応じて、モバイルアプリケーションかデスクトップ/Web アプリケーションのいずれかになります。
バージョン - 複数のバージョンのアプリケーションが存在する可能性があります。
画面 - アプリケーションバージョンのトップレベルウィンドウです。アプリケーションバージョン下にのみ作成可能です。
UI 要素 - 記述子とメタデータを使用する画面上のオブジェクトです。複数の種類があります。

指定された画面の範囲内であれば、UI 要素はツリー構造上で自由に再配置できます。UI 要素を移動するには、ツリー上の目的の場所にドラッグアンドドロップするだけです。

要素は他の要素の一部にもなり、UI 固有のロールを持たないコンテナーの下にグループ化することもできます。これにより、ユーザーが画面上で目にするものにできるだけ近い UI 構造を定義できます。