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:
startApp("HCL.com");
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\OneTestUI\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">
</ApplicationList>
  4. Paste this information in the C:\ProgramData\HCL\OneTestUI\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:
HKEY_LOCAL_MACHINE\SOFTWARE\HCL Technology\HCL OneTest UI\HCL FT JRE
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 8.1.1.2.
  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.

How to use a customized DLL in HCL OneTest™ UI for Microsoft® .NET?

Perform one of the following actions to add a customized DLL:
  • Add the DLL file to the HCL OneTest™ UI <install_dir>\bin directory, and then add the name of the DLL file to netAssembliesForCompiler.txt in the same directory.
  • Add the DLL file to the C:\ProgramData\HCL\HOTUI\customization directory.