Find the elements on the application screen

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture

    • Use the locators of the captured elements to find the elements on the application screen while using the Universal App Connector (UAC) in the RPA Desktop Design Studio.

    Avant de commencer

    Familiarize yourself with UAC concepts. For more information, see Universal app connector.

    Configure the UAC. For more information, see Use the Universal App Connector.

    Verify that you have open or active Windows, Java, Google Chrome, or Edge applications.

    Role required: None

    Pourquoi et quand exécuter cette tâche

    The UAC provides multiple locator types. For example, the XPath locator provides the XPath to the element.
    Figure 1. Locator types
    Element locators.

    Procédure

    1. In the Toolbox pane, navigate to Connectors, and drag Universal App Connector to Global Objects in the Project Explorer pane.
      The connector is added as a UniversalApplication object under Global Objects.
    2. Configure Universal App Connector and add a screen.
      For more information, see Use the Universal App Connector.
    3. Under the Screens and elements pane, select an element under a screen.
    4. From the Locator list, select one of the element locators.
      Tableau 1. Screen element locators
      Locator type Application type Description
      Id Web, Java, and Windows Unique identifier of the element if its defined in the target application.
      Name Web, Java, and Windows Unique name of the element if its defined in the target application.
      CssSelector Web The CSS selector that locates the captured web element. For example, div#navbarNav > ul > li > a. If a web application supports Shadow DOM, the CSS Selector shows the path with the shadow DOM elements. For example, html > body > shop-app > /ShadowDom/ > app-header[id="header"] > app-toolbar > div:nth-of-type(3) > a > paper-icon-button > /ShadowDom/ > iron-icon[id="icon"]
      TagName Web Unique tag name of the web element.
      JavaScript Web Allows the user to define a custom JavaScript code to locate an element.
      XPath Web XPath to locate the web element. If a web application supports Shadow DOM, this locator shows the full XPath with the Shadow DOM elements. For example, html > body > shop-app > /ShadowDom/ > iron-pages > shop-home > /ShadowDom/ > div > h2.
      Type Java and Windows Enables you to locate a screen element by its type. For example, button or text box.

      When you select the Type locator, the UAC connector populates the Value field with the type of the element.
      Path Java and Windows Enables you to locate a screen element by specifying its position in the hierarchy of screen elements.

      When you select the Path locator, the UAC connector populates the Value field with the path of the element.
      CustomPath Windows Enables you to fine-tune or trim the path to an element.