Testing with UrbanCode Deploy

With the HCL OneTest™ UI plugin for UrbanCode Deploy, you can automate the execution of tests and compound tests.

Before you begin

  • Install HCL OneTest UI and UrbanCode Deploy agent on the computer where the tests will be run.
  • Download the plugin for UrbanCode Deploy from HCL License & Delivery Portal.
  • Install UrbanCode Deploy server and deploy the plugin on the server.

    For information about installing UrbanCode Deploy, see its documentation.

  • Install UrbanCode Deploy Agent and connect it to UrbanCode Deploy server. See the documentation.
  • Ensure that HCL OneTest UI is not running.
  • To initiate the mobile test runs, ensure that all the devices are set to the passive mode and the playback-ready apk files are installed
  • To run tests on Linux or Mac OS, you must add an environment variable that points to the installation directory of the product, for example, export TEST_WORKBENCH_HOME=/opt/IBM/SDP export TEST_WORKBENCH_HOME=/opt/HCL/HCLOneTest. For Windows, this environment variable is already defined.
  • If you installed the product on Windows using the stand-alone installer (not using IBM® Installation Manager), you must specify the environment variable that points to the installation directory of the product. For example, export TEST_WORKBENCH_HOME=C:\Program Files\HCL\HCLOneTest

About this task

As a tester, you might have a large number of regression tests to run on the latest build of the product. Instead of manually running the tests on every new build, you can install the latest build on the UrbanCode Deploy Agent computer and let UrbanCode Deploy launch the tests for you.

After deploying the UrbanCode Deploy plugin on the server, create the component and its processes, applications and its processes, the environments, and the resources. For information about how to create these different pieces, see UrbanCode Deploy documentation.


To create the workflow:

  1. To create a workflow for the newly created component process, click the component process. The Tools view displays the available plugin steps.
  2. From HCL OneTest UI Web UI > Run an HCL OneTest UI - Web UI test to the design space.
  3. Specify the properties for the step. For information about the properties, see this topic.
  4. After you configure the step properties, save the step by clicking Save.


A typical process will look like the following snapshot:

Step to run a web ui test

A process with multiple tests will look like the following snapshot:

Steps to run multiple Web UI tests

If you have installed multiple products on one target machine, either in the same or different package groups, you can use a single process that includes steps from different products. You must install the plugins of all of the products that you want to use. The process will look like the following snapshot:

Steps to run tests from multiple products