Set up FT Design

To test web applications, you must install the Functional Testing Design Agent and a browser extension. The agent and extension enable FT Design to communicate with your application.

Prerequisites

To install the Design Agent, make sure you meet the following system requirements and permissions.

System requirements

Make sure you have the following installed:

Operating system 64-bit, Windows 8 or later.
Node.js

Download and install a supported version of Node.js. For supported versions, see the Support Matrix.

We recommend downloading the latest version supported by FT Design, unless your company requires an earlier version.

On the Node.js Download page, in the Prebuilt Installer tab, select the required version number. Specify that you want Node.js for Windows running x64.

Run the downloaded installation wizard to install Node.js. You can skip the option for installing the Tools for Native Modules.
Windows media feature

Depending on your operating system, turn on one of the following features. For up-to-date instructions, see the Microsoft documentation.

  1. From the Control Panel, select Programs and Features > Turn Windows features on or off.

  2. In the Windows Feature window, turn on Media Features.

  3. Restart the computer to take effect.

  1. From the Control Panel, select Programs and Features > Turn Windows features on or off.

  2. In the Add Roles and Features Wizard window, click Next until you reach the Features tab.

  3. Turn on Media Foundation.

  4. Click Install.

  5. Restart the computer for your changes to take effect.

Required permissions

Make sure you have the following permissions.

Function Permission Item
Installation Administrator permissions

You must have administrator permissions if you plan to do either of the following: 

  • Install the Microsoft Visual C++ 2022 Redistributable prerequisite.

  • Install the Design Agent for all users on the computer.
Installation permissions

You must have permission to install the Design Agent.

File system

Full read and write permissions

You must have permissions for the following folders and their subfolders:

  • C:\Temp (Optional)

  • %LOCALAPPDATA%\Programs\VEFTDesign

  • %LOCALAPPDATA%\VEFTDesign

  • %LOCALAPPDATA%\LeanFT

  • %PROGRAMDATA%\OpenText

Registry keys Full read and write permissions

You must have permissions for the following keys:

  • Keys under HKEY_CURRENT_USER\SOFTWARE\Classes\mf-codeless-agent

  • Keys under HKEY_CURRENT_USER\Software\OpenText

Back to top

Install the Design Agent

This section describes how to download and install the agent. You must install one agent for each Windows user.

Use the command-line installation if you are an administrator and you want to install the agent for all users at once.

To download the agent for installation:

  1. Log in to OpenText Core Software Delivery Platform. Go to the workspace you are working on. From the platform menu, select Functional Testing > Design.

    A pop-up dialog box opens, prompting you to install the agent.

    Note: This functionality requires that your browser settings allow the pop-up to open.

  2. Click Download.

To install the agent for your Windows user only:

  1. Double-click the downloaded installer program to run the installation wizard.

    By default, the agent is installed in %LOCALAPPDATA%\Programs\VEFTDesign\CodelessAgent.

  2. In the installation wizard, select the Allow installing a web extension on Chrome, Chromium Edge to enable testing web applications in Chrome and Edge browsers.

    This option updates your browser policy and enables the agent installation to also install the browser extension on Chrome and Edge.

    Caution: Make sure that your company's security policies permit you to allow installing the extension.

    1. Enable Windows Installer Service.

      Type gpedit.msc in the Start menu to open the Local Group Policy Editor. In the Local Group Policy Editor, select Computer Configuration > Administrative Templates > Windows Components > Windows Installer.

      Edit Turn off Windows Installer. Select the Enabled option and set Disable Windows Installer to Never.

    2. If your browser policy does not permit extension installation, you must manually enable the installation of this extension. See Enable extension installation in the UFT One Help Center.

To install the agent for all users on the computer:

Installing the Design Agent for all users on the computer requires administrator permissions.

In a command window, perform the following steps: 

  1. Extract the files from the downloaded installer program.

    In the folder containing the installer program, run the installer only to extract its content.

    Copy code 
    DesignAgentSetup.exe -y  -nr -InstallPath="<folder name>"

    You can specify the target folder for the extraction in the InstallPath argument. By default, the files are extracted to c:\temp\DesignAgent.

  2. Set up prerequisites.

    In the extracted folder, run setup.exe to make sure all prerequisites are installed.

    Copy code 
    setup.exe /InstallOnlyPrerequisite /s 

  3. Run the installation program to install the agent for all users. You can use a command line to run the wizard or to run the installation silently.

    To run the installation wizard:

    In the extracted folder, run this command:

    Copy code 
    msiexec -i agent.msi ALLUSERS=1

    By default, the agent is installed in %ProgramFiles%\VEFTDesign\CodelessAgent.

    In the installation wizard, select the Allow installing a web extension on Chrome, Chromium Edge to enable testing web applications in Chrome and Edge browsers.

    This option updates your browser policy and enables the agent installation to also install the browser extension on Chrome and Edge.

    Caution: Make sure that your company's security policies permit you to allow installing the extension.

    1. Enable Windows Installer Service.

      Type gpedit.msc in the Start menu to open the Local Group Policy Editor. In the Local Group Policy Editor, select Computer Configuration > Administrative Templates > Windows Components > Windows Installer.

      Edit Turn off Windows Installer. Select the Enabled option and set Disable Windows Installer to Never.

    2. If your browser policy does not permit extension installation, you must manually enable the installation of this extension. See Enable extension installation in the UFT One Help Center.

    To run the installation silently: 

    msiexec /qb -i agent.msi ALLUSERS=1 INSTALLDIR="<Installation Folder>"

    The installation folder argument is optional.

    The Allow installing a web extension... option is selected automatically.

Next steps

After the installation is completed, see Connect the Design Agent.

After installing and connecting the agent, make sure your web browser is set up for testing. See Set up the browser extension.

Connect the Design Agent

After you install the Design Agent, or at any other time, if the agent stopped running, connect the agent:

Click the Design agent button and select Connect Agent.

Make sure the port the agent is using is available.

To see the configured port number, click the Design agent button . The default port number is 20000.

To change the port: 

  1. Stop the agent by running the StopAgent.bat file in <Installdir>\bin.

  2. Click the Design agent button and select Change Port.

    Tip: You can change the port first and then stop the agent, if you want.

  3. Connect the agent by clicking the Design agent button and selecting Connect Agent.

Note: The agent port needs to be set separately in each browser. If you want to change the agent port and use Design on more than one browser (for example, Chrome, Firefox, and Edge), make sure you set the same agent port in each browser.

Back to top

Set up the browser extension

Testing web applications requires the OpenText UFT Agent extension. Make sure the extension is installed and enabled so that your web browser is set up for testing.

Chrome and Edge

The OpenText UFT Agent for Chrome or Edge is installed or updated when you install or update the agent. See Install the Design Agent.

Next, you must restart your browser and enable the extension. Make sure the extension version enabled matches the version of FT Design.

Updating the agent installs the new extension but does not uninstall the older one. Before you use FT Design, manually remove or deactivate the older extension.

Firefox

  1. Manually install the extension in Firefox:

    1. Open the <Installdir>\Installations\Firefox folder.

    2. Drag the WebExtension.xpi file into Firefox.

    If your browser policy doesn't allow extension installation, add the extension to the list of extensions to install. For details, see the Mozilla policy readme online.

    Caution: Make sure that your company's security policies permit you to make this change.

    The path to add for this extension is: <Installdir>\Installations\Firefox\WebExtension.xpi.

  2. Enable the extension in your browser. Make sure the extension version enabled matches the version of FT Design.

Back to top

Update the Design Agent

The agent is periodically updated. Always keep your agent current. This section describes how to manually update the agent.

Note: Agent update installations must use the same process as the initial installation: 

If you previously installed the agent for a single user, you must now install for a single user.

If you previously installed the agent for all users at once using the ALLUSERS option, you must now do so as well.

To update the agent:

  1. From the platform menu, select Functional Testing > Design.

    When a new agent is available, a dialog box opens.

  2. Click Download Update.

    Alternatively, click the Design agent button and select Download.

  3. Run the downloaded installer program. After the installation is completed, FT Design is automatically refreshed.

  4. If the browser extension was upgraded as part of the agent update, you receive a notification.

    • On Chrome and Edge, restart the browser to complete the upgrade of the extension.

    • On Firefox, install the new browser extension version manually, as described in Set up the browser extension.

If the agent does not connect automatically, see Connect the Design Agent.

Back to top

Connect to the AI Object-Detection Cloud Service

The Design Agent needs to connect to the AI Object-Detection Cloud Service to identify objects in an application. If your company requires a proxy for internet communication, configure the proxy settings for the agent.

To configure the proxy settings:

  1. Click the Design agent button and select Proxy Settings.

  2. In the dialog box that opens, select one of the following options:

    • System Proxy: Uses your system's proxy settings.

    • Manual Proxy: Enter your proxy address and credentials.

Back to top

Working with UFT One or UFT Developer

UFT One, UFT Developer, and FT Design use the same extension to test web applications. Each product installs its version of the extension, and requires that version to be the only one enabled.

Before you use FT Design on a computer with UFT One or UFT Developer installed, make sure the extension version enabled matches the version of FT Design.

If you later need to use a different version for UFT One or UFT Developer, deactivate the current extension and activate the relevant one.

Back to top

Enable multiple users

Multiple Windows users can use Design on the same computer at the same time. To enable multiple users to use Design simultaneously, each user must define different port numbers for the agent to use.

To set the Design Agent's ports for each user:

  1. After installing the Design Agent, stop the agent.

    Run the StopAgent.bat file in <Installdir>\bin.

  2. Set the engine port.

    Create the following folder and file: %localappdata%\VEFTDesign\CodelessAgent\Preferences\CodelessAgentSettings.json

    Enter the following in the CodelessAgentSettings.json file:

    Copy code 
    {
    "agent-engine-port": <AVAILABLE PORT>
    }

  3. Set the browser-extension agent port.

    Create the following folder and file: %localappdata%\VEFTDesign\CodelessAgent\config\config.json

    Enter the following in the config.json file:

    Copy code 
    {
    "browser-agent-port":<AVAILABLE PORT>
    }

  4. Set the UFT Developer Server Port in the browser extension options.

    1. Prerequisite: Set up the OpenText UFT Agent browser extension on the browsers you want to test.

    2. In the browser's Extensions page, locate the OpenText UFT Agent extension.

    3. Click Options. (You may need to click Details and then Extension options).

    4. Change the UFT Developer Server Port to the port you defined for the browser-agent-port and save your changes.

    5. Close the browsers and start them again.

      Make sure the OpenText UFT Agent is enabled.

  5. Change the Agent Port in Design to an available port number.

    To change the port, click the agent button and select Change Port.

    Note: The agent port needs to be set separately in each browser. If you want to change the agent port and use Design on more than one browser (for example, Chrome, Firefox, and Edge), make sure you set the same agent port in each browser.

  6. Restart the Design Agent by clicking the Design agent button and selecting Connect Agent.

Back to top

User interface languages

The FT Design user interface is available in the following languages: English (default), Japanese, Chinese, French, German, Portuguese, Spanish.

The user interface is displayed in your configured language. If you select a language not supported in FT Design, English is used. For details on configuring your user interface language, see the OpenText Core Software Delivery Platform Help Center.

Test results are still displayed in English only.

Back to top

Next steps: