通知を受け取る

UiPath Studio

UiPath Studio ガイド

UI Explorer

UI Explorer は、特定の UI 要素に対応した独自のセレクターを作成できる高度なツールです。これは、Automation Cloud インスタンスの [リソース センター] からダウンロードできるスタンドアロンのツールです。UiPath.UIAutomation.Activities パッケージがプロジェクトの依存関係としてインストールされている場合には Studio からも利用できます。

UI Explorer をスタンドアロンのツールとして使用する場合、Studio のインストールは不要です。これは、アプリケーションをセレクターによって自動化できるかどうかを確認するときに便利です。プロセスを構築することなく、要素を簡単に検査できるからです。スタンドアロン パッケージには、SetupExtensions ユーティリティも含まれているため、ブラウザーの拡張機能や JavaBridge をインストールして、自動化が必要なあらゆる場面で要素を検査できます。

[UI Explorer] ウィンドウを開くには、[デザイン] タブの [セレクター] セクションにあるボタンをクリックします。あるいは、ターゲット UI 要素を指定した後に、ターゲットおよびアンカー属性のすべてのセレクターの選択画面にある高度なエディターからも開くことができます。

309309

📘

注:

使用中のプロジェクトの依存関係として UiPath.UIAutomation.Activities パッケージがインストールされていない場合は、[UI Explorer] ボタンがリボンに表示されません。

別の方法として、Studio の Backstage ビューの [ツール] ページから UI Explorer を開くこともできます。コンテキスト メニューからの UI Explorer は、Studio の現行バージョンに同梱されている UI Automation ライブラリを使用します。

📘

注:

UI Explorer を開くと、右下隅に、現在使用中の UIAutomationパッケージのバージョンが表示されます。このバージョンは場合によって異なります。UI Explorer[ツール] ページから起動した場合は、使用中の Studio のバージョンに同梱されている既定の UI Automation バージョンを使用します。UI Explorerリボンから起動した場合には、現在のプロジェクトの依存関係としてインストールされているバージョンを使用します。

10231023

最適なセレクターを選択するうえでのヒントを次に示します。

  • 属性を追加または削除する
  • 親タグまたは子タグを追加する
  • ワイルドカードを使用して変更する値を置き換える
12251225

UI Explorer ウィンドウのフィールドの説明

FieldDescription
ValidateThe button shows the status of the selector by checking the validity of the selector definition and the visibility of the target element on the screen.
The Validate button has three states:
image alt textimage alt text Selector is being validated
image alt textimage alt text Valid selector
image alt textimage alt text Invalid selector
image alt textimage alt text Modified selector, revalidate
Indicate Element
image alt textimage alt text
Indicates a new UI element to replace the previous one.
Indicate Anchor
image alt textimage alt text
Enables you to choose an anchor relative to the target UI element.
Repair
image alt textimage alt text
Enables you to re-indicate the same target UI element and repair the selector. This operation does not completely replace the previous selector. The button is available only when the selector is invalid.
Highlight
image alt textimage alt text
Brings the target element in the foreground. The highlight stays on until it's switched off. The button is enabled only if the selector is valid.
Options
image alt textimage alt text
Contains several options:
UI Frameworks - Changes the technology used to determine UI elements and their selectors. The following options are available:
Default – UiPath proprietary method. Usually works fine with all types of user interfaces.
Active Accessibility – an earlier solution from Microsoft for making apps accessible. It is recommended that you use this option with legacy software, when the Default one does not work.
UI Automation – the improved accessibility model from Microsoft. It is recommended that you use this option with newer apps, when the Default one does not work.
Click here to read more about Active Accessibility and UI Automation.
Delayed Restore - Delay restoring the UiExplorer window until after the selector data is loaded. Use this option when indicating UI elements that auto-close on focus lost, such as drop-downs or overlays.
Trigger Selector - Ensures the uniqueness of a UI element within its parent while increasing its monitoring accuracy. Use this option when generating selectors for trigger activities.

ビジュアル ツリー パネル

UI 階層のツリーを表示します。各ノードの前にある矢印をクリックしてナビゲートすることができます。

既定では、最初に UI Explorer を開くと、このパネルにはすべての開かれたアプリケーションがアルファベット順で表示されます。

ツリーから UI 要素をダブルクリックする (または右クリックして [ターゲット要素として設定] を選択する) と、[セレクター エディター][セレクター属性][プロパティ エクスプローラー] の各パネルが設定されます。

FieldDescription
Highlight
image alt textimage alt text
Highlights the selected element from the Visual Tree in real time. The highlight stays on until it's switched off.
Show Search Options
image alt textimage alt text
Displays the search box and search filter options.
Search BoxEnables you to look for a specific string. If an exact match is not found, nodes containing the nearest match are displayed.
Wildcards are supported.
Depending on the attribute selected from the Search by drop-down list, the search can be case sensitive.
Note: The search only looks for matches in the tree structure under the selected UI object.
Search byFilters your search to a selected attribute or a selector. The contents of this drop-down list change according to the selected UI element.
Note: If Search by is set to Selector, you can only input one node in the <attribute name1='value1' ... /> format.
Children OnlyLimit your search to the first level children of the selected node. By default, this check box is not selected.

セレクター エディター パネル

指定した UI オブジェクトに対応するセレクターを表示し、セレクターをカスタマイズすることができます。

パネルの下部には、プロジェクトで使用する必要がある実際の XML フラグメントが表示されます。必要なセレクターが見つかったら、ここからコピーしてアクティビティの [プロパティ] パネルの [セレクター] フィールドに貼り付けることができます。

パネルの上部では、セレクター内のすべてのノードを表示でき、ノードの前にあるチェック ボックスをオフにすることで不要なノードを削除することができます。属性を有効化/無効化した場合、または下部のパネルでセレクターを編集した場合、セレクター ノードのリストにある要素がアクティブになります。一度に 1 つのノードしかアクティブになりません。

ここでノードを選択すると、その属性が [セレクター属性] パネルと [プロパティ エクスプローラー] パネルに表示されます。

また、変数を通じてセレクターも編集できます。その場合、CTRL+K ホットキーを使用してセレクター自体の内部に変数を作成するか、CTRL+Space の組み合わせにより既に作成済みの変数を指定します。CTRL+K ホットキーを使用すれば、変数の値と名前を指定できます。string 変数のみ使用できます。

セレクター属性パネル

([セレクター エディター] パネルから) 選択したノードの使用可能なすべての属性を表示します。

各属性の前にあるチェック ボックスをオンまたはオフにすることで、ノード属性の一部を追加または削除できます。

また、各属性の値を変更することもできますが、この変更が保持されるのは、新しいセレクターが最初に選択した UI オブジェクトを指し示している場合のみです。

プロパティ エクスプローラー パネル

指定した UI オブジェクトが持つことのできる属性のすべて (セレクターに出現しない属性を含む) を表示します。これらは変更できません。

9 か月前に更新


UI Explorer


改善の提案は、API リファレンスのページでは制限されています

改善を提案できるのは Markdown の本文コンテンツのみであり、API 仕様に行うことはできません。