Set up environment

This section describes how to configure TruClient's General settings specific to OpenText Functional Testing Lab.

Prepare your environment

To prepare your environment for running a test:

  1. Make sure you have access to a machine with OpenText Functional Testing Lab, and that the installed version is supported by your version of TruClient. For details, see Help Center.
  2. Ensure that cookies are enabled on your Internet browser.

Back to top

Open the General Settings

The TruClient General Settings dialog box lets you set the OpenText Functional Testing Lab server preferences globally, so that you do not need to configure them separately for each test.

To open the TruClient General Settings dialog box:

  1. In VuGen, select File > New Script and Solution.
  2. In the Create a New Script dialog box, under the Single Protocol or Mobile category, select TruClient – Native Mobile and click Create. The new script opens.
  3. Select Tools > TruClient General Settings. Wait several seconds. If you cannot see the Settings dialog box, click the Show TruClient General Settings button in the notification window to bring it into focus.
  4. Click the Digital Lab Settings tab, configure settings, then click Done.

Back to top

TruClient general settings

All settings you define in the TruClient General Settings dialog box (in the Digital Lab tab) are applied globally to all TruClient - Native Mobile scripts. You only need to configure these settings once. All subsequently created scripts automatically inherit these settings, even after you close VuGen or TruClient.

In VuGen, if you save your script while in TruClient's interactive mode, the settings from the General Setting dialog box overwrite the runtime settings values in the Solution Explorer.

Setting Description
Server Connection
  • Use secured connection. If you want TruClient to automatically detect whether the server is secure or not, use the default setting, Automatic. If you must use a secure connection, select True.

  • Server URL:Port. The IP address and port of your Virtual User Generator server. The default ports are 8080 for non-secure servers, and 8443 for secure servers. For example, 123.45.67.89:8080.

  • Authentication Type: Select the authentication method for connecting to the OpenText Functional Testing Lab server.

    • Basic authentication. Enter the credentials with which to connect to the server (User name/Password).

    • Access key authentication. To use access key authorization, enter the access key to connect to the server. TruClient uses Oauth2 to get authorization from the server. For details on generating an execution key, see Access key management in the Help Center .

The login password and access key values are encrypted and displayed as asterisks so that their actual values cannot be seen.

Note: In VuGen, click Check Connection to validate the settings.

Collect data on

The data metrics to collect during replay: CPU on device, Free memory on device, and Consumed memory on device. You can also enable Device logs, for generating logs for each of the devices under test. The device log data is generated by Logcat for Android and Syslog for iOS.

Application - Management

Initial Replay: Whether to restart or install your applications before the first replay.

Iteration. What to do with your applications before and after each iteration: Restart, Install, or Delete.

Reinstalling apps ensures their compatibility with the current version of OpenText Functional Testing Lab. This option may not be available if you are using Amazon as a source lab.

For example, if your test runs multiple iterations, and you only want to install the apps for the first iteration, but not on subsequent iterations, configure the settings as follows:

Initial Replay section:
Select Enable from the drop-down list for the Restart application and Install application options.

Iteration section:
Clear the Install application before execution option. Note that this option is only effective if the Simulate a new user for each iteration option is enabled in VuGen's Replay Runtime settings.

Tip: You can manually install the application after executing the configuration flow by selecting Reinstall the application from the Restart/Reinstall toolbar drop-down .

Application - Typing

Typing Simulation Mode. How to simulate key strokes, as defined in the Type action for web elements.

  • DOM Events. (default) Simulates typing at the web page level, without relying on the device keyboard.
  • Device Events. Triggers a device level operation for each key stroke, more accurately simulating a user's action.
Network Virtualization

Enables NV. Select a predefined or user-defined network profile.

Transactions

Allows you to customize transactions names by adding a suffix to help you identify them after a test run. For details, see Insert transactions.

The suffix can be one or more of the following:

  • OS type
  • Device ID or name
  • Application identifier or name
Digital Lab Tab

Run on start. Runs the entire configuration flow in the TruClient tab when the TruClient browser opens. When disabled (default), TruClient automatically connects with the OpenText Functional Testing Lab server, but does not execute any of the configuration steps.

If you disable this option, you can execute the flow in the following ways:

  • When you click Replay , TruClient automatically executes the flow before running the steps.
  • If you manually run steps using the Play … Step options in the right-click menu, you need to execute the flow using the Execute configuration flow button before running the steps.

Back to top

See also: