Set up FT Design

To complete the setup after installing the Design Agent, connect the agent and make sure the browser extension is enabled.

In this topic:

Connect the Design Agent

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

To connect the agent: 

1. Click the Design agent button

2. Select Connect Agent.

Make sure the port the agent is using is available.

To display 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.

Set up the browser extension

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

Browser	Installing the extension
Chrome and Edge	The OpenText Functional Testing Agent extension for Chrome or Edge is installed or updated when you install or update the agent. See Install for a single Windows user account. Next, restart your browser and enable the extension. Make sure the correct extension version is installed. Updating the agent installs the new extension but might not uninstall the older one. Before you use Design, manually remove or deactivate the older extension if necessary.
Firefox	Manually install the extension in Firefox: Open the <Installdir>\Installations\Firefox folder. 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. Enable the extension in your browser. Make sure the correct extension version is installed.

Update the Design Agent

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

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

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

• If you previously installed the agent for all users at once using the ALLUSERS option, do so now 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, Design is automatically refreshed.

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

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

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 connection settings. The Proxy details dialog box opens.

2. In the Proxy details dialog box , select one of the following options:

   • Use system proxy settings: Uses your system's proxy settings.

   • Use manual proxy settings: Enter your proxy address and credentials.

3. Click Test Connection to make sure your configuration is correct.

4. Click Save to save your changes.

Working with other OpenText Functional Testing products

OpenText Functional Testing, OpenText Functional Testing for Developers, and the Functional Testing Design module use the same browser 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 Design on a computer with OpenText Functional Testing or OpenText Functional Testing for Developers installed, make sure the extension version enabled is 2026.1.x.

If you later need to use a different version for OpenText Functional Testing or OpenText Functional Testing for Developers, deactivate the current extension and activate the relevant one.

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 OpenText Functional Testing for Developers Server Port in the browser extension options.

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

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

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

   4. Change the OpenText Functional Testing for Developers 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 Functional Testing Agent is enabled.

   Note: This port number needs to be reconfigured manually whenever the browser extension is upgraded.

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

   To change the port, click the Design 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.

Next steps

• Create a script
• Run scripts