Migration of test assets from the earlier versions

You can migrate all test assets from the earlier versions of HCL OneTest UI, including projects, scripts, object maps, and verification points. The test assets from the earlier versions work with the current version of HCL OneTest UI.

Upgrade of the workspace and test assets

You must back up the test assets before you upgrade them to the new version of HCL OneTest UI. You can export the workspace as a compressed (.zip) file and import the file in the newer version of HCL OneTest UI if there are any issues in using the migrated workspace.

After you install a newer version of HCL OneTest UI and choose to open the UI from an old workspace, HCL OneTest UI prompts you to update all the test assets in the workspace as shown in the following screen capture:

Workspace upgrade

You can click Continue to update the workspace. If you find errors when you open a workspace from a different version of HCL OneTest UI, you can click Window > Reset Perspective to reset the perspective.

Also, when you modify and save the tests, the tests migrate automatically to the current version.

When you open a project that contains an older test asset, a message is displayed in the Test Navigator view as shown in the following screen capture: Upgrading test assets
You must click the Click here link to upgrade your test assets.
Note: You must not open a migrated test project with a previous version of HCL OneTest UI. Tests that you record with the current version of HCL OneTest UI do not play back on earlier versions.

Installation and uninstallation

When you want to uninstall the previous version of HCL OneTest UI and then install the latest version, you must install the latest version in the same folder that contained the previous version. Thereby, you can avoid compilation errors in the project in the latest version.

Note: You cannot have two versions of HCL OneTest UI installed on your computer at one time. Before you install a new version, uninstall the previous version of HCL OneTest UI. If you update HCL OneTest UI with IBM® Installation Manager, you do not have to uninstall the previous version. When you uninstall the previous version, the test assets are not deleted.

Upgrade of the reports

A new release might include enhancements to the default reports. When you upgrade test assets, reports also get updated to the latest version, and as a result, you lose modifications that you have made to the reports.

Java environments Enabler in the Functional Test perspective

As part of the upgrade, when you run the Enabler for the first time, a message is displayed that Java environments that were previously enabled will be automatically disabled. You must then enable Java environments that you want to use for testing. Web browsers that were previously enabled will remain as is.

You can click Configure > Enable Environments for Testing in HCL OneTest UI menu to run the Enabler. For more information on using the Enabler, see Enabling Java Environments. You must disable the next-generation plug-in for the existing JREs associated with browsers before upgrading.

Migration of functional test assets from earlier versions

All functional test assets from earlier versions of HCL OneTest UI, including projects, scripts, object maps, and verification points, work with the current version of HCL OneTest UI. However, scripts that you record with the current version of HCL OneTest UI do not play back on earlier versions. When you play back a script that was recorded with a previous version, a warning message is displayed in the log file. To view the log file without the warning message, you must disconnect the project, and connect again. For more information on connecting and disconnecting projects, see Connecting to a functional test project and Disconnecting a functional test project.