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.

In this topic:

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

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

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.

Back to top

See also:

• Test from Azure DevOps Server or Services
• Known issues - Running tests from Azure DevOps