Mercury QuickTest Professional JavaTM Add-in 8.2 Readme
This file provides the following information about the QuickTest Professional Java Add-in:
Overview
Welcome to the QuickTest Professional Java Add-in 8.2. The QuickTest Professional Java Add-in can record and run tests on Java applications using customized test objects and methods.
The QuickTest Professional Java Add-in recognizes and records Java toolkits such as AWT, Swing, and more. Tests are simple to read, maintain, enhance, and parameterize so that both advanced and less technical users can create sophisticated tests on Java applications and applets.
Note: Support for Oracle Applications and Oracle Forms applications is provided through the separate QuickTest Professional Oracle Add-in 8.2. For more information, refer to the QuickTest Professional Oracle Add-in Guide.
For more information on the QuickTest Professional Java Add-in and for details and syntax of Java test objects and methods, refer to the QuickTest Professional Java Add-in Guide and the Java section of the QuickTest Object Model Reference.
Customer Support
Technical support for QuickTest Professional and the QuickTest Professional Java Add-in is provided via our award-winning Customer Support Web Site. From this Web site, customers are able to review Frequently Asked Questions, submit and check the status of support requests, and access online documentation, patches, and other downloads. Please visit the Customer Support Web Site at:
Customer Support contact numbers all over the world are available at:
http://support.mercury.com/cgi-bin/portal/CSO/contacts.jsp.
System Requirements
To successfully work with the QuickTest Professional Java Add-in, your system configuration should meet the requirements as specified for QuickTest Professional 8.2 (in the QuickTest Professional 8.2 Readme), plus the following add-in specific requirements:
Supported Environments
The QuickTest Professional Java Add-in supports recording and running tests on the following Java toolkits and environments:
The QuickTest Professional Java Add-in supports recording and running tests on the following Java run-time environments:
What's New in the Java Add-in
- The latest versions of Sun JDK and Java Web Start are now supported. For more information, see Supported Environments above.
- The Java Add-in has a new dynamic mechanism for adjusting the Add-in support to the Java runtime version, including version updates. This means that in most cases you can work with new JDK updates without the need for special configurations or patches.
- The following test object methods have been added:
- JavaEdit.SetSecure-Sets the encrypted value of an edit box, used for password edit boxes.
- JavaTestObject.PressKey-Presses the specified keyboard key and modifier (such as F-keys, Alt, Ctrl, and so on) to enter in the object. For example: JavaEdit("Customer").PressKey "C", micAlt
This method is supported for all Java objects. For more information on the new PressKey method, see enhanced hot key recording below.For more information, refer to the Java section of the QuickTest Object Model Reference.
- Enhanced hot key recording (using the new PressKey method) enables the recording of hot key operations that can affect the application behavior in some way, for example, pressing functional keys (F1, F2, and so on) or pressing regular keyboard keys with modifiers (Alt+T). For example: JavaEdit("Customer").PressKey "C", micAlt
- The Test Settings and Business Component Settings dialog boxes now include a new Java tab, which enables you to set Java test or component settings.
- The Java tab in the Options dialog box includes a new option, Tree view path separator, which enables you to specify the separator used to separate entries in a path to a Tree View control node. For example, if the character ; is used in a node name, you can specify the character | as the tree view path separator.
- You can use the Advanced Java Options dialog box to enable text checkpoint and text output value steps for Java test objects that meet certain criteria. For more information, refer to the QuickTest Professional Java 8.2 Guide.
- The options available in the Java tab of the Test Settings dialog box and the Options dialog box are now also available using the following new objects, methods, and properties in the QuickTest Automation Object Model:
- JavaSettings-A new object that represents the Java tab of the Test Settings dialog box, which enables you to configure how QuickTest records and runs steps on Java applets and applications. It returns the new JavaDeviceReplay and JavaEditSetMode objects.
- JavaDeviceReplay-A new object that represents the device-level replay options in the Java tab of the Test Settings dialog box. These options enable you to control whether operations are performed using device-level replay for certain mouse operations.
- JavaEditSetMode-A new object that represents the JavaEdit.Set options in the Java tab of the Test Settings dialog box. These options enable you to control how operations are performed on edit fields.
- JavaLauncher.ExecutableFile-A new JavaLauncher property that specifies the executable file path of the application to open.
- JavaOptions.TableExternalEditors-A new JavaOptions property that specifies the list of control classes that should not be treated as part of a JavaTable object, but rather as separate objects.
- JavaOptions.TableInternalEditors-A new JavaOptions property that specifies the list of control classes that should be treated as part of a JavaTable object.
For more information, refer to the QuickTest Automation Object Model Reference.
- You can now run the QuickTest Professional Java Add-in simultaneously with the WinRunner Java 7.6 Add-in and the WinRunner Oracle 7.6 Add-in, after installing the WR76DualAgentPatch patch. For more information, refer to the QuickTest Professional Java Add-in Guide.
- You can now retrieve and modify test settings during the test run using the Setting utility object. These settings replace the SetAUTVar and GetAUTVar methods that were available in previous versions of the Java Add-in. For example: Setting.Java("EDIT_REPLAY_MODE") = "PR"
Existing tests using the previous methods will continue to run successfully.- The JavaToolbar test object is now obsolete and is supported for backward compatibility only. Existing tests using this object will continue to run successfully.
Known Problems and Limitations
Installation Issues
- If you test Java applets and applications with Business Process Testing or you work with Java-related QuickTest tests in Quality Center, you need to install the QuickTest Professional Add-in for Quality Center 8.2 Patch 4403 on the Quality Center client computer. To install the patch, double-click the QTPQC82P4403.exe file located in the QCPluginPatch folder on the QuickTest Professional Java Add-in CD-ROM. Follow the on-screen instructions to install the patch.
- If you install the QuickTest Professional Java Add-in 8.2 on a computer with the Oracle Add-in 6.5, you will no longer be able to work with the Oracle Add-in 6.5.
Workaround: Install the Oracle Add-in 8.2.
- When you install the QuickTest Professional Java Add-in 8.2, the Setup program checks whether the WinRunner Java and/or Oracle Add-ins 7.6 are installed on the same computer. If either or both of these add-ins are installed, a message prompts you to install the WR76DualAgentPatch patch after you finish the add-in installation. If you do not install this patch, you will not be able to use the WinRunner Java and/or Oracle Add-ins on this computer.
- In Windows XP and Windows 2003, after you install the QuickTest Professional Java Add-in 8.2, the Windows Remote Shell Service (rshsvc.exe) may fail and display an error message every time you restart the computer. This occurs only if the Remote Shell Service is configured to run automatically.
Workaround: Either disable the automatic launching of the Remote Shell Service, or move the following variables from the System Variables section of the Environment Variables dialog box to the User Variables section: _classload_hook, _JAVA_OPTIONS, IBM_JAVA_OPTIONS, and MSJAVA _ENABLE _MONITORS.
Verification Issues
Workaround: Create table checkpoints on Java tables while recording your test.
Workaround: If a checkpoint on a transient object is required, make sure the object is visible prior to executing the checkpoint. For example, in the case of combo box list, you should insert a statement that clicks on the combo box button before executing the checkpoint.
General Issues
- If, while recording keyboard operations in a JFC single-line edit box in an IME composition window, you press the ENTER key to select the composition string, the key press may be recorded as the Activate method, thereby generating an extra step. For example: JavaWindow("Application").JavaEdit("User Name").Activate
This extra step generally does not affect the run session adversely.Workaround: Before running your test or component, remove the extra step that was recorded.
Workaround: During a run session, do not use Alt+F4 on a Java object. Use the Close method instead.
Workaround: When testing with QuickTest Java support, do not use -Xincgc in your command line, or, alternatively, do not use the dynamic transformation support mechanism. For more information, refer to the QuickTest Professional Java Add-in Guide.
Workaround: Use a string instead of the original type. For example, instead of 1, use "1". For example: y = JavaCheckBox("Active").WaitProperty ("enabled", "1", 1000)
- Although the JavaToolbar test object is now obsolete and is supported for backward compatibility only, it may still appear in the Custom Active Screen Capture Settings dialog box and the Object Identification dialog box (if the QuickTest Professional Java Add-in 6.5 was previously installed).
- By default, moving and resizing of Java windows are not recorded. This is because it may cause redundant recordings in some cases.
Workaround: To instruct the Java Add-in record these actions, use the Setting.Java method to set the record_win_ops variable to 1. For example: Setting.Java("RECORD_WIN_OPS") = 1
Workaround: Use the Object Spy and object repository to make sure the object's attached text and index attributes are correct.
Workaround: Ignore the exception.
Workaround: Use other verification methods (such as using GetTOProperty). For more details on verification methods, refer to the QuickTest Professional User's Guide.
- If you run a test with multiple iterations or repeatable scenarios on Netscape 6.1, you may experience unexpected behavior since Java applets are not always destroyed when you leave the page that contains them. This is due to a problem in the Netscape 6.1 browser.
- When selecting a JAR file from the command line in the Record and Run Settings dialog box, you should manually add -jar to the Command line box before you invoke the Java application.
- If you intend to launch your Java application using the Record and Run Settings dialog box, without using a batch file (or another executable file), and without the -jar command line option (after selecting a JAR file), you should include the fully qualified name of the Java class in the Command line box.
- A call to .Object.startModal of a JavaInternalFrame or JavaDialog object may cause QuickTest to behave unexpectedly until the dialog box is closed.
- The use of multibyte characters in a multiline edit field object is not supported.
© This document, and the accompanying software and other documentation, is protected by U.S. and international copyright laws, and may be used only in accordance with the accompanying license agreement. Features of the software, and of other products and services of Mercury Interactive Corporation, may be covered by one or more of the following patents: United States: 5,511,185; 5,657,438; 5,701,139; 5,870,559; 5,958,008; 5,974,572; 6,137,782; 6,138,157; 6,144,962; 6,205,122; 6,237,006; 6,341,310; 6,360,332, 6,449,739; 6,470,383; 6,477,483; 6,549,944; 6,560,564; 6,564,342; 6,587,969; 6,631,408; 6,631,411; 6,633,912; 6,694,288; 6,738,813; 6,738,933; 6,754,701; 6,792,460 and 6,810,494. Australia: 763468 and 762554. Other patents pending. All rights reserved.
Mercury, Mercury Interactive, the Mercury logo, the Mercury Interactive logo, LoadRunner, WinRunner, SiteScope and TestDirector are trademarks of Mercury Interactive Corporation and may be registered in certain jurisdictions. The absence of a trademark from this list does not constitute a waiver of Mercury's intellectual property rights concerning that trademark.
All other company, brand and product names may be trademarks or registered trademarks of their respective holders. Mercury disclaims any responsibility for specifying which marks are owned by which companies or which organizations.
Mercury Interactive Corporation
379 North Whisman Road
Mountain View, CA 94043
Tel: (650) 603-5200
Toll Free: (800) TEST-911
Customer Support: (877) TEST-HLP
Fax: (650) 603-5300QTPJAVARM8.2/01
Copyright 2005 Mercury Interactive Corporation |
Documentation comments or suggestions? Please send feedback to documentation@mercury.com |