Share this page
Known Issues - UIA Pro Add-in
Known limitations when using the UIA Pro Add-in
The following table describes known issues when using the UIA Pro Add-in:
| Known limitations | Description |
|---|---|
| Recording | Recording UIA Pro steps is not supported. |
| Object property | The property used to access native methods and properties of an object, is not supported in UIA Pro. |
Object Model changes introduced in version 26.1
The following changes were introduced in the Object Model in version 26.1 (or in version 25.2 if you enabled the Enhanced Beta UIA Pro Add-in).
These changes might require you to adjust your tests when you run tests developed in earlier versions or enable/disable the legacy UIA Pro Add-in.
| Methods, objects, and properties | Behavior | Behavior before version 26.1 |
|---|---|---|
| WaitForInputIdle method | The method returns a Boolean value, indicating whether the window is idle or the timeout expired. | The method returns no value |
| GetSupportedPatterns method |
The method returns a collection of patterns.
If you used UBound(<returned value>) in your scripts, replace it with <returned value>.Count.
|
The method returns an array. |
| ToString method |
The method might return values that are slightly different than before.
Example: UIAProProgressBar.ToString method returns the string
ProgressBarTO progressbar. |
The method might return slightly different values.
Example: The returned string contained an additional space:
ProgressBarTO progress bar. |
| GetExpandCollapseState, GetRole, GetState, GetPrimaryTraversalDirection, GetSupportedSelectionMode, GetToggleState, GetWindowInteractionState, GetWindowVisualState methods | The methods return string values. For details, see the UIA Pro section of the Object Model Reference. | The methods return Integer values. For details, see version 25.2 or earlier of the UIA Pro section in the Object Model Reference. |
| DoubleClick and DoubleClickCell methods | These methods replace Activate and ActivateCell, which are still supported for backward compatibility. | Use Activate and ActivateCell |
| Tooltip objects | The objects are correctly identified as UIAProToolTip test objects | The objects are identified as generic UIAProObjects. |
| String properties retrieved from the application when spying on objects and when retrieving properties using test object methods. |
Leading and trailing spaces are not trimmed. Note: When a test object is added to the object repository, leading and trailing spaces in mandatory properties are still trimmed. |
Leading and trailing spaces are trimmed. |
Switching back to the legacy UIA Pro behavior
The new enhancements introduced changes to the Object Model. These changes might require you to adjust UIA Pro tests created in versions earlier than 26.1. For details, see Object Model changes introduced in version 26.1.
If you cannot currently update your existing tests, you can switch back to the legacy behavior. However, you then forgo the benefits of the latest enhancements. For details, see UIA Pro enhancements and Known issues when using the legacy UIA Pro Add-in.
The option to switch back to the legacy behavior provides more time for you update your tests, but will be available only in version 26.1.
To enable the UIA Pro legacy behavior:
-
Make sure OpenText Functional Testing is closed.
-
As an administrator, run the < Installdir >\dat\EnableLegacyUIAPro.bat batch file.
To return to the default behavior:
-
Make sure OpenText Functional Testing is closed.
-
As an administrator, run the < Installdir >\dat\DisableLegacyUIAPro.bat batch file.
Known issues when using the legacy UIA Pro Add-in
The following table describes known issues when working with the legacy UIA Pro Add-in:
| Known issues | Description |
|---|---|
| Object hierarchy: Spying |
UI Automation applications often have deep object hierarchies. This add-in has limited access to contained objects. The Object Identification Center shows only a limited hierarchy of a spied UIA Pro object. To see the full hierarchy, use the Object Spy.[defect:602083] |
| Object hierarchy: Interacting with objects |
Most common methods and properties are not supported on objects retrieved during a run session. |
| Assistive properties | Assistive properties are not supported in UIA Pro, and all properties included in an object's description are considered mandatory. |
| Parameter value enumerations |
When entering a parameter value in a UIA Pro test step, do not use the enumeration values provided by the code completion suggestions. Rather, use the string or integer values documented in the Object Model Reference. Example: For example, when calling the Click method, replace: |
See also:
