Windows option

To generate a widget tree for Windows applications, Tungsten RPA uses the UI Automation framework built into Windows. RPA provides extended support for some applications.

If you experience issues working with applications using RPA extensions, turn them off by clearing the selection in Windows tree mode.

Windows tree mode

For information about automating applications with the Windows option, see:

Excel API

Use Excel API to turn on extended support for Microsoft Excel, such as to retrieve cells from the spreadsheet.

To work with Excel using this option, do not leave the Excel workbook in Edit mode (the word Edit appears in the Excel program window).

When using Enter Text in Excel on a remote device, exit Edit mode using one of the following methods.

  • Press Enter using the Press Key step.

    Excel exits Edit mode and selects the cell directly below the current cell.

  • Press Tab using the Press Key step.

    This stops Edit mode and selects the cell to the right of the current cell.

  • Click a different cell.

  • Press F2 using the Press Key step.

Refer to the Microsoft documentation for more information.

Internet Explorer

When you use Microsoft Edge in Internet Explorer mode, it turns on extended Internet Explorer support to retrieve the Document Object Model (DOM) tree.

This option provides a more accurate result in the application tree. Also, RPA provides a built-in Chromium web browser to access websites.

Be aware of the following when using extended Internet Explorer support.

  • If extended Internet Explorer support is disabled, the UI Automation gets the object tree from Internet Explorer (this is the same tree that you get using Microsoft's Inspect.exe).
  • If extended Internet Explorer support is enabled and the robot detects an Internet Explorer window:
    • A piece of Java script is injected that traverses the DOM and creates a JSON representation. This runs in the context of the Internet Explorer page.
    • The JSON is placed into an input tag with ID kapowDataElement in the page.
    • The robot parses the JSON content and creates the sub-tree from that content.

Java

Use the Java Access Bridge to build the tree for Java applications.

SAP

SAP is handled differently from other Windows applications. Working with SAP depends on scripting API, which might be slow. Turn off SAP support by clearing this option.

Nodes for some elements may be unavailable in the application tree. To make all nodes available in the tree:

  1. From the product installation folder, download and save the RegSAPSurrogate.reg file on the computer running the Desktop Automation Service.

    The file resides here:

    {path}\Tungsten RPA Desktop Automation 2026.1.0.0\DesktopAutomationService\bin

  2. Run the file and accept any warnings.

  3. Restart the Service agent.

Hidden

This option extracts the entire tree of an application and is selected by default. If you clear the default selection, RPA skips elements that are reported as off-screen, such as list boxes or tables with many elements. Clearing the selection reduces the time needed to extract the tree.

Legacy Depth+Index

Adds the depth and index attributes used in RPA 10.2 to the application tree.

If you have robots created in RPA version 10.2 that use component finders with depth and index attributes, select Legacy Depth+Index for the robots to work in RPA 10.3 and newer releases.

  • Max Depth: Sets the maximum nested elements each node shows for all application windows in the view.
  • Max Siblings: Sets the maximum sibling elements each node shows for all application windows in the view.

    Specify 0 for no restrictions.

Excel API Retry Count

Specifies the number of retries when accessing the Excel window via Windows API. Increase the number if the Excel response is slow.

Excel API Retry Wait Time

Specifies the time in milliseconds between retries when accessing the Excel window via Windows API.