Set up Functional Test Design

To test web applications, you must install the ValueEdge Functional Test 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

Supported versions: 16.14.0 - 17.9.1

From the Node.js website, download and install the 64-bit Windows version of the Node.js MSI installer.

  • We recommend downloading the latest 17.9.1 MSI installer unless your company requires an earlier version.

  • When installing Node.js using the installation wizard, you can skip 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. Read/write permissions must include subfolders as well.

Function Permission Item
Installation permissions Administrator permissions

Administrator permissions to install Microsoft Visual C++ 2022 Redistributable

Note: If you already installed Microsoft Visual C++ 2022 Redistributable on your computer, administrator permissions are not required.
File system permissions to work with

Full read and write permissions

  • C:\Temp folder (Optional)

  • %LOCALAPPDATA%\Programs\VEFTDesign folder

  • %LOCALAPPDATA%\VEFTDesign folder

  • %LOCALAPPDATA%\LeanFT folder

  • %PROGRAMDATA%\Micro Focus folder
Registry key permissions to work with Full read and write permissions

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

  • Keys under HKEY_CURRENT_USER\Software\Micro Focus

Back to top

Install the Design Agent

This section describes how to install the agent.

Note: You need to install one agent for each Windows user.

To install the agent:

  1. Log in to the ValueEdge platform. Navigate to the workspace you are working on. From the platform menu, select Functional Test > 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.

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

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

  4. In the installation wizard, select the Allow installing a web extension on Chrome, Chromium Edge option if you want to test web applications in Chrome and Chromium Edge.

    This option updates your browser policy and enables the agent installation to also install the browser extension on Chrome and Chromium 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 company 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.

    After the installation is completed, the agent automatically starts and connects to FT Design. Otherwise, see Connect the Design Agent.

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

Connect the Design Agent

If the agent fails to connect to FT Design automatically after you install it, or if the agent is not running, try the following:

  • Manually connect the agent: Click the agent button in the upper-right corner and select Connect Agent.

  • Check whether the port specified is available. To change the port, click the agent button and select Change Port. The default port number is 20000.

  • Restart the agent. Run the RestartAgent.bat file in %localappdata%\Programs\VEFTDesign\CodelessAgent\bin or manually restart it from the Windows Task Manager.

Back to top

Set up the browser extension

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

Chrome and Chromium Edge

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

Enable the extension in your browser. 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 disable the older extension.

Firefox

  1. Manually install the extension in Firefox:

    1. Open the <Agent installation folder>\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 Mozilla policy readme.

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

    The path to add for this extension is: <Agent installation folder>\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.

To update the agent:

  1. Open FT Design from the ValueEdge platform.

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

  2. Click Download Update.

    Alternatively, click the agent button in the upper-right corner and select Download.

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

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

Back to top

Connect to AIOD Cloud Service

The Design Agent needs to connect to the AI Object-Detection (AIOD) 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 agent button in the upper-right corner 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, disable the current extension and enable the relevant one.

Back to top

Next steps: