UiPath Studio

UiPath Explorer

UiExplorer is an advanced tool that enables you to create a custom selector for a specific UI element.

To open the UiPath Explorer window, click Launch UiExplorer in the Design tab.

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

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

Field Descriptions for the UiPath Explorer Window

Field
Description

Select Target Element
image alt text

Automatically generates a selector by indicating a UI element on your screen.

Select Relative Element
image alt text

Enables you to find an anchor in a UI element, so that you can find a better selector.

Validate
image alt text

Verifies if your selector is valid or not. A dialog box is displayed letting you know about the result.

Reset
image alt text

Resets all the panels from the UiPath Explorer window to their default states.

UiFrameworks
image 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 eariler 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.

The Visual Tree Panel

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 UiPath Explorer or after you click the Reset button, 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 text

Highlights the target element and/or anchor

Show Search Options
image 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.

The Selector Editor Panel

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.

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

The Selector Attributes Panel

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.

The Property Explorer Panel

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.

Updated 5 months ago



UiPath Explorer


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.