Upgrading documents from previous versions

If you have documents created in QuickTest, Service Test, or previous versions of UFT, you can upgrade them for UFT.

Upgrading QuickTest tests or components

  • Files last saved in QuickTest 9.5

    UFT will open the asset in read-only mode.

  • Files last saved in 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 ALM (available with the QuickTest Professional 10.00 or 11.00 DVD).

  • Files saved in QuickTest 10.00 or later

    Assets last saved in QuickTest 10.00 or later can be opened in UFT.

  • QuickTest components

    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.

  • QuickTest 11.00 and Chrome

    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.

  • RunScript methods

    If you previously used the Frame.RunScript, Frame.RunScriptFromFile, Page.RunScript, or Page.RunScriptFromFile methods in your tests of a Web site or Web application, you should update the RunScript argument to use either an eval function or an anonymous function.

    For example, if you used this syntax previously:

    Browser("MySearchEngine").Page("MySearchEngine").Frame("Web Search").RunScript "var remove = document.getElementById('logo'); remove.parentNode.removeChild(remove)"

    you should update this to:

    Browser("MySearchEngine").Page("MySearchEngine").Frame("Web Search").RunScript "eval(var remove = document.getElementById('logo'); remove.parentNode.removeChild(remove););"

    OR

    Browser("MySearchEngine").Page("MySearchEngine").Frame("Web Search").RunScript "(function(){var remove = document.getElementById('logo'); remove.parentNode.removeChild(remove);})();"

Back to top

For Service Test tests or components

UFT 14.00 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 UFT14.00.

  • 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 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 UFT14.00.

Upgrade a test last saved in Service Test version 11.10 or 11.20

  1. Make sure that UFT is not running.

    If you ran the upgrader tool once while UFT was running, the logs may become corrupted. Backup and delete all of the existing logs in the <Unified Functional Testing installation>\bin\logs folder before proceeding.

    If desired, create a backup copy of the older tests.

  2. In the command line, enter the location of the STBatchUpgrader.exe file in the Unified Functional Testing/bin sub-folder.

  3. Add the relevant command line options as described in Upgrading QuickTest tests or components.

    Use the following syntax:

    STBatchUpgrader.exe source [destination] [/ALM url domain project] [/login username password] [/log logfile] [/report reportfile]

    For example, the following string runs the upgrade on all tests in the ST_11_1 folder on the ALM server, pumpkin, for the TEST1 project in the AUTOMATION domain. It places the report in c:\logs\MyLogfile.log.

    STBatchUpgrader.exe Subject\ST11_1 /ALM http://pumpkin:8080/qcbin AUTOMATION TEST1 /login user password  /log c:\logs\MyLogfile.log.
  4. Run the command. Verify the validity of the tests in the destination folder.

Known issues with Service Test tests

Security

When upgrading a Service Test test from Service Test version 11.00 (via 11.10), UFT does not retain the Security settings.

To upgrade the security settings as well, save the Security Scenario to an .stss file in Service Test 11.00. Then import this file for your service when you upgrade the test.

Call QuickTest Professional Test steps

Tests last modified in Service Test 11.20 that contain a Call QuickTest Professional Test step, cannot be opened in UFT.