Installing the Java Add-in Extensibility SDK

This section lists the pre-installation requirements and explains how to install the OpenText Functional Testing Java Add-in Extensibility Software Development Kit (SDK).

Overview

The OpenText Functional Testing Java Add-in Extensibility SDK enables you to design support for custom Java controls. The SDK installation includes:

  • An API that you can use to create support for custom Java controls

  • A plug-in for the Eclipse IDE (integrated development environment) for Java developers that provides:

    • Wizards that guide you through the process of creating custom toolkit support sets

      The Java Add-in Extensibility wizards in Eclipse create all of the required files, classes, and methods. These wizards also provide method stubs for methods that you may need to implement.

    • Commands for editing the files after they are created

  • A set of sample applications and completed Java Add-in Extensibility projects that extend support for these applications. (The sample applications and their support sets are installed in the <Java_Add-in_Extensibility_SDK_installdir>\samples folder.)

Using the OpenText Functional Testing Java Add-in Extensibility Samples

You can use the samples provided as part of the Java Add-in Extensibility SDK to learn more about designing support sets.

The samples assume that the SDK is installed in the default installation folder: 

Version 2023 and earlier: C:\Program Files (x86)\Micro Focus\UFT One

Version 23.4 to 24.4: C:\Program Files (x86)\OpenText\UFT One

Version 25.2 and later: C:\Program Files (x86)\OpenText\Functional Testing

If this is not the case, you need to make the following adjustments in the sample toolkit support sets before you can use them on OpenText Functional Testing:

  1. For each sample, in the toolkit configuration XML file located in the Configuration folder (in the <Java_Add-in_Extensibility_SDK_installdir>\samples\<SampleName>Support folder), update the SupportClassPath property with the current OpenText Functional Testing installation path.

  2. For each sample, in the .classpath file located in the <Java_Add-in_Extensibility_SDK_installdir>\samples\<SampleName>Support folder, update all relevant file paths according to the current OpenText Functional Testing installation path.

    If your SDK is installed on a 64-bit operating system, make the following additional change for each sample: In the .classpath file, modify the path to the mic.jar file from <OpenText Functional Testing installdir>\bin\java\classes/mic.jar to <Java_Add-in_Extensibility_SDK_installdir>/bin/java/classes64/mic.jar.

Back to top

Pre-Installation Requirements

Before you install the Java Add-in Extensibility SDK, do the following:

  • Make sure that the Eclipse IDE for Java developers is installed on your computer if you plan to work with the Java Add-in Extensibility Eclipse plug-in. For a list of supported Eclipse versions, see the OpenText Functional Testing Support Matrix .

    When you install the Eclipse IDE, which is available for free on line, make sure to note the installation location on your computer. You need to enter this information when installing the Java Add-in Extensibility SDK.

    Note: The Eclipse plug-in is required to perform the tutorial described in Tutorial: Learning to Create Java Custom Toolkit Support. Additionally, it is recommended to use this plug-in to design at least the skeleton of your toolkit support.

  • (Optional) Make sure that OpenText Functional Testing with the Java Add-in is installed on the same computer. This enables the Eclipse plug-in to interact with OpenText Functional Testing, enabling you to work more efficiently when debugging and testing your custom toolkit support. For example, if you use the Eclipse plug-in on an OpenText Functional Testing computer, you can deploy the toolkit support to OpenText Functional Testing for debugging by simply clicking a button.

    Note: If you do not install OpenText Functional Testing and the Java Add-in before you install the Java Add-in Extensibility SDK, any Eclipse plug-in functionality that requires interaction with OpenText Functional Testing will not be available.

Back to top

Installing the Java Add-in Extensibility SDK

Use the OpenText Functional Testing Setup program to install the Java Add-in Extensibility SDK on your computer.

To install the Java Add-in Extensibility SDK:

  1. Close all instances of Eclipse and OpenText Functional Testing.

  2. Run the setup.exe file from your OpenText Functional Testing installation files folder. The Setup window opens.

  3. Click Add-in Extensibility and Web 2.0 Toolkits. The OpenText Functional Testing Add-in Extensibility and Web 2.0 Toolkit Support screen opens.

  4. Select OpenText Functional Testing Java Add-in Extensibility SDK Setup.

    The Welcome screen of the OpenText Functional Testing Java Add-in Extensibility SDK Setup Wizard opens.

  5. Click Next. The End-User License Agreement screen opens.

    Note: If the Modify, Repair, or Remove Installation screen opens, the SDK is already installed on your computer. Before you can install a new version, you must first uninstall the existing one.

    Read the license agreement and select I accept the terms in the License Agreement.

  6. Click Next. The Custom Setup screen opens. This screen displays the location in which the Java Add-in Extensibility SDK will be installed.

    Note: If you install the Java Add-in Extensibility SDK on a computer on which OpenText Functional Testing is installed, the OpenText Functional Testing installation folder is selected by default.

    Click Browse to select a different location, as needed.

    All of the features displayed in the Custom Setup screen are installed automatically during the setup. Click Disk Usage to display your currently used and available disk space, as well as the amount of disk space required for the Java Add-in Extensibility SDK files and folders.

  7. Click Next. The Ready to Install screen opens.

  8. Click Install. The Setup program installs the Java Add-in Extensibility SDK and displays a dialog box in which you specify the location of the Eclipse installation on your computer.

    The Java Add-in Extensibility Eclipse plug-in is installed on Eclipse according to the location you specify.

    Note: You can install the Eclipse plug-in on additional Eclipse installations after you finish the Java Add-in Extensibility SDK installation process. To do this, browse to the <Java_Add-in_Extensibility_SDK_installdir>\eclipse folder, and run deploysdkplugins.exe. Enter an Eclipse installation folder in the dialog box that opens, and click OK.

    If you do not plan to use this plug-in, click Cancel and proceed to the next step. Otherwise, click Browse, navigate to the Eclipse installation folder, and select the root eclipse folder. Click OK. Then click OK to accept the Eclipse installation location.

  9. In the final screen, if you select the Show Readme check box, the Java Add-in Extensibility Readme file opens after you click Finish.

    The Readme file contains the latest technical and troubleshooting information. You can always find the latest version online: OpenText Functional Testing Add-in Extensibility

    Click Finish to exit the Setup Wizard.

    Tip: If you do not see the OpenText Functional Testing menu or toolbar in Eclipse after the installation, run the command line <Eclipse_installdir>\eclipse -clean on your computer to refresh the Eclipse plug-in configuration, and then reopen Eclipse.

Back to top

Uninstalling the Java Add-in Extensibility SDK

You can uninstall the OpenText Functional Testing Java Add-in Extensibility SDK by using Add/Remove Programs as you would for other installed programs. Alternatively, you can use the OpenText Functional Testing Setup program.

Considerations when uninstalling the SDK:

  • When you uninstall the Java Add-in Extensibility SDK, the Eclipse plug-in is removed from all Eclipse installations.

    If you still see the OpenText Functional Testing menu or toolbar in Eclipse after uninstalling, run the command line <Eclipse_installdir>\eclipse -clean on your computer to refresh the Eclipse plug-in configuration, and then reopen Eclipse.

  • If you use the setup program to uninstall the SDK, you must use the same version of the setup program as you used for the original installation.

  • You must be logged on with Administrator privileges to uninstall the SDK.

To uninstall the OpenText Functional Testing Java Add-in Extensibility SDK:

  1. Close all instances of Eclipse and OpenText Functional Testing.

  2. Run the setup.exe file from your OpenText Functional Testing installation files folder. The Setup window opens.

  3. Click Add-in Extensibility and Web 2.0 Toolkits. The OpenText Functional Testing Add-in Extensibility and Web 2.0 Toolkit Support screen opens.

  4. Select the OpenText Functional Testing Java Add-in Extensibility SDK Setup. The Welcome screen of the OpenText Functional Testing Java Add-in Extensibility SDK Setup Wizard opens.

    Note: If you have a previous version of the SDK installed, the Java Add-in Extensibility SDK Setup wizard opens. Using this wizard, follow the instructions below to uninstall the old SDK version.

  5. Click Next. The Modify, Repair, or Remove Installation screen opens.

  6. Follow the instructions in the wizard to remove the SDK.

Back to top

Troubleshooting and Limitations - Java Add-in Extensibility Eclipse Plug-in

This section describes troubleshooting and limitations when working with the Java Add-in Extensibility.

When the Java Add-in Extensibility plug-in is installed on Eclipse 3.3, using the software update options in the Eclipse Help menu may fail.

Workaround: Save the eclipse\features\com.mercury.qtjext.PluginFeature_1.0.0\feature.xml file in UTF-8 format instead of ANSI format.

Back to top

Next steps: