- Release Notes
- Getting Started
- Setup and Configuration
- Automation Projects
- Dependencies
- Types of Workflows
- Control Flow
- File Comparison
- Automation Best Practices
- Source Control Integration
- Debugging
- Logging
- The Diagnostic Tool
- Workflow Analyzer
- About Workflow Analyzer
- ST-NMG-001 - Variables Naming Convention
- ST-NMG-002 - Arguments Naming Convention
- ST-NMG-004 - Display Name Duplication
- ST-NMG-005 - Variable Overrides Variable
- ST-NMG-006 - Variable Overrides Argument
- ST-NMG-008 - Variable Length Exceeded
- ST-NMG-009 - Prefix Datatable Variables
- ST-NMG-011 - Prefix Datatable Arguments
- ST-NMG-012 - Argument Default Values
- ST-NMG-016 - Argument Length Exceeded
- ST-NMG-017 - Class name matches default namespace
- ST-DBP-002 - High Arguments Count
- ST-DBP-003 - Empty Catch Block
- ST-DBP-007 - Multiple Flowchart Layers
- ST-DPB-010 - Multiple instances of [Workflow] or [Test Case]
- ST-DBP-020 - Undefined Output Properties
- ST-DBP-021 - Hardcoded Timeout
- ST-DBP-023 - Empty Workflow
- ST-DBP-024 - Persistence Activity Check
- ST-DBP-025 - Variables Serialization Prerequisite
- ST-DBP-026 - Delay Activity Usage
- ST-DBP-027 - Persistence Best Practice
- ST-DBP-028 - Arguments Serialization Prerequisite
- ST-USG-005 - Hardcoded Activity Arguments
- ST-USG-009 - Unused Variables
- ST-USG-010 - Unused Dependencies
- ST-USG-014 - Package Restrictions
- ST-USG-020 - Minimum Log Messages
- ST-USG-024 - Unused Saved for Later
- ST-USG-025 - Saved Value Misuse
- ST-USG-026 - Activity Restrictions
- ST-USG-027 - Required Packages
- ST-USG-028 - Restrict Invoke File Templates
- ST-USG-032 - Required Tags
- ST-USG-034 - Automation Hub URL
- Variables
- Arguments
- Imported Namespaces
- Coded automations
- Introduction
- Registering custom services
- Before and After contexts
- Generating code
- Generating coded test case from manual test cases
- Trigger-based Attended Automation
- Recording
- UI Elements
- Selectors
- Object Repository
- Data Scraping
- Image and Text Automation
- Automating Citrix Technologies
- RDP Automation
- VMware Horizon Automation
- Salesforce Automation
- SAP Automation
- macOS UI Automation
- The ScreenScrapeJavaSupport Tool
- The WebDriver Protocol
- Extensions
- About extensions
- SetupExtensions tool
- UiPathRemoteRuntime.exe is not running in the remote session
- UiPath Remote Runtime blocks Citrix session from being closed
- UiPath Remote Runtime causes memory leak
- UiPath.UIAutomation.Activities packages and UiPath Remote Runtime versions mismatch
- The required UiPath extension is not installed on the remote machine
- Screen resolution settings
- Chrome Group Policies
- Cannot communicate with the browser
- Chrome extension is removed automatically
- The extension may have been corrupted
- Check if the extension for Chrome is installed and enabled
- Check if ChromeNativeMessaging.exe is running
- Check if ComSpec variable is defined correctly
- Enable access to file URLs and Incognito mode
- Multiple browser profiles
- Group Policy conflict
- Known issues specific to MV3 extensions
- List of extensions for Chrome
- Chrome Extension on Mac
- Edge Group Policies
- Cannot communicate with the browser
- Edge extension is removed automatically
- The extension may have been corrupted
- Check if the Extension for Microsoft Edge is installed and enabled
- Check if ChromeNativeMessaging.exe is running
- Check if ComSpec variable is defined correctly
- Enable access to file URLs and InPrivate mode
- Multiple browser profiles
- Group Policy conflict
- Known issues specific to MV3 extensions
- List of extensions for Edge
- Extension for Safari
- Extension for VMware Horizon
- Extension for Amazon WorkSpaces
- SAP Solution Manager plugin
- Excel Add-in
- Test Suite - Studio
- Troubleshooting
- About troubleshooting
- Microsoft App-V support and limitations
- Internet Explorer X64 troubleshooting
- Microsoft Office issues
- Identifying UI elements in PDF with Accessibility options
- Repairing Active Accessibility support
- Validation of large Windows-legacy projects takes longer than expected
Identifying UI elements in PDF with Accessibility options
Detection of UI elements for untagged PDF files is not supported for the following versions of Adobe Reader DC:
- 19.012.20036
- 19.012.20035
- 19.012.20034
- 19.010.20100
- 19.010.20099
- 19.010.20098
- 19.010.20091
- 19.010.20069
- 19.010.20064
- 19.008.20081
- 19.008.20080
- 19.008.20074
- 19.008.20071
We recommend using Adobe Reader DC 18 or Adobe Reader DC 19.012.20040 or greater.
Active Accessibility is an API which provides greater reading support for individuals with physical or cognitive difficulties. When enabled in programs, such as Adobe Reader, access, identification, or manipulation of UI elements can become difficult or prone to errors.
In Studio, this means that elements on a page of a PDF file are identified as a whole, rather than individually.
Below there are a couple of examples of UI element identification issues in PDF files you might encounter, as well as how to solve them.
Starting with the UiPath.UIAutomation.Activities package v19.5.0, the Change Reading Options of Current Document window is automatically opened and the appropriate options selected when you indicate on screen. If, however, you still encounter problems during element selection, it's recommended to manually adjust Accessibility options, as described below.
In this scenario, the PDF file contains meta-information inside the page content. This means that Accessibility options read the embedded information (as a whole, instead of visible page elements) and present it to UIExplorer. This interferes with the detection of individual elements on the page itself, as you can see below:
Please note that selection of UI elements inside untagged PDF files is only possible for Adobe Reader DC 19.012.20040 or greater. You need to tag PDF files for interactive UI element selection to function.
Once PDF files are tagged, you need to select the following option:
- In Adobe Reader, open the Edit menu, and click the Change Reading Options option from the Accessibility sub-menu. The Change Reading Options of Current Document window is displayed.
- From the Reading Order drop-down, select the Tagged reading order option. This instructs Adobe Reader to ignore Active Accessibility when reading the document.
- In the Reading Mode Options section, select the Read the entire document option.
- Click the Start button. UIExplorer can now be used to identify individual UI elements on the page.
To fix this, the document Accessibility reading order needs to be changed, by following these steps:
- In Adobe Reader, open the Edit menu, and click the Change Reading Options option from the Accessibility sub-menu. The Change Reading Options of Current Document window is displayed.
- From the Reading Order drop-down, select the Infer reading order from document option. This instructs Adobe Reader to ignore Active Accessibility when reading the document.
- In the Reading Mode Options section, select the Read the entire document option.
- Click the Start button. UIExplorer can now be used to identify individual UI elements on the page.
Here, the document contains a single Active Accessibility object which is visible on a page, composed of multiple elements, such as text and pictures. However, when printed or read by Accessibility options, the object is decomposed in individual elements. The issue here is the same, as you can see:
Again, the fix is to change the document Accessibility reading order, as follows:
- In Adobe Reader, open the Edit menu, and click the Change Reading Options option from the Accessibility sub-menu. The Change Reading Options of Current Document window is displayed.
- From the Reading Order drop-down, select the Use reading order in raw print stream option. This instructs Adobe Reader to ignore Active Accessibility when reading the document.
- In the Reading Mode Options, select the Read the entire document option.
-
Click the Start button. UIExplorer can now be used to identify individual UI elements on the page.
This issue has been fixed in UiPath.UIAutomation.Activities version 22.12.
PDF automation works even if the Protected Mode security option is enabled.
For UiPath.UIAutomation.Activities 22.10 and older and Adobe Reader DC version 22.003.20258 (see Acrobat Reader Release Notes), PDF automation may be affected. It isn't possible to identify individual elements in PDF documents, instead the entire document is selected.
This issue is caused by a security option available in Adobe Reader DC, Enable Protected Mode at startup, which is enabled by default.
To fix this, disable the security option using the steps below:
- Open Adobe Reader.
- Go to Edit > Preferences.
- From the Categories list, select Security (Enhanced).
- In the Sandbox Protections section, clear the Enable Protected Mode at startup checkbox.
- A confirmation is requested. Click Yes to continue, then click OK.
- Restart Adobe Reader. UIExplorer can now be used to identify individual UI elements on the page.