Use Azure DevOps Server or Services to retrieve resources from Digital Lab

This topic describes how to configure a task that retrieves information from Digital Lab. You can retrieve information about mobile devices and their applications, or about cloud browsers.


  • This task is part of a higher-level task. For details, see Use Azure DevOps Server or Services to run a local test and Use Azure DevOps Server to trigger a parallel testing task.

  • This topic describes working with UFT One Azure DevOps extension version 24.2.*. To benefit from the latest functionality, we recommend updating existing tasks' versions to 24.2.*. When using this extension version, make sure that you installed the corresponding file from the ADM-TFS-Extension GitHub repository.

  • The plugin user interface and documentation are updated to reflect that Micro Focus is now OpenText, UFT Mobile is now Digital Lab. Backward compatibility is provided, therefore if you had any UFT Mobile Get Resource tasks in your pipeline, they are still supported.

Retrieve resource information from Digital Lab

In Azure DevOps Server:

  1. Create a pipeline. Skip this step if you are using TFS.

    1. Create a build pipeline or a release pipeline, with the Empty job template.

      Note: A build pipeline is the pipeline type created when you do not explicitly create a release pipeline.

    2. Select the agent pool that includes the agent on which you want to run your tests.

    For more details, see the Microsoft Azure documentation.

  2. Add a UFT One task and place the step in the correct place in the build order.

    Note: If you are working with a release pipeline, add the task in the relevant stage, then place the step in the build.

    1. From the Task catalog, select the Test tab. A list of all available test tasks is displayed.

    2. From the Test tab, select the Get Digital Lab Resources task and click Add. A new, empty task is added as part of your build pipeline.

      Note: If you are working with a release pipeline, the task is added as part of your deployment process.

  3. Provide the following information for your build step.

    Display name

    By default, the Azure DevOps Server CI system uses a preset descriptor for the task. Provide a more meaningful name for your step.

    Resources to retrieve

    Select the resource you want to retrieve.

    Values: Only devices, Only applications, Both devices and applications, Cloud browsers.

    Include disconnected devices in response Specify whether disconnected devices should be included in the list of devices retrieved by this task.
  4. Define the Digital Lab connection settings.

    When upgrading a task from a version earlier than 24.2.0: The Digital Lab settings in the Azure tasks are now grouped under the Use Digital Lab option. When you upgrade your Azure tasks to the new extension, you must select this option so the Digital Lab settings continue to take effect.

    Digital Lab Server The address of your Digital Lab server, in the format of http[s]://<server name>:<port>.
    Authentication type

    Select the authentication mode to use for connecting to Digital Lab:

    • Basic authentication. Authenticate using user name and password.

    • Access key authentication. Authenticate using an access key you receive from Digital Lab.

    User name and Password. If you selected Basic authentication, enter your login credentials for the Digital Lab server.

    Access key. If you selected Access key authentication, enter the access key you received from Digital Lab.

    Use proxy settings

    Provide the following information if you selected to connect using a proxy:

    Proxy Server: The address of your proxy server, in the format of <proxy server name>:<port>.

    Use proxy credentials. Enables you to connect to the Digital Lab server using a specific account.

    Proxy user name and password. The credentials used to connect to the Digital Lab server, if Use proxy credentials is selected.

  5. Configure the CI system control options for the step, including:

    Enabled Specify whether the step should be run as part of this build.
    Continue on error Instruct the CI system to stop or continue the build if there is an error on this step.
  6. Set your pipeline to run: 

    • Build pipeline: Save and queue the pipeline.

    • Release pipeline: Create a release and deploy the pipeline.

Back to top

View the results

Once the task has completed, the resource information is displayed on the pipeline console.

If you choose to retrieve both devices and applications, they are listed separately. In addition, devices are listed in two categories (available devices and disconnected devices).

  • Available devices includes all the available devices that are currently connected to Digital Lab (including reserved devices).

  • Disconnected devices includes all the devices that have been registered in Digital Lab but are currently disconnected.

Note: Disconnected devices are displayed only when you selected Include disconnected devices in response on the task configuration page.

A sample of retreived device and application information

If you choose to retrieve cloud browsers, you receive a list of available operating systems, locations, and browsers. For each browser, the available versions are listed. The most recent supported versions are labeled latest, latest-1, and latest-2. When selecting a browser to work with, you can specify one of those labels rather than a specific version. For details, see Use Azure DevOps Server or Services to run a local test.

A sample of retreived cloud browser information

Back to top

See also: