Deploying the Toolkit Support Set

The final stage of extending UFT One GUI testing support for a custom toolkit is deploying the toolkit support set. This means enabling UFT One to use the toolkit support set that you developed to recognize the controls in the toolkit and run tests on them.

Overview

While you are developing the toolkit support set, deploying it to UFT One enables you to test and debug the support that you create. After the toolkit support set is complete, you can deploy it on any computer with UFT One installed, to extend the UFT One Delphi Add-in.

To deploy a UFT One Delphi Add-in Extensibility toolkit support set, you must place the XML files that you created in the correct locations on a computer with UFT One installed, and compile the application you are testing with the UFT One Delphi Add-in precompiled agent and with the extensibility unit that you developed.

From the UFT One user's perspective, after you deploy the toolkit support set on a computer on which UFT One is installed, the Delphi Add-in recognizes your custom controls just as it recognizes any other Delphi object.

Back to top

Placing Your XML Files in the Correct Locations

To deploy the toolkit support set that you create, you must place the XML files in specific locations within the UFT One installation folder. The following table describes the appropriate location for each of the toolkit support files:

File

Location

Test Object Configuration file

  • <UFT One installation folder>\dat\Extensibility\Delphi

  • <UFT One Add-in for ALM installation folder>\dat\Extensibility\Delphi

    (Optional. Required only if the folder exists, which means the UFT One Add-in for ALM was installed independently from the ALM Add-ins page and not as part of the UFT One installation.)

Toolkit Configuration file

<UFT One installation folder>\dat\Settings

Icon files for custom test object classes (optional)

The file can be a .dll or .ico file, located on the computer on which UFT One is installed, or in an accessible network location.

Recommended location: <UFT One installation folder>\dat\Extensibility\Delphi\Toolkits\<custom toolkit name>\res

Specify the location in the test object configuration file.

Help files for the test object classes (optional)

Must be a .chm file, located on the computer on which UFT One is installed.

Recommended location: <UFT One installation folder>\dat\Extensibility\Delphi\Toolkits\<custom toolkit name>\help

Specify the location in the test object configuration file.

Note: In the test object configuration file, you can specify these locations using relative paths. For more information, see the UFT One Test Object Schema Help

Back to top

Compiling Your Extensibility Code

If you developed an extensibility Delphi unit, you must compile the application you are testing with the UFT One Delphi Add-in precompiled agent and with your extensibility unit.

To do this, perform the following steps:

  1. Add the <UFT One Installation folder>\dat\Extensibility\Delphi folder to the search path of the application's project or copy the contents of the <UFT One Installation folder>\dat\Extensibility\Delphi folder to the project folder.

  2. Add MicDelphiAgent to the Uses section of your application's project file.

  3. If your application includes the TwwDBGrid from InfoPower, add MicWWSupport to the Uses section of your application's project file after MicDelphiAgent.

  4. Add the location of your extensibility code to the search path of the application's project or place your file in the project folder.

  5. Add the name of your extensibility unit to the Uses section of your application's project file.

  6. Compile the Delphi application project.

Back to top

Modifying Deployed Support

If you modify the extensibility Delphi unit you developed, you must recompile the application you are testing (with the UFT One Delphi Add-in precompiled agent and with the extensibility unit that you developed) and re-run the Delphi application for the changes to take effect.

If you modify the XML files of a deployed toolkit support set, you must close and reopen UFT One for the changes to take effect.

Back to top

Removing Deployed Support

If you want to remove support for a custom toolkit from UFT One after it is deployed, you must delete its toolkit configuration file from: <UFT One installation folder>\dat\Settings and compile the application you are testing without the extensibility Delphi unit you developed.

If none of the test object class definitions in a test object configuration file are used to represent any custom controls (meaning they are no longer needed), you can delete the file from: <UFT One installation folder>\dat\Extensibility\Delphi (and <UFT One Add-in for ALM installation folder>\dat\Extensibility\Delphi if relevant).

Back to top