Frequently asked questions about HCL OneTest UI

For answers to some generic questions on using HCL OneTest™ UI, see this topic.

Does HCL OneTest UI support the testing of my application?

HCL OneTest UI supports applications that are developed using certain technologies. Verify the type of technology that is used to develop the test application, and verify if HCL OneTest UI supports functional testing of the domains and the controls in the application. If HCL OneTest UI supports the technology, and does not support a specific control for functional testing by default, you can use Proxy SDK to develop proxies that enable support for specific controls.

For information about supported domains, see Test application domain support.

For information about using Proxy SDK, see Introduction to Proxy SDK.

Can HCL OneTest UI be used to test Eclipse-based applications?

Yes. For configuration details, see Eclipse Support.

Is the Eclipse integrated development environment (IDE) provided with HCL OneTest UI?

If your HCL OneTest UI installation detects another HCL product on the workstation or an existing Eclipse installation, it shares the IDE shell on the workstation. If no other HCL tool is found on the workstation, HCL OneTest UI installs its own instance of the shell. HCL OneTest UI shares the shell with Rational® Software Architect, Rational Application Developer, HCL OneTest Performance, or any of the HCL products.

How do I enable debugging in HCL OneTest UI?

When you encounter a problem, debugging might be helpful to obtain more information about the possible causes of the problem. The problem can be in playback as well as in recording. To set the HCL OneTest UI Debug Perspective preference, see the instructions in Debugging scripts.

How do I transfer the information specified in the HCL OneTest UI Application Configuration Tool to playback agent machines?

HCL OneTest UI scripts contain startApp API calls to start your application under test at run time. For example:
At run time, the startApp command matches the string that is passed to it, with the corresponding entry in the Application Configuration Tool on the local playback machine. If no matching entry is found, an exception occurs and playback fails:
com.rational.test.ft.script.RunException: CRFCN0630E: Cannot find application [HCL] in the configuration file.

To avoid this exception, applications must be configured for testing on the playback workstation before the scripts are played back. For instructions to configure your applications for testing, see Configuring applications for testing.

To transfer your configured applications list between workstations, do these steps:
  1. Open the Application Configuration Tool (click Configure > Configure Applications for Testing).
  2. Open the C:\ProgramData\HCL\HOTUI\configuration\configurations.rftcfg file in a text editor. This XML file stores the information specified in the Application Configuration Tool.
  3. Copy the information contained within these tags:
    <ApplicationList L=".ApplicationList">
  4. Paste this information in the C:\ProgramData\HCL\HOTUI\configuration\configurations.rftcfg file on your additional workstations.
  5. Save the changes and restart HCL OneTest UI. The updated information is displayed in the Application Configuration Tool.

How do I run HCL OneTest UI under a different Java™ Runtime Environment (JRE)?

In a normal Eclipse-based HCL OneTest UI installation, HCL OneTest UI uses its own JRE, or the JRE of the Eclipse-based shell in which it has been installed. However, you can specify the JRE to be used, if required. Use the -vm argument at the command prompt to specify the JRE to be used:
"C:\Program Files\HCL\HCLOneTest\eclipse.exe" -vm "C:\Progra~1\j2sdk1.4.1_02\bin\javaw.exe"
Note: The Java version is only provided as an example. You can specify any Java version that is supported by HCL OneTest UI.
You can also change the JRE permanently by editing the eclipse.ini file in the SDP directory or by editing this registry key:
Note: These steps to change the JRE are applicable only to Java-based HCL OneTest UI installations and not to installations in Microsoft Visual Studio for .NET.

How do I cleanly uninstall HCL OneTest UI versions 7.x, 8.0 and 8.1.x on Microsoft Windows?

See Uninstalling HCL OneTest UI cleanly.

How do I enable the browser environments for testing applications on Microsoft Windows systems compliant with Federal Desktop Core Configuration (FDCC)?

Do these steps if you encounter problems trying to enable the browser environment for testing applications on FDCC compliant Microsoft Windows computers:

To enable the Internet Explorer 7 and Internet Explorer 8 browsers:
Note: This workaround is not required when you enable these browsers in HCL OneTest UI, version
  1. Click Start > Run. In the Run window, type regedit.
  2. In the HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Internet Explorer\Main\Enable Browser Extensions key in the Registry Editor, enable the third party browser extensions.
Note: Ensure that the Java Runtime Environment (JRE) corresponding to Internet Explorer 7 and Internet Explorer 8 is properly enabled and aligned with the browser.
To enable the Mozilla Firefox browser:
  1. Click Tools > Add-Ons.
  2. Navigate to the <product installation directory>\FunctionalTester\bin\enabler directory.
  3. Drag the enabler files RtxFFEnabler.xpi (for Firefox 2.0) , RtxFF3Enabler.xpi (for Firefox 3.0) , RtxFF35Enabler.xpi (for Firefox 3.5) and RtxFF36Enabler.xpi (for FireFox 3.6) to Add-Ons in Firefox.
  4. Click Install.

Can HCL OneTest UI be used with a project enabled for Unified Configuration Management (UCM)?

Yes. However, HCL OneTest UI supports only single-stream UCM.

Does configuring the application under test (AUT) modify the AUT?

Configuring an application does not modify it. It is analogous to setting up a system of shortcuts so that HCL OneTest UI can start the application.

What happens when Internet Explorer is enabled?

Internet Explorer is enabled by registering a browser helper object (BHO) with Internet Explorer. In the registry, this key is added if Internet Explorer has been properly enabled:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\Browser Helper Objects\{1E9FB1C4-F40B-4E10-898E-D6209B122F6B}	Rational IE Enabler

What are the language limitations for HCL OneTest UI scripts?

HCL OneTest UI uses standard Java. All the normal Java functions are available in functional test scripts and no subset of the language with custom extensions is used.