QuickTest Professional 9.2 Readme
This file provides the following information about QuickTest Professional:
· Overview
· Supported Environments and Programs
· Known Problems and Limitations
· Third-Party License Agreements
Overview
Welcome to QuickTest Professional, the Mercury automated keyword-driven testing solution. By mirroring end-user behavior, QuickTest Professional creates interactive customizable tests or components that simplify and shorten the testing cycle.
QuickTest Professional enables you to test standard Windows applications, Web objects, ActiveX controls, and Visual Basic applications. You can also test special environments, such as the Java, Oracle, SAP solutions, .NET Windows and Web Forms, Windows Presentation Foundation, Siebel, PeopleSoft, Web services, and terminal emulators, using additional QuickTest add-ins.
QuickTest Professional is Unicode-compliant, and supports Unicode 2.0, UTF-8, and UTF-16.
QuickTest Professional supports working with the following Mercury applications:
Customer Support
Technical support for QuickTest Professional 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 install and run QuickTest Professional, you need to meet the following system requirements:
Note: Performance has not been optimized for the minimum system configuration. For best performance, your system should be configured using at least the recommended levels.
The information in this section is correct at the time of this release. Refer to http://www.mercury.com/us/products/quality-center/functional-testing/quicktest-professional/requirements.html for the most updated QuickTest Professional system configurations.
Supported Add-ins
The following specific add-in versions are supported with QuickTest Professional 9.2:
· QuickTest Professional Java Add-in 9.1
· QuickTest Professional .NET Add-in 9.2
· QuickTest Professional Oracle Add-in 8.2
· QuickTest Professional PeopleSoft Add-in 8.2*
· QuickTest Professional Add-in 8.2 for SAP Solutions
· QuickTest Professional Siebel Add-in 8.0*
· QuickTest Professional Stingray Add-in 8.2
· QuickTest Professional Terminal Emulator Add-in 8.0*
· QuickTest Professional VisualAge Smalltalk Add-in 8.2
· QuickTest Professional Web Services Add-in 9.2
Note: You cannot use any other add-ins or add-in version with QuickTest Professional 9.2, except for those listed above.
* PeopleSoft Add-in 8.2, Siebel Add-in 8.0, and Terminal Emulator Add-in 8.0 all require an Add-in Upgrade patch before you can use them with QuickTest Professional 9.2. You can install Add-in Upgrade patches by running the relevant patch executable from the
For more information and instructions, refer to the QuickTest Professional Installation Guide.
Supported Environments and Programs
QuickTest Professional supports creating, recording, and running tests or components using the environments and programs described below.
Virtualization Technologies
· Citrix MetaFrame Presentation Server 4.0
Standard Windows Applications
QuickTest Professional supports testing on applications based on Win32 API and MFC. QuickTest Professional does not support testing on 64-bit applications.
Visual Basic Applications
QuickTest Professional supports testing on Visual Basic 6.0 applications.
Note: Visual Basic .NET applications are supported by the QuickTest Professional .NET Add-in.
Browsers
· Microsoft Internet Explorer 6.0 Service Pack 1
· Microsoft Internet Explorer 7.0
ActiveX Grid Controls
In addition to basic support of ActiveX properties and methods, QuickTest Professional supports context-sensitive recording and verification on the following ActiveX Grid controls:
ActiveX Calendar Controls
In addition to built-in support for ActiveX properties and methods, QuickTest Professional supports context-sensitive recording and verification on the following ActiveX Calendar controls:
Microsoft Excel
When using Microsoft Excel files with QuickTest Professional (for example, to import or export data to or from the Data Table), you can work with Microsoft Excel 2000, 2002, 2003, and XP.
Microsoft Query
When using Microsoft Query with QuickTest Professional (for example, for Database checkpoints), you can work with Microsoft Query 2000, 2002, 2003, and XP.
Additional Environments
QuickTest Professional add-ins support other environments such as Java, .NET Windows and Web Forms, Windows Presentation Foundation, SAP Solutions, Oracle, Siebel, PeopleSoft, VisualAge Smalltalk, Stingray, Web Services, and terminal emulator applications. For more information on QuickTest Professional add-ins, refer to the relevant add-in documentation.
Useful Information
· You must be logged on with administrator privileges to install QuickTest Professional.
· To use QuickTest Professional's debugging capabilities, you must install the Microsoft Script Debugger. The Script Debugger can be installed during the QuickTest Professional setup or can be downloaded later from Microsoft's Windows Script Technologies site: http://msdn.microsoft.com/library/default.asp?url=/downloads/list/webdev.asp. It can also be installed using the Add/Remove Windows Components option in the Add/Remove Programs window.
· To play the new feature video demonstrations, you must first install the TechSmith video codec. Choose Help > Product Feature Movies > Install TechSmith Video Codec to install the TechSmith Screen Capture Codec (TSCC).
· If you are using concurrent licenses with QuickTest Professional 9.2, you must install version 9.0 of the Mercury Functional Testing Concurrent License Server. QuickTest Professional 9.2 is not compatible with earlier versions of the Mercury Functional Testing Concurrent License Server.
· If certain object property values in your Web site or application are generated dynamically for all objects of a given type, you can create a property pattern configuration file that instructs QuickTest Professional to automatically record the object property as a regular expression. For detailed instructions about how to use the Property Pattern feature, see PropPattern.htm located in the
· For more information about QuickTest Professional:
§ Important installation information and step-by-step installation instructions can be found in the QuickTest Professional Installation Guide. The QuickTest Professional Installation Guide is available in PDF format in the root folder of your CD-ROM. You can also find it in the
§ If you are using QuickTest Professional for the first time, use the QuickTest Professional Tutorial (Help > QuickTest Professional Tutorial) to learn how to work with the most commonly used features.
§ The What's New Help (Help > What's New) provides information about new features and supported environments in this version of QuickTest Professional.
§ Detailed information about QuickTest Professional can be found in the QuickTest Professional User's Guide and QuickTest Professional Object Model Reference. These are available with a combined index and text search, along with the Microsoft VBScript Reference, from the Help menu (Help > QuickTest Professional Help). The QuickTest Professional User's Guide is also available in PDF format in the
§ The QuickTest Professional Automation Object Model Reference is available from the QuickTest Professional Start menu program folder and from the Help menu (Help > QuickTest Professional Help > QuickTest Advanced References > QuickTest Automation). It provides syntax, descriptive information, and examples for the automation objects, methods, and properties. It also contains a detailed overview to help you get started writing QuickTest automation scripts.
Note: You must have Adobe® Reader® installed on your computer to open the printer-friendly (PDF format) versions of the QuickTest Professional documentation. You can download Adobe Reader at: www.adobe.com.
Known Problems and Limitations
This section includes information on:
· Working with Microsoft Windows Vista
· Creating and Running Tests or Components
· Creating and Running Tests and Components on Web Objects
· Creating and Running Tests and Components on Standard Windows Objects
· Creating and Running Tests and Components on Visual Basic Applications
· Creating and Running Tests and Components on ActiveX Controls
· Text Recognition Support for Windows-Based Environments
· Checkpoints and Output Values
· Quality Center Integration and Business Process Testing
· LoadRunner and Mercury Business Process Monitor Integration
Installation
· The path in which installation files for QuickTest Professional and/or external add-ins are located, and the path in which QuickTest Professional and/or external add-ins are installed, can contain only English characters.
· If you are upgrading from QuickTest Professional 8.2 or earlier, you need to first uninstall QuickTest Professional including any installed QuickTest add-ins. You can then install QuickTest Professional 9.2 and any required QuickTest add-ins using your existing seat or concurrent license keys. Note that if you are installing a QuickTest add-in for which you did not previously have a license key, you will need to install a new license key for it.
Additionally, if you are upgrading from QuickTest Professional 6.5 through 8.2, and you want to use the new commuter license feature available with the Mercury Functional Testing Concurrent License Server, version 7.6 or later, you must:
§ upgrade your concurrent license server to version 9.0 or later.
§ install a new license key on the concurrent license server
Contact Mercury Interactive Customer Support to receive a new license key, and refer to the Mercury Functional Testing Concurrent License Server Installation Guide for information on upgrading your concurrent license server.
· The Mercury Functional Testing Concurrent License Server does not support the use of Network Address Translation (NAT).
· You cannot install QuickTest Professional with a demo license over a previous version of QuickTest Professional whose demo license has expired and a regular license was never installed for it.
· If the LSHOST variable was set to a server on another domain, the server utility lsmon.exe might behave unexpectedly.
· The concurrent license does not include a demo license and does not work without a Mercury Functional Testing Concurrent License Server and license key installed.
· You cannot change the license type from seat to concurrent or vice versa when logged into the machine without administrator privileges.
Workaround: To change the license type, log into the machine as a user with administrator privileges.
· Uninstalling the QuickTest Professional Floating License Server version 6.0 may cause QuickTest to fail to retrieve a license during startup.
Workaround: Back up the lservrc file before uninstalling the QuickTest Professional Floating License Server version 6.0 and then copy the file to the new installation path or reinstall the license strings after installing the license server.
· If version 6.0.0.8169 of Pdm.dll is found on your computer, we recommend installing a newer version from: http://support.microsoft.com/support/kb/articles/Q293/6/23.ASP. This will be recognized during installation and QuickTest Professional will instruct you to download the corrected DLL from the Microsoft site.
· If you install QuickTest Professional on a computer that also has Microsoft HTML Help Workshop installed, you may receive the following error message when you try to compile a help project in Microsoft HTML Help Workshop: The file itircl.dll has not been registered correctly.
Workaround: Look for itcc.dll on your system (in \windows\system or \winnt\system32). If you find it, register it using regsvr32.exe. If the itcc.dll is not on your system at all, you can download a copy from: http://www.mvps.org/htmlhelpcenter/htmlhelp/hhtips.html#hhc6003. You may have to restart your computer before using HTML Help Workshop again.
· Installing QuickTest Professional on a network drive is not supported.
· When working with a terminal server (for example, Windows 2000 Server or Windows 2003 Server), you must connect to QuickTest using a concurrent license. Seat and demo licenses are not supported on terminal servers.
Workaround: Install a concurrent license server on the terminal server and then connect to it, or connect to a concurrent license server that is installed on a different computer.
· When uninstalling QuickTest Professional in Windows 2003, the uninstall program may stop responding in the "removing backup files" stage.
Workaround: End the msiexec.exe and Ikernel.exe processes from the Windows Task Manager and restart your computer. If this problem occurs during the installation process, end the msiexec.exe and Ikernel.exe processes from the Windows Task Manager and re-run the Setup (installation) program.
· When uninstalling QuickTest Professional in Windows 2003, the uninstall program may not complete successfully, indicating that the uninstall process could not be completed and QuickTest Professional should be uninstalled manually. This behavior occurs due to a bug that was introduced in InstallShield Developer 8.02. For more details, see http://support.installshield.com/kb/view.asp?articleid=Q111000.
Workaround: After performing an uninstall, manually delete any files that remain in the QuickTest Professional installation folder.
· If you have external 6.5.x add-ins that were installed directly on QuickTest Professional 8.0.x or later (and were not installed previously on QuickTest Professional 6.5.x), the uninstall program does not uninstall these add-ins.
Workaround: After performing an uninstall, manually delete any files that remain in the QuickTest Professional installation folder.
· An internal error (error number 0x80040707) may occur during the installation process, due to a known issue with InstallShield. Solutions for Windows XP and Windows 2003 are provided below. For more information on this error and other possible solutions, see http://consumer.installshield.com/kb.asp?id=q108167
Workaround for Windows XP: Run the installation by right-clicking the setup.exe file and selecting Run as. Clear the Protect my computer and data from unauthorized program activity check box. Click OK and continue the installation process as usual.
Workaround for Windows 2003: Run the installation by right-clicking the setup.exe file and selecting Run as. Click Run in the displayed message box, then clear the Run this program with restricted access check box. Click OK and continue the installation process as usual.
· If the error "Run-time error '424'" is displayed when installing QuickTest Professional on Windows 2003 using Citrix, perform the following:
a. Create a Mercury Interactive folder under the folder specified for the TEMP Environment Variable.
b. Run RmtAgentFix.exe from
· Uninstalling an add-in does not cause dependent add-ins to be uninstalled. For example, you can uninstall the Web Add-in without affecting the installation of the Siebel Add-in. However, the Web Add-in must be installed to load and use the Siebel Add-in.
· If the error "1628 Failed to compete installation" is displayed during a patch installation, check that you are not attempting to install a patch on a product that is not actually installed, for example, an add-in patch for a version of an add-in that is not installed.
Forward Compatibility
· If you create a test, component, application area, or resource (for example, shared object repository) in QuickTest Professional 9.0 or earlier, then open and save it in QuickTest Professional 9.2, it will no longer be supported in QuickTest Professional 9.0 or earlier.
Working with Microsoft Windows Vista
· The security settings in Microsoft Windows Vista may prevent you from performing a QuickTest Professional-related installation, such as a patch installation, or connecting to a
Workaround: To work with
a. Log in to Windows Vista as an administrator.
b. From the Control Panel, choose User Accounts > Change Security Settings.
c. Clear the Use User Account Control (UAC) to help protect your computer check box and click OK.
d. Connect to
· Due to a problem opening DCOM permissions on Windows Vista, QuickTest does not run properly on a remote Windows Vista host from
Workaround: Run RmtAgentFix.exe from the
· On Windows Vista, QuickTest Professional seat licenses may not work correctly if you are not logged on as an administrator. (Note that concurrent licenses work as usual.)
Workaround: On Windows Vista, install QuickTest Professional and any QuickTest add-ins as an administrator. To do this, right-click setup.exe from the root folder of the QuickTest Professional installation CD and choose Run as administrator.
Then, every time you open QuickTest, open it as an administrator. To do this, right-click the QuickTest Professional icon on your desktop and choose Run as administrator.
Note: For additional Windows Vista issues, see:
· Text Recognition Support for Windows-Based Environments
· Running Tests or Components in Internet Explorer
· Text Recognition in Multi-Lingual Environments
Creating and Running Tests or Components
· If you spy on an object in Visual Basic or ActiveX applications using the Object Spy, and the Record and Run settings are not set up to work with the application on which you are spying, QuickTest recognizes the object as a Standard Windows object.
Workaround: Close your application. In QuickTest, open the Record and Run Settings dialog box (Automation > Record and Run Settings) and, in the Windows Application tab, do one of the following:
§ Select the Record and run test on any Windows application option, or
§ Specify your application's details in the Application Details area. (Make sure that the Applications specified below check box is selected).
Reopen your application and then spy on it again.
· When choosing Record and run test on any open Web browser in the Web tab of the Record and Run Settings dialog box, the browser must be opened after you open QuickTest Professional. Otherwise, QuickTest will not record and run tests properly.
· QuickTest Professional uses Microsoft Regular Expressions, in which the character . represents any character except \n. In older versions of QuickTest Professional, this character represented any character.
Workaround: Change the . character to [.\n].
· In the Step Generator, if you add a method that returns an object and the assignment in the test or component is missing a Set statement, the run session will fail.
· The behavior of the Timeout argument of the Exist method was changed between QuickTest version 6.5 and version 8.x. In version 8.x and later, it behaves as follows:
§ If a timeout value is specified, QuickTest waits until it finds the object or until the timeout is reached.
§ If the value 0 is specified, the method returns the True or False value immediately.
§ For tests, if no value is specified, the value specified in the Test Settings dialog box for the Object Synchronization Timeout is used. For components, the default setting of 20 seconds is used.
To return to the 6.5 default behavior (default timeout is zero):
§ Add a 0 value for the timeout argument for all Exist statements.
§ Use the RegisterUserFunc statement in a library file to modify the behavior of Exist to equal Exist(0) and then associate the library file with all relevant tests.
Note: It is not recommended to set the Object Synchronization Timeout to 0, as this will prevent QuickTest from recognizing objects that take time to load. Additionally, there are other methods that use the Object Synchronization Timeout as the default value, such as WaitProperty and Sync.
· If you create a test containing a virtual object and run it with different screen resolution settings, operations on the virtual object may not be performed correctly.
· When running a QuickTest test from a Quality Center test set, or using QuickTest automation, the When error occurs during run session setting (File > Settings > Run tab) is ignored. Instead, QuickTest automatically continues to the next step when an error occurs. If you want to change this setting, contact Mercury Customer Support for more information.
· QuickTest does not record launching Windows Help from the Start menu.
· When the title of a window changes during recording, QuickTest may fail to recognize objects within that window while running the test or component.
Workaround: Remove the text property from the window's test object description in the Object Repository dialog box.
· Errors during the run session produce more than one error node in the results.
· The GetItemProperty method may not correctly return the text property value for WinComboBox, WinList, WinListView, VbComboBox, VbList, and VbListView test objects.
Workaround: Use the GetItem method to retrieve the text property value for these test objects.
· Running a test or component that contains a For Each statement that iterates on the ParameterDefinitions collection may fail if the collection was retrieved directly before using the For Each statement.
Workaround: Use other VBScript loop statements, such as For or While.
· Prior to QuickTest 9.0, if you specified a path for a resource starting with \.., it was considered to be a relative path. In QuickTest 9.0 and later, a path that starts with \.. is considered to be a full path, with the backslash representing the root folder of the current drive.
If you defined paths starting with \.. using earlier versions of QuickTest, you should change the path to be a standard relative path by removing the backslash (\).
· It is recommended not to use the VBScript On Error Resume Next statement, because it may interfere with the built-in error handling mechanism in QuickTest.
Workaround: Perform error handling in QuickTest using the Run tab of the Test Settings dialog box or use the OnError property of the RunSettings object through automation.
· If a test containing an On Error Resume Next statement calls a function that does not contain a separate On Error Resume Next statement, no VBScript error handling will be applied if an error occurs within the function. In earlier versions of QuickTest, On Error Resume Next statements worked correctly in this situation.
Workaround: Use QuickTest built-in error handling, or if needed, use On Error Resume Next within the function body. If you require additional information, contact Mercury Customer Support.
· The MouseMove method may behave unexpectedly in a VMware environment.
Workaround: Add the following line to the VMware configuration file (
For more information, refer to the VMware support article, number 1691 - "Unexpected Cursor Behavior in Windows Virtual Machine with "Snap To" Mouse Control Panel Option Enabled", at: http://www.vmware.com/support/kb/enduser/std_alp.php.
· When running QuickTest on a remote machine using a Remote Desktop Connection session (RDC) or using Citrix, if the remote session is minimized during the run session, or if the computer on which the application is being tested is logged off or locked, the following problems may occur:
§ the test or component run session may fail
§ steps that contain keyboard or focus operations may fail
§ the Test Results still image capture and/or the Mercury Screen Recorder may display a black screen
§ steps for which the device level replay is configured to use the mouse (instead of browser events) to run mouse operations may fail. (You set the device level replay using a Setting.WebPackage("ReplayType") statement or by setting the Replay type option in the Advanced Web Options dialog box.)
Workaround: If you are using Citrix or a Remote Desktop Connection session to run a test or component, do not minimize the session window, and make sure that the computer on which the application is being tested is not logged off or locked.
· You cannot create a call to a new action called Global, since Global is the name reserved for the Global sheet in the Data Table. If you create an action called Global, you will not be able to select the local or global data sheet when parameterizing a test object property.
· Integration with SAP eCATT is not supported. To obtain a patch that provides SAP eCATT support, contact Mercury Customer Support.
· If you define a VBScript class, it can be called only within the QuickTest action or function library in which you defined it.
Creating and Running Tests and Components on Web Objects
· If you record drag and drop steps on a Web element within the same frame, the test steps may fail during the run session if the screen resolution is not identical to the screen resolution during the recording session. This is because the target location coordinates may be different for different screen resolutions.
Workaround: If this problem occurs, adjust the Drop coordinates according to the new location.
· QuickTest Professional records changes in the edit field only on tags. Browsing operations are not recorded.
· Clicks on form tags of type POST may not run correctly.
Workaround: If this problem occurs, change the ReplayType before the click to Run by mouse operations using: Setting.WebPackage("ReplayType") = 2. It is recommended to return the replay type to the default (Run by Events) setting after the click step: Setting.WebPackage("ReplayType") = 1.
· If you record on the AutoComplete dialog for password fields using the Tab key, QuickTest Professional may record incorrectly.
Workaround: Press Enter after entering the user name or click the button for logging in.
· When working with Web objects, if a property defined for a Description object is not supported (for example, the property name is misspelled), the property name is not ignored. Therefore a
Running Tests or Components in Internet Explorer
· QuickTest Professional does not support working with tabbed browsing in Microsoft Internet Explorer.
Workaround: Disable tabbed browsing in Microsoft Internet Explorer.
§ If you install Microsoft Internet Explorer 7.0 and then open QuickTest Professional prior to actually opening Microsoft Internet Explorer 7.0 for the first time, QuickTest cannot recognize that tabbed browsing is enabled. Therefore, if you try to record or run a test or component using Internet Explorer 7.0, QuickTest does not display an error message (as it normally would).
Workaround: Open Microsoft Internet Explorer 7.0 at least once before trying to record or run a test or component from QuickTest Professional, and disable tabbed browsing.
§ When Windows Live Toolbar is installed on Microsoft Internet Explorer 6.0 and tabbed browsing is enabled, QuickTest may display an error message every time you open Internet Explorer 6.0.
Workaround: Disable tabbed browsing in Microsoft Internet Explorer 6.0 by clicking the Change Windows Live Toolbar Options button in the Windows Live Toolbar. Then, in the left pane of the displayed dialog box, click the Tabbed Browsing link and clear the Turn on Tabbed browsing check box.
· When working in Microsoft Internet Explorer 7.0, QuickTest always performs mouse operations on list objects using browser events (and not using the mouse), even if the Web device level replay or replay type option is configured to use mouse operations.
· If you record a click on an area of an image map that is not mapped to a URL in Microsoft Internet Explorer, QuickTest Professional will perform a click on the first mapped area of that map during the run session.
· QuickTest Professional does not record on customized toolbar buttons in Microsoft Internet Explorer. (It records only on the toolbar buttons that are displayed by default in the browser.)
· When working with Internet Explorer 7.0, QuickTest Professional may not recognize Web objects, even though the Web Add-in is installed and loaded.
Workaround: In Internet Explorer 7.0, choose Tools > Internet Options. In the Security tab, clear the Enable Protected Mode check box and click OK.
· QuickTest Professional does not record on the Search frame of the Microsoft Internet Explorer browser.
· QuickTest Professional does not record on the Find window of the Microsoft Internet Explorer browser.
Running Tests or Components in Netscape Browser or Mozilla Firefox
· QuickTest Professional does not support the Netscape Browser menu.
· The .Object property for Web objects is not supported for Netscape Browser or Mozilla Firefox in this version of QuickTest.
· QuickTest Professional cannot run tests or components on Netscape Browser when Netscape Browser is in minimized mode.
· The Object Spy and Checkpoint Properties dialog boxes do not retrieve the current value of edit boxes in Netscape Browser and Mozilla Firefox dialog boxes.
· The Type property of the WebButton test object has a different default value in Microsoft Internet Explorer and Netscape Browser or Mozilla Firefox. In Microsoft Internet Explorer the default value is Button, but in Netscape Browser or Mozilla Firefox the default value is Submit.
Workaround: Do not use the Type property in the description of a WebButton test object.
· Standard checkpoints on links are not supported for running on Netscape Browser or Mozilla Firefox.
· If two minor versions of Mozilla Firefox are installed on the same computer, and the earlier version (for example, Firefox 1.5.0.3) was installed after the later version (for example, Firefox 1.5.0.8), QuickTest may not recognize which is the latest version.
Creating and Running Tests and Components on Standard Windows Objects
· You cannot insert a checkpoint on a WinMenu object.
Workaround: Use the CheckProperty and CheckItemProperty methods to check specific property and item property values.
· If you record using Windows logo key shortcuts, the recording may be inaccurate.
Workaround: Use the Start menu instead of the Windows logo key when recording.
· Changing the style of a WinCalendar (from single selection to multi-selection, for example) will cause the run session to fail.
· When using the pointing hand mechanism from the Object Spy to point on MFC static text or tab controls, QuickTest may fail to return the correct object.
Workaround: Add the object to the object repository. To do this, point to the object's parent window, select the parent window object in the Object Selection dialog box, click OK, and perform one of the following in the Define Object Filter dialog box:
§ Select the All object types option to add all of the objects in the parent window to the object repository.
§ Select the Selected object types option, click the Select button, and then choose the specific object type(s) you want to add to the object repository.
After you add the object to the object repository, you can use the GetROProperty method to retrieve its run-time properties. For example:
width = Dialog("Login").Static("Agent Name:").GetROProperty("width")
MsgBox width
Creating and Running Tests and Components on Visual Basic Applications
· When working with the Visual Basic Add-in, it is recommended to choose the Record and run on these applications (opened on session start) option and then to specify the application name in the Windows Applications tab of the Record and Run settings dialog box.
If you choose the Record and run test on any open Windows-based application option, you should open the Visual Basic application after the first time you start recording.
· Combobox objects of style Simple Combobox are not supported.
Creating and Running Tests and Components on ActiveX Controls
· ActiveX objects inside Netscape Browser are not supported.
· If QuickTest Professional does not recognize an ActiveX control inside a Web page, reduce the security level within your Microsoft Internet Explorer browser.
· If an ActiveX control's internal properties have the same name as ActiveX properties created by QuickTest Professional, retrieval and verification of such properties may be problematic.
Workaround: You can access the internal properties of ActiveX control using the Object property.
· Methods performed on row and column positions for Apex, DataBound, and Sheridan grids return the values of the visible positions and not the absolute positions within the tables.
Workaround: Use the scroll bar while recording in order to display the required cells.
· When recording on an ActiveX control, wait for the recorded step to appear before moving the mouse. Moving the mouse too quickly may result in a corrupted Active Screen for that step.
· The AcxTable.RowCount method is not supported for the Microsoft Data Bound Grid control.
· QuickTest may fail to properly capture some of the internal properties of windowless ActiveX controls, such as x, y, height, and width.
· Recording on windowless ActiveX controls may result in some additional steps added to your test or component (such as a Click method in addition to a Set method on an AcxRadioButton object). These additional steps will not cause the run session to fail.
· Drag and Drop operations on windowless ActiveX controls are not supported.
· QuickTest may fail to recognize windowless ActiveX controls identified by programmatic descriptions.
Workaround: Add Windowless=True to the programmatic description.
set myButton = Description.Create
myButton("progid").Value = "Forms.CommandButton.1"
myButton("Windowless").Value = True
Dialog("ActiveX Collection Client").AcxButton(myButton).Click
Text Recognition Support for Windows-Based Environments
· In recent versions of QuickTest Professional, text-capturing test object methods, reserved object methods, text/text area checkpoints, and text/text area output value steps were not available for objects in Windows-based environments.
In QuickTest Professional 9.2, you can use the text and text area checkpoint or output value commands to verify or retrieve text in your Windows-based objects. Alternatively, you can use the testobject.GetText (for Terminal Emulator objects), testobject.GetVisibleText, or testobject.GetTextLocation test object methods, or the TextUtil.GetText or TextUtil.GetTextLocation reserved object methods to capture the text you need.
When capturing text for a text/text area checkpoint or output value step, or using one of the above mentioned methods, QuickTest tries to retrieve the text directly from the object using a Windows API-based mechanism. If QuickTest cannot capture the text this way (for example, because the text is part of a picture), it tries to capture the text using an OCR (optical character recognition) mechanism provided by ABBYY Software Ltd.
You can change the default behavior, if needed, by modifying the values in the following registry key: HKEY_CURRENT_USER\SOFTWARE\Mercury Interactive\QuickTest Professional\MicTest\OcrEngine
Important: The Windows Registry Editor is an advanced tool for changing settings in your system registry. You should not edit your registry unless absolutely necessary. If there is an error in your registry, your computer may not function properly.
The following table lists the possible value entries for the OcrEngine key.
| 1 -Enabled. This instructs QuickTest to use the OCR mechanism according to the mode value. (Default) 0 - Disabled. QuickTest will not use the OCR mechanism regardless of the mode value. (Same as setting the mode value to 0 - No OCR.) | |
| Indicates the height or width of the text block in pixels, for example, 29. Modify both value entries to instruct the OCR mechanism to treat the object as a single text block. Note: Sometimes, text on small objects or in a small text area is not captured (or is captured incorrectly). In cases such as these, specifying the maximum text area size in pixels may help improve text recognition. This causes the OCR mechanism to focus on a specific area and treat it as a single text block (and not as multiple text blocks, as it would normally do). Tip: You can use QuickTest's Object Spy to find the height and width of the object. | |
| 0 - No OCR. Instructs QuickTest to use only the Windows API-based mechanism (and not the OCR mechanism) to retrieve text from the object. 1 - Windows API/OCR. Instructs QuickTest to first try to retrieve text directly from the object using the Windows API-based mechanism. If no text can be retrieved, QuickTest tries to retrieve text using the OCR mechanism. (Default) (Highly recommended when working with CJK languages.) 2 - OCR/Windows API. Instructs QuickTest to first try to retrieve text from the object using the OCR mechanism. If no text can be retrieved, then QuickTest uses its Windows API-based mechanism to retrieve text from the object. 3 - OCR only. Instructs QuickTest to use only the OCR mechanism (and not the Windows API-based mechanism) to retrieve text from the object. (Required when working with Windows Vista.) | |
| Indicates the language dictionaries that the OCR mechanism uses when retrieving text from the object. Enter a comma to separate the languages, for example: English,German,Spanish,French Note: Combined hieroglyphic languages (CJK - Chinese, Japanese, or Korean) and non-hieroglyphic languages are not supported. For example: English,Japanese | |
| Indicates the path of the .ini file containing the customized profile for the OCR mechanism. Note: If the OCR mechanism cannot retrieve any text from the object, you can fine tune its settings to help it recognize the objects in the application being tested. You do this by creating an .ini file containing a customized profile with the required property settings, such as font, font size, and contrast. This .ini file must be in ABBYY FineReader format. For more information, search the Knowledge Base area of the Mercury Customer Support Web site (http://support.mercury.com/cgi-bin/portal/CSO/kbBrowse.jsp). |
Note: Although these text-capturing options and methods are now available for Windows-based objects, keep in mind that any text-recognition mechanism may occasionally capture unwanted text information (such as hidden text and shadowed text), or may misinterpret the text content.
Additionally, text-capturing steps may behave differently in different run sessions depending on the operating system version you are using, the installed service packs, other installed toolkits, the APIs used in your application, and so on.
Therefore, when possible, it is highly recommended to check text from your application window by inserting a standard checkpoint, output value, or GetROProperty method for the object containing the desired text to retrieve the value of it's text (or similar) property.
For more information, refer to the relevant sections in the QuickTest Professional User's Guide, and search for the GetText, GetVisibleText, and GetTextLocation methods in the relevant sections of the QuickTest Object Model Reference Help.
· On Windows Vista 32-bit or any 64-bit operating system, QuickTest text recognition features (such as text checkpoints and output values, GetVisibleText and GetTextLocation test object methods, and TextUtil.GetText and TextUtil.GetTextLocation reserved object methods) are limited and are not always reliable.
Workaround: On Windows Vista, you can improve text recognition by applying the Classic Windows theme and by setting the mode key in the Windows Registry Editor to 3 - OCR only (described above).
· If a "windowless" ActiveX radio button object is not first activated by clicking on it (AcxRadioButton.Click) or by using the Set method, a step containing the AcxRadioButton.GetVisibleText method will return an error stating that the object is not visible.
Workaround: Insert a step using the Click or Set methods prior to any step that uses the GetVisibleText method on a "windowless" ActiveX radio button object.
Active Screen
· When recording on WinMenu objects, the Active Screen is not captured.
· When the Active Screen displays a Java applet or ActiveX control within a Web page, the applet or control is for viewing purposes only and you cannot perform operations (for example, create checkpoints, add methods, and so forth) on the object.
Workaround: Record an operation on the Java applet/ActiveX control to create a step on the object with the ActiveX Add-in and/or Java Add-in (available separately) loaded. Then you can create a checkpoint, parameterize a step, or add a method from the individual Java applet/ActiveX control in the Active Screen.
Automation
· Using an automation script to open a test created using QuickTest 8.2 or earlier may take some time since the test is automatically converted to the QuickTest 9.2 format. Note that when opening a test in this way, you cannot choose whether or not to convert it. Tests are automatically converted to the new format and cannot be opened in earlier versions of QuickTest after they have been converted and saved.
· The SetObjectRepositoryAsDefault method and ObjectRepositoryPath property path are no longer supported.
Workaround: Update your automation scripts to use the methods and properties of the ObjectRepositories collection instead. For more information, refer to (Help > QuickTest Professional Help > QuickTest Advanced References > QuickTest Automation).
Data Table
· If you import a Microsoft Excel table containing a combo box or list cells, conditional formatting, or other special cell formats, the formats are not imported and the cells are displayed in the Data Table with fixed values.
· Entering a very large number in the Data Table may cause unexpected behavior.
Checkpoints and Output Values
· Checkpoints that contain more than 64K of data may run slowly.
· The Focused property in a checkpoint inserted while recording will always have the value False.
Workaround: Change the value of the property manually or perform an update run operation on the test or component.
· Checkpoints on page source/HTML tags cannot be inserted from the Active Screen and must be inserted while recording. These checkpoints may fail during the first run session.
Workaround: Perform an update run (Automation> Update Run Mode) of your test or component before you run a test or component that includes a page source/HTML tag checkpoint.
· If you insert checkpoints from the Active Screen when you are working with an application containing a browser control rather than with a Web browser, your checkpoints may fail.
Workaround: Insert checkpoints while recording.
· When inserting a checkpoint from the Active Screen on a VbComboBox object that checks the sellength or seltext property, the captured value may be incorrect.
Workaround: Update the value manually.
· Checkpoints are not supported for WinComboBox objects of style Simple Combobox.
· When you create a standard checkpoint for a Calendar control (for WinCalendar, AcxCalendar, and SwfCalendar test objects), the Date and Time properties are not selected by default.
· ActiveX table checkpoints capture only visible rows in data bound grids.
· When you insert a checkpoint on an ActiveX table from the Active Screen, the browser (or application) must be open to the same page (or screen). Otherwise, some data from the ActiveX table will be missing.
Workaround: Create ActiveX table checkpoints while recording.
· Checkpoints and output values for ActiveX properties of type VT_DISPATCH are not supported.
· Checkpoints and output values for write-only ActiveX properties are not supported.
· For database checkpoints, the format of captured values varies depending on the specific system settings. For example, date and time values may be set to different formats.
Workaround: If you are running the test or component on a different system than the one you used to record the test or component, confirm that the systems use the same format settings.
· When you create a database checkpoint on one machine and try to run it on different machine, you should have the same ODBC driver installed on both machines.
· If you perform an update run (Automation > Update Run Mode) on a test that contains checkpoints or output values for windowless ActiveX controls, and then you rerun the test, the run session may fail. This is because a hidden property called "windowless" is missing from the test object description.
Workaround: You can either relearn the problematic ActiveX controls, or you can add the "windowless" property with a value of 1 to all problematic, windowless ActiveX controls.
XML Checkpoints and Output Values
· When executing an XML checkpoint on an XML file that contains > as a value, an error message may occur.
· When you add a new value node to an XML node, in some cases the new value may not be displayed.
Workaround: Close the Edit XML as Text dialog box and reopen it to display the new value node correctly.
· When inserting an XML file checkpoint on a file that cannot be loaded, or a file that is formatted incorrectly, you may receive an error message.
· Creating and running XML checkpoints for large XML documents may take a few minutes.
Object Repository
· If you modify the name of a test object in the Object Repository while your test or component script contains a syntax error, the new name is not updated correctly within your test or component script.
Workaround: Clear the Automatically update test and component steps when you rename test objects check box (Tools > Options > General tab) and perform the renames in the script manually (recommended) or solve the syntax error, and then close and reopen the document in QuickTest to display the renamed objects in your steps.
Mercury Screen Recorder
· When using the Mercury Screen Recorder on Windows Vista, setting the Window's display settings to the Classic Windows theme may improve performance.
· Record and run session performance may be affected adversely when using the Mercury Screen Recorder on a computer running Windows Vista 32-bit or any 64-bit operating system. This is because some capture drivers (such as Blueberry or ASUS' Enhanced Display Driver) cannot be installed on these operating systems. Note that if you try to install the capture driver from the Screen Recorder Options dialog box while working on one of these operating systems, an error message is displayed.
· The Mercury Screen Recorder is not supported when using Citrix or Windows Server 2003.
· You cannot use the Mercury Screen Recorder when running business process tests. However, you can use the Mercury Screen Recorder to record and play movies of individual business components created in QuickTest.
· When a Quality Center client is installed on the same computer as QuickTest Professional, uninstalling QuickTest Professional may remove the association of movie (FBR) files. This may prevent you from viewing movies associated with defects in Quality Center using the Mercury Micro Player.
Workaround: Re-associate the movie files with the Mercury Micro Player, as follows:
a. Choose Start > Programs > QuickTest Professional > Tools > Mercury Micro Player to open the Mercury Micro Player.
b. Choose File > Options to open the Mercury Micro Player Options dialog box. Then select the Associate FBR files with this Player check box to associate the files directly with the Mercury Micro Player.
Documentation
· All Help topics under the VBScript Reference > VBScript, VBScript Reference > Script Runtime, and VBScript Reference > Windows Script Host sections are from Microsoft. These Help files were not prepared by Mercury and Mercury is not responsible for their content. These help files were taken directly from the Microsoft Script56.chm help file, downloaded from http://msdn.microsoft.com/library/default.asp?url=/downloads/list/webdev.asp.
The information under the VBScript Reference heading may contain errors, problems, or other limitations. Mercury makes no representations whatsoever as to the accuracy, adequacy, reliability, currentness, completeness, suitability or applicability of the information under the VBScript Reference heading. Mercury is not responsible for any damages, including the loss of time, which may result from using the information in the help files under the VBScript Reference heading.
· The Previous buttons on Help topic pages may not display the expected page.
Workaround: Use the table of contents, index, or search to find the topic you need.
· When Mozilla Firefox is the default browser, the Readme files for installed patches cannot be directly viewed by clicking the relevant links from the Product Information page.
Workaround: Save the patch Readme file locally and open it with Microsoft Internet Explorer or with any text viewer.
· A newer version of the Mercury Functional Testing Concurrent License Server Installation Guide has been released, but the updated PDF is not included in the Mercury Functional Testing Concurrent License Server CD-ROM.
Workaround: Refer to the printed Mercury Functional Testing Concurrent License Server Installation Guide included with your QuickTest or Mercury Functional Testing 9.2 Concurrent Package, or download the latest Mercury Functional Testing Concurrent License Server Installation Guide PDF from the Mercury Customer Support Web site.
· On some computers, links from a PDF to an external Web site (for example, http://www.adobe.com) do not work.
Workaround: Manually navigate to the required Web site.
Quality Center Integration and Business Process Testing
The Business Process Testing issues described below relate to working with business components and business process tests in QuickTest. For information on issues related to working with business components in
· For test management, QuickTest Professional integrates with
For Business Process Testing, QuickTest Professional integrates with
·
§ When working with tests or components stored in Quality Center, you should not use Unicode values (such as the name of the test or component, the name of an application area, the default value of a test, action, or component parameter, method argument values, and so forth).
§ Data that is sent to QuickTest from
§ QuickTest results containing Unicode characters may appear corrupted in the
For additional information on QuickTest Professional Unicode issues, see Multilingual Support.
· Before opening or running a test or component from
· Before using the Business Component Upgrade Tool (Start > Programs > QuickTest Professional > Tools > Business Component Upgrade Tool), you must open the current installation of QuickTest at least once. Otherwise, the Business Component Upgrade Tool may not be able to open QuickTest.
· Renaming a QuickTest test or component from
Workaround: To rename a test or component, open it in QuickTest and rename it using the Save As option. If the test or component has already been renamed from
· When working with Business Process Testing, you should not work with the same business component in
· When running business process tests with a large number of iterations and business components, you may encounter memory availability problems after some time.
Workaround: Use the Restart testing tool after __ runs option in the Remote Agent Settings dialog box (Start > Programs > QuickTest Professional > Tools > Remote Agent) to count the number of business components being run and automatically restart QuickTest at the end of the first business process test iteration reached after passing the defined threshold.
· If you created a business component in QuickTest 8.2.x without an associated application area, then when you open it in QuickTest 9.0 or later and choose to convert it to the current format, any customized business component settings are cleared, and therefore the business component run will fail.
Workaround: After converting the business component, you must associate it with an application area that contains the required resources and settings.
LoadRunner and Mercury Business Process Monitor Integration
· LoadRunner run-time settings are not relevant for QuickTest GUI Vusers. Any required settings must be defined in the QuickTest test settings. When using the LoadRunner Scheduler, the number of passed iterations shown in the Vusers window of the LoadRunner Controller is inaccurate.
· QuickTest SAP GUI Vusers are not supported by LoadRunner.
· External QuickTest resources can be used either by defining them in the QuickTest test with an absolute path or by adding them as supplementary files and transferring them to Load Generator in the QuickTest test folder.
Multilingual Support
Overview
· QuickTest Professional is Unicode compliant and supports multilingual environments and applications with the following exceptions:
§ Names and paths of tests, components, application areas, and resources (for example, function libraries, object repositories, and recovery scenarios) are not Unicode compliant and therefore should be specified either in English or in the language of the operating system.
§
Customer Support
· You can access the Customer Support Web site in Japanese at: http://www.mercury.com/jp/services/support/.
Useful Information
· You can download the Microsoft Debugger for far-eastern Windows operating systems from Microsoft's Windows Script Technologies site:
§ Chinese Windows. http://www.microsoft.com/china/scripting
§ Japanese Windows. http://www.microsoft.com/japan/msdn/scripting/default.asp
§ Korean Windows. http://www.microsoft.com/korea/scripting
Known Problems and Limitations
Text Recognition in Multi-Lingual Environments
· When working with CJK (Chinese, Japanese, or Korean) characters on Windows Vista 32-bit or any 64-bit operating system, QuickTest text recognition features (such as text checkpoints and output values, GetVisibleText and GetTextLocation test object methods, and TextUtil.GetText and TextUtil.GetTextLocation reserved object methods) are limited and are not always reliable. For more information, see Text Recognition Support for Windows-Based Environments.
Workaround: Display the fonts for these languages at 22 points or higher.
Recording and Running Tests and Components
· QuickTest may behave unexpectedly when using multi-byte string inputs if it is installed on a VMware operating system.
Workaround: Set the hardware acceleration of the display driver to None. If this does not work, uninstall the VMware display adapter.
· Manually editing scripts in the Expert View using the Korean language on Windows XP or Windows 2003 operating systems may cause QuickTest to malfunction.
Workaround: Choose Control Panel > Regional and Language Options > Languages tab > Details > Advanced tab and select the Turn off advanced text services check box.
Note that you may need to restart your computer after setting this option.
· There may be cases during a run session when QuickTest loses the focus of the application you are testing when working in a Korean, Chinese, or Japanese operating system. This may result in a loss of data during the run session.
Workaround: Run an Activate method on the application's window to ensure focus on the window before performing the next step. For example:
· Low-level recording mode is not fully supported for multibyte character input.
· When using Chinese IME to record multiline objects:
§ Some mouse operations on the IME are recorded and are not executed during the run session.
Workaround: Avoid performing mouse operations on the IME window during recording.
§ Selecting a character from the IME's Candidate window is not supported.
· Running the Type method on computers with Japanese, Korean, or Chinese operating systems may not work as expected.
Workaround: Add an English input locale to the computer (using the Regional Options or Regional and Language Options in your Control Panel).
· Multibyte punctuation symbols and other multibyte special characters, such as multibyte question marks, multibyte spaces, and multibyte brackets, should not be used when naming tests, components and application areas.
Running Tests or Components in Netscape Browser
· In Netscape Browser, running on UTF8 and EUC encoded sites are not supported.
Running Tests or Components in Mozilla Firefox
· If a test or component contains a step that closes a Mozilla Firefox browser, QuickTest may behave unexpectedly when that step is reached during a run session.
Workaround: Do not include a step that closes a Mozilla Firefox browser.
Support for Web Objects
· The AutoComplete operation on edit fields is not recorded.
Workaround: You can disable the AutoComplete feature in Microsoft Internet Explorer by selecting Tools > Internet Options > Advanced and deselecting the Use inline AutoComplete under the Browsing options in Microsoft Internet Explorer.