Troubleshoot UIA Pro behavior changes after upgrade

In recent releases, UIA Pro has been significantly enhanced with new features and improvements. If you have upgraded to the latest version and notice that existing tests are no longer working correctly, this may be due to changes in UIA Pro's behavior.

UIA Pro behavior changes

The enhanced UIA Pro includes the following new capabilities:

  • Traverse Mode: A new option in the Object Identification Center for navigating complex UI hierarchies.

  • Relative Object Paths: Support for identifying controls relative to stable anchor objects.

These enhancements introduce changes to how UIA Pro identifies and interacts with objects. While these changes generally improve robustness and flexibility, they may affect existing test behavior.

Back to top

Solution: Rollback to previous UIA Pro behavior

If the new UIA Pro behavior is incompatible with your existing test suite, you can temporarily revert to the previous version of UIA Pro by running a rollback batch script. This allows you to continue using your tests while you evaluate and migrate to the new behavior.

Run the UIA Pro rollback script

If your existing tests are no longer functioning after upgrading, you can run a rollback script to revert to the previous UIA Pro behavior. To do this:

  1. Locate the UIA Pro rollback script in your OpenText Functional Testing for Developers installation directory.

  2. Run the rollback script with administrator privileges.

  3. Restart your tests to apply the changes.

  4. Verify that your existing tests now run with the previous behavior by executing a test that was affected by the upgrade.

Back to top

Trade-offs and considerations

While rolling back restores previous behavior and test stability, you will no longer have access to the new UIA Pro features:

  • Traverse Mode: The streamlined OIC navigation for complex hierarchies will not be available.

  • Relative Object Paths: You cannot use anchor-based navigation to make tests more robust against UI changes.

  • Performance improvements: Some performance enhancements introduced in the new UIA Pro will not be applied.

For this reason, rolling back should be considered a temporary measure while you plan to migrate your tests to take advantage of the new features and improved behavior.

Back to top

Recommended next steps

After rolling back, we recommend the following:

  1. Evaluate the new features: Review the documentation to understand the benefits:

  2. Update your tests incrementally: Rather than updating all tests at once, migrate them gradually to use the new UIA Pro behavior.

  3. Test thoroughly: After updating each test, run comprehensive tests to ensure the new behavior works correctly in your environment.

  4. Plan a full migration: Once you are confident in the new behavior, apply the enhanced UIA Pro permanently and remove the rollback.

Tip: Consider testing the new UIA Pro behavior in a development or staging environment before rolling back in production to identify which tests may be affected.

Back to top

See also: