HP Unified Functional Testing Readme
Software Version: 12.02
Document Release Date: December 2014
Software Release Date: December 2014
The most updated version of this Readme is located here (requires an HP Passport).
To check for recent updates of any other UFT documentation, or to verify that you are using the most recent edition, visit the HP Software Product Manuals site (requires an HP Passport).
This file provides the following information about UFT 12.02:
Minimum and Recommended System Requirements and Supported Environments
Note: If the information in this Readme conflicts with information in any other UFT documentation released at the same time, the information in this Readme takes precedence.
Unified Functional Testing 12.02 adds the following new features, product enhancements, and supported technologies:
Support for Mobile: You can now configure UFT to connect to the HP Mobile Center and record and run functional tests on mobile applications running on real devices hosted on HP Mobile Center.
HP Mobile Center addresses the challenge of optimizing mobile app quality by integrating natively with UFT. Connect your devices to HP Mobile Center and immediately start testing.
New Demo Application: UFT now has a fully unified demo application on which you can practice and demonstrate both GUI and API testing.
Note: The older Flights GUI and Flights API applications (from UFT version 12.01 and earlier and QuickTest) are still accessible from the installation. You can find them here:
<UFT installation folder>/samples/flight/app/flight4a.exe (for the Flight GUI application)<UFT installation folder>/samples/flight_service/HPFlights_Service.exe (for the Flight API application)These applications will be removed from the UFT installation and deprecated in the upcoming release.
UFT now supports the following technologies:
Important installation information and step-by-step installation instructions for UFT can be found in the HP Unified Functional Testing Installation Guide. The Installation Guide is available in PDF format in the root folder of the Unified Functional Testing DVD.
Alternatively, you can use the HP Unified Functional Testing Installation QuickStart Sheet, which provides the details you need to know for a standard UFT installation in a single, two-sided sheet.
You can also open these documents from the Unified Functional Testing Help after you install UFT.
By default, the silent UFT installation does not configure the DCOM settings that are required for remotely controlling UFT using automation scripts.
To instruct the installation to configure the DCOM settings for automation scripts, add CONF_DICOM_UFT=1 to your silent installation command. For more detail, see the HP Unified Functional Testing Installation Guide.
Caution: Configuring these DCOM settings may expose the UFT computer to security risks.
For QuickTest tests or components:
When trying to open a test or component saved in QuickTest 9.5, UFT will open the asset in read-only mode. If you try to open a test or component last saved in a version of QuickTest earlier than 9.5, an error message is displayed in the UFT Error Pane.
If the asset is saved in the file system, you must first open it in QuickTest 10.00 or 11.00 to upgrade it.
If the asset is saved in Quality Center or ALM, you must use the QuickTest Asset Upgrade Tool for HP ALM (available with the QuickTest Professional 10.00 or 11.00 DVD).
Assets last saved in QuickTest 10.00 or later can be opened in UFT.
Sharing values between components in a BPT test cannot be done using user-defined environment variables. Instead, use user-defined run-time settings that you create using the Setting.Add method.
If your QuickTest components used any user-defined environment variables, you must change them to use run-time settings when you upgrade to UFT. For details on how to add and use run-time settings, search for "Add and remove run-time settings" in the HP Unified Functional Testing User Guide.
For Service Test tests or components:
UFT 12.02 provides a Batch Upgrader command line tool, STBatchUpgrader.exe, located in the <UFT installation>/bin folder. This tool lets you run a batch file to upgrade tests last saved in Service Test, version 11.10 or 11.20, making them compatible for UFT 12.02.
If you do not upgrade your tests with the Batch Upgrader tool, when you open a test created in version 11.10 or 11.20, it prompts you to upgrade the test.
For details, on the Batch Upgrader command line tool, see the UFT Help, available from the UFT Help menu.
For tests and components created in Service Test 11.00, you must first open and save them in Service Test 11.10, before you can upgrade them to UFT 12.02.
If you upgrade to UFT 12.02 from an earlier version of UFT shortly after using UFT to run GUI tests from ALM, make sure to stop the Remote Agent (if running) before running tests from ALM again. To stop the previous Remote Agent process, in the Windows system tray, right-click the Remote Agent icon and select Exit.
If you plan to run tests of a Web Service using security created using Service Test or earlier versions of UFT, you must have the .NET Framework 3.5, WSE 2.0sp3 package, and WSE 3.0 package installed on your computer.
These prerequisites are not provided with the UFT installation. If they are not installed on your computer, you can install them from the following locations on the DVD:
NET 3.5 Framework: DVD/prerequisites/dotnet35_sp1/donetfx35_sp1.exe
WSE 2.0 sp3: DVD/prerequisites/wse20sp3/MicrosoftWSE2.0SP3Runtime.msi
WSE 3.0: DVD/prerequisites/wse30/MicrosoftWSE3.0Runtime.msi
In previous versions of UFT, QuickTest, and Service Test, the installation included sample applications for GUI testing and API testing which were accessible from the Start Menu. Although these applications are no longer accessible from the Start Menu, you can find the sample applications in the file system:
<UFT installation folder>/samples/flight/app/flight4a.exe (for the Flight GUI application)<UFT installation folder>/samples/flight_service/HPFlights_Service.exe (for the Flight API application)After you install, you may want to refer to the following items, available from the UFT Help menu.
What’s New. Provides details about new or enhanced features and new environment support in UFT 12.02, compared to UFT 11.5x.
UFT Tutorials. If you are using UFT for the first time, use the UFT GUI Testing Tutorial and UFT API Testing Tutorial to learn how to work with several of the most commonly used features.
UFT Help. A single-point of access for comprehensive product information, including installation guides, user guides, and language references in Help and/or PDF format. The Using the Help section describes how to navigate, use, and get updates for the Unified Functional Testing Help.
If you install a hotfix or patch over UFT 12.02, information about that patch is described in the corresponding hotfix or patch readme.
If the information in a hotfix or patch readme conflicts with information in the HP Unified Functional Testing Readme or any other UFT documentation, the information in the hotfix or patch readme takes precedence.
This section includes:
For a complete list of all supported operating systems, browsers, and development environments, see the HP Unified Functional Testing Product Availability Matrix, available in the <UFT installation>\help folder, or get the latest version from the HP Support Matrix page site.
| Minimum | Recommended | |
| Computer Processor: | 1.6 Ghz or higher | 3 Ghz or higher |
| Operating System: | Windows 7 Service Pack 1 (32-bit or 64-bit) | Windows 7 Service Pack 1 (32-bit or 64-bit) |
| Memory: |
Minimum of 2 GB when no more than three add-ins are loaded simultaneously Note:
|
4 GB or more of RAM |
| Hard Disk Drive: | 5400 RPM | 7200 RPM or faster |
| Color Settings: | High Color (16 bit) | High Color (16 bit) |
| Graphics Card: | Graphics card with 64 MB video memory | Graphics card with 64 MB or more video memory |
| Free Hard Disk Space: |
2 GB of free disk space for application files and folders You must also have an additional 1 GB of free disk space on the system disk (the disk on which the operating system is installed). |
20 GB of free disk space for application files and folders You must also have an additional 1 GB of free disk space on the system disk (the disk on which the operating system is installed). |
| Browser: | Microsoft Internet Explorer 8.0 | Microsoft Internet Explorer 9.0 |
The information in this section is up-to-date at the time of this release. Refer to https://hpln.hp.com/page/uft-system-requirements for the most updated information.
This section includes important notes and known limitations and workarounds:
This section includes information that is important for you to know before you install UFT, and includes the following:
If you are using the UFT Add-in for ALM and plan to work with ALM version 11.52, you must ensure that the Microsoft Visual C++ 2005 SP1 Redistributable Package is installed on your computer. You can download this package file from http://www.microsoft.com/en-us/download/details.aspx?id=5638.
If the HP UFT Files in Use dialog box is displayed during the installation process:
Select the Close the application and attempt to restart them option. UFT automatically closes the needed applications and continues the installation.
If you are upgrading from an earlier version of UFT, restart the computer before upgrading.
If after restarting, the HP UFT Files in Use dialog box lists Explorer as the open application, you can do one of the following:
You cannot install Microsoft Office 64-bit on a machine with UFT.
Workaround:
Re-install the Microsoft Office Access database engine from the prerequisites\msade2010 folder of the UFT12.02 setup directory, using the following command:
<UFT root directory>\prerequisites\msade2010\AccessDatabaseEngine.exe /passive
The path in which installation files for UFT are located, and the path in which UFT is installed, can contain only English characters.
The version of the pdm.dll file installed with the Microsoft Script Debugger (which is part of UFT’s Additional Installation Requirements) is obsolete and can cause problems when you try to debug GUI tests. If you want to debug GUI tests in UFT, make sure that you have a newer version of this file installed and registered.
The pdm.dll file is installed and registered with Microsoft Visual Studio and Microsoft Office. It is also installed, but not registered, with Microsoft Internet Explorer (version 8 and above).
If the currently registered version of the pdm.dll file is lower than 9, then uninstall the Microsoft Script Debugger (if installed) and repair the installation of the last of these products to be installed. (Check registry for pdm.dll version: HKEY_CLASSES_ROOT\CLSID\{78A51822-51F4-11D0-8F20-00805F2CD064}\InprocServer32)
If you need to use the pdm.dll file installed with Microsoft Internet Explorer, make sure you have administrator privileges and do the following:
Locate the pdm.dll file.
This file is usually located in c:\program files(x86)\internet explorer\ or c:\program files\internet explorer.
Move the pdm.dll file and the msdbg2.dll file from the same folder to a different location (registering them from the original location behaves differently).
Run the following commands:
regsvr32 <full path to pdm.dll>\pdm.dll
regsvr32 <full path to pdm.dll>\msdbg2.dll
If you install UFT 12.02 while the QTPNET_00015 patch (a QuickTest 10.00 patch) is installed on your computer, UFT may behave unexpectedly.
Workaround:
UFT supports the Sentinel RMS License Manager version 8.4.0 as its concurrent license server. Earlier versions of the concurrent license server are not supported.
After installing LoadRunner 11.50, UFT does not work.
Workaround: After uninstalling LoadRunner 11.50, perform a repair installation for UFT.
Sprinter: If you are using both UFT and Sprinter on the same computer, and you uninstall either UFT or Sprinter, you must run a Repair for the installation of the remaining product.
UFT cannot record over applications that have a higher integrity level, such as setup programs or programs that are run as administrator.
Workaround: Run UFT as administrator if you need to record over an application with a higher integrity level.
When using UFT on Windows 8.1 or Windows 2012 R2, if you want to use API tests and components, make sure that you have MSU (Microsoft Update) KB2887595 installed.
Web Add-in
If you are testing applications in Google Chrome version 31 or later, Chrome automatically downloads and installs the HP Unified Functional Testing Agent for Google Chrome the first time you open Chrome after UFT is installed.
Note: If you are using a version of the UFT Agent for Google Chrome from UFT version 12.00 or earlier, you must enable the downloaded extension and remove the previous version of the UFT Agent extension.
In the following cases, you must manually enable the UFT Agent for Google Chrome extension:
You have no internet connection.
You have not enabled the automatic updates for Google Chrome.
You are using Google Chrome version 30 or earlier.
For details on manually enabling the extension, see the task on How to Enable the UFT Agent for Google Chrome Extension in the Web section of the HP Unified Functional Testing Add-ins Guide.
If you previously used UFT 12.00 to test Web applications on Safari, then after you upgrade UFT you must reinstall the UFT Connection Agent on the Mac from the current UFT version.
The UFT Connection Agent preferences and the Unified Functional Testing Agent Safari extension preferences are reset to their defaults.
If you want to use non-default preferences, for example, if you configured UFT to use a port other than the default 8822 for remote connections, then you must reconfigure these preferences on the Mac computer.
This is required because of significant changes in the UFT Connection Agent's preferences, due to security enhancements in UFT 12.01. For example, the UFT Connection Agent now uses different ports to communicate with UFT and the Safari extension. In UFT 12.00, the same port was used for both communications.
For more details on what you can configure for the UFT Connection Agent, see the section on the UFT Connection Agent in the Web section of the HP Unified Functional Testing Add-ins Guide.
If you previously had QuickTest 11.00 installed on your computer and you installed one of the patches or hotfixes that added support for working with the Google Chrome browser (QPTWEB00088 or another Chrome-related patch or hotfix), you must delete your user profile in the Chrome browser before you can use UFT to test applications in Chrome.
To do this, open the Chrome Settings window in your Chrome browser. In the Users section, click the Delete this user button.
Windows Runtime Add-in
UFT cannot record or spy on a Windows Runtime application that is in a suspended state.
Workaround: Restart the Windows Runtime application
WPF Add-in
UFT does not treat text block elements as child objects of WPF objects, such as lists, treeviews, and tables. Therefore, they will not be returned in a ChildObjects statement, nor will they be learned as test objects when you select to learn a WPF object and its children.
If you want to work with the text block elements of a WPF object, use a GetItem() or GetItemProperty() statement.
Note: The above behavior was implemented after QTP 11.00. Therefore, if you have ChildObject steps in existing tests that previously returned these text block elements, those tests may fail or produce unexpected results. In this case, update such steps as recommended above.
SAPUI5
The index for the SAPUIList.GetItem or SAPUIMenu.GetItem methods changed from 0-based to 1-based. If you used these methods in your tests in UFT 12.01, update your tests accordingly to ensure that they run correctly.
SiebelOpenUI
When recording on a SblOUIAdvancedEdit or SblOUIComboBox object, UFT does not record the Set method correctly if you change the object's value in the popup control inside the object (such as the calculator, calendar or combo box).
Workaround: Click inside the popup control and then change the value.
Web Services Add-in (Discontinued)
The Web Services Add-in that was provided with QuickTest is not included in UFT. Instead, use the UFT API testing features to test your Web Services.
If you need to work with your existing QuickTest Web Services Add-in assets in UFT, contact HP Software Support or your HP Software provider.
If a user with administrator privileges installs the Unified Functional Testing Add-in for ALM or performs a Repair operation on the Run Results Viewer, and then you or another user runs UFT on that computer as a user without administrator privileges (without write permissions to the HKCR hive in the registry), UFT will lose its support for 64-bit applications.
Workaround: Log in as an administrator and do one of the following:
Repair UFT
Double-click <UFT installation>\bin64\Mediator64.exe
If your computer has two versions of an application, where one is 32-bit and the other is 64-bit (for example, calc.exe), then UFT always opens the 32-bit version when it performs a step to open that application. This occurs when the operating system performs a redirect from the Program Files folder to the Program Files (x86) folder, and from the System32 folder to the SysWow64 folder.
Workaround: To specify a 64-bit version, make sure that the step explicitly states the path to the 64-bit application. For example, you can copy the 64-bit application to any folder (other than the Program Files folder that is redirected to Program Files (x86)) and specify that path instead.
When working with .NET or WPF Add-in extensibility for a 64-bit Windows Forms process, the custom server DLLs must be built using the Any CPU option.
The following commands or features, which were supported by preceding versions of QuickTest or Service Test, are not available in UFT:
Split Action command
Process Guidance (and Process Guidance Management)
Edit > Optional Step command
(However, the command is still available in the context (right-click) menu, and the OptionalStep statement can also be added manually in the Editor.)
Window Themes (View option)
Insert Report dialog box
Send Feedback and Win (Help menu command)
Show Run Test command (previously in Service Test)
In the Index tab, when you type in the edit box to search the index, the response is slow.
On some operating systems or after installing certain Windows service packs or updates, you may not be able to view the content of the CHM-based Advanced References Help files.
Workaround:
Some user interface items are not localized, for example:
Tooltips in the Properties Pane
Tooltips and context menu in the editor of the File Content Checkpoint dialog box
Context menu for the search box in the toolbar of the File Content Checkpoint Properties dialog box
Compilation information in the Output pane for an API Test
Error messages when importing a WSDL Web service
The string displayed for a Date parameter in the Add Input Parameter dialog box or Properties pane of an API test
Warning or error messages in the Test Batch Runner, for example, when saving files using the Save As command
Some of the UFT user interface related to XML operations
XML Validation results in the Run Results Viewer
Workaround: Install the relevant user interface language .NET Framework Language Pack. You can download it from the Microsoft download center: http://www.microsoft.com/en-us/download/default.aspx
The image displayed when selecting View Sample Snapshot in the Asset Comparison tool is not localized
If your JSON file contains non-ASCII characters, you should save this file with UFT-8 encoding. Otherwise, the characters in your file may not display correctly in UFT.
You can visit the HP Software Support web site at: https://softwaresupport.hp.com
This web site provides contact information and details about the products, services, and support that HP Software offers.
HP Software support provides customer self-solve capabilities. It provides a fast and efficient way to access interactive technical support tools needed to manage your business. As a valued support customer, you can: search for knowledge documents of interest, submit and track progress on support cases, submit enhancement requests online, download software patches, and more.
To access the self-solve knowledge base or to search for the latest versions of HP Software manuals, visit the Knowledge and Manuals Library.
Most of the support areas require that you register as an HP Passport user and sign in. Many also require a support contract. To register for an HP Passport ID, go to: https://softwaresupport.hp.com and click Register.
To find more information about access levels, go to: https://softwaresupport.hp.com/web/softwaresupport/access-levels.
The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
The information contained herein is subject to change without notice.
Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.
© Copyright 1992-2014 Hewlett-Packard Development Company, L.P.
Adobe® and Acrobat® are trademarks of Adobe Systems Incorporated.
Google™ and Google Maps™ are trademarks of Google Inc
Intel® and Pentium® are trademarks of Intel Corporation in the U.S. and other countries.
Microsoft®, Windows®, Windows® XP, and Windows Vista ® are U.S. registered trademarks of Microsoft Corporation.
Oracle and Java are registered trademarks of Oracle and/or its affiliates.
UNIX® is a registered trademark of The Open Group.
Send documentation feedback to HP