通知を受け取る

UiPath Studio

UiPath Studio ガイド

UI Explorer

UI Explorer is an advanced tool that enables you to create a custom selector for a specific UI element. It is available as a standalone tool you can download from the Resource Center in your Automation Cloud instance, or from Studio only if the UiPath.UIAutomation.Activities package is installed as a dependency to the project.

Using UI Explorer as a standalone tool does not require you to install Studio. This comes in handy when you want to make sure that an application can be automated with selectors. It enables you to simply inspect elements without building a process. The standalone package also contains the SetupExtensions utility, thus making it possible to install browser extensions and the JavaBridge to inspect elements across all your automation needs.

To open the UI Explorer window, click the button in the Selectors section, in the Design tab, or from the advanced editor in the selection screen of all the selectors of the target and anchors attributes, after indicating the target UI element.

📘

注:

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

Alternatively, the UI Explorer can be launched from the Tools page in the Studio backstage view. UI Explorer from the context menu uses the UI automation libraries shipped with the current version of Studio.

📘

注:

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

To be sure that you choose the best selector, remember to:

  • Add or remove attributes
  • Add parent or children tags
  • Use wildcards to replace changing values

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

Field

Description

Validate

The 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.

UI Frameworks
image alt textimage alt text

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.

ビジュアル ツリー パネル

Displays a tree of the UI hierarchy and enables you to navigate through it, by clicking the arrows in front of each node.

By default, the first time when you open UI Explorer, this panel displays all opened applications, in alphabetical order.

Double-clicking a UI element (or right-clicking and selecting Set as Target Element) from the tree, populates the Selector Editor, Selector Attributes and Property Explorer panels.

Field

Description

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 Box

Enables 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 by

Filters 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 Only

Limit your search to the first level children of the selected node. By default, this check box is not selected.

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

Displays the selector for the specified UI object and enables you to customize it.

The bottom part of the panel displays the actual XML fragment that you have to use in a project. Once you find the selector you want, you can copy it from here and paste it in the Properties panel of an activity, in the Selector field.

The top part of this panel enables you to view all the nodes in a selector and eliminate the ones that are not necessary by clearing the check box in front of them. An element in the list of selector nodes becomes active when you enable or disable an attribute, or when editing a selector in the bottom panel. Only one node is active at a time.

Selecting a node here displays its attributes in the Selector Attributes and Property Explorer panels.

Selectors can also be edited with the aid of variables, either by using the CTRL+K hotkey to create a variable in the selector itself, or by specifying an already created variable with the CTRL+Space combination. Using the CTRL+K hotkey enables you to specify a value and a name for the variable. Please note that only string variables can be used.

セレクター属性パネル

Displays all the available attributes of a selected node (from the Selector Editor panel).

You can add or eliminate some of the node attributes by selecting or clearing the check box in front of each attribute.

Additionally, you can change the value of each attribute yet this modification is retained only if the new selector points at the originally selected UI object.

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

Displays all the attributes that a specified UI object can have, including the ones that do not appear in the selector. They cannot be changed.

約 1 か月前に更新



UI Explorer


改善の提案は、API 参照ページでは制限されています

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