UFT One and Jenkins

Run UFT One tests from your local file system, ALM, or ALM Lab Management as part of your Jenkins continuous integration process.

You can use either a Jenkins freestyle project or a pipeline to run UFT One tests. This topic describes how to integrate UFT One with Jenkins to run your UFT One tests.

Set up your Jenkins server with the Application Automation Tools plugin

Set up your Jenkins server to run UFT One tests.

Do the following:

  1. Install Jenkins and the Application Automation Tools plugin. For details, see the Jenkins plugin page.

  2. From the Jenkins Server home page, click New Item, or select an existing one.

  3. On the page that opens, enter an item name for the new job, select Freestyle project or Pipeline, and click OK.

    For the supported pipeline job types, see the Jenkins plugin page.


  • Due to Jenkins' security policy, when you upgrade the plugin to version 6.8, Jenkins may remove the build steps of the plugin.

    Workaround: Recreate the build steps using Application Automation Tools plugin 6.8 or higher.

  • We recommend that you always clear your browser cache when you upgrade or downgrade the plugin.

Back to top

Select execution nodes for your job

Select one or more execution nodes for the test runs in this job.

Do the following:

  1. In the General section of your Jenkins job, select This project is parameterized.

  2. Select Add Parameter > Node, and enter or define the following Node options:

    Name Define a name for your node definitions.
    Default nodes

    Select one or more default node to use when the job is triggered by an outside process.

    Possible nodes

    Select one or more node to use when the job is built manually.

    Build options

    Select one of the following options for node selection when triggering a build:

    • Run next build only if build succeeds

    • Run next build only if build succeeds or is unstable

    • Run next build regardless of build result

    • Allow multi-node selection for concurrent builds. Required for jobs configured with the Execute concurrent builds if necessary.

      When configured, the build is executed on all selected nodes in parallel. Ensure that all selected nodes are online before you build this job.

    • Disallow multi-node selection when triggering build manually. Select this option to enable users to select a build node when they trigger a build.

    Node eligibility

    Select how to handle nodes that are offline or temporarily offline.

    • All Nodes. Trigger the job on all selected nodes, regardless of their online/offline state.
    • Ignore Offline Nodes. Trigger the job only on nodes that are online and have an available UFT One instance to run the test.
    • Ignore Temp Offline Nodes. Trigger the job on all selected nodes, except those currently marked as offline.
    Description Define a description for your node configuration.

Note: If you configure failure scenarios, the node configured here must match the one selected in the failure scenario.

For more details, see Configure failure scenarios for your test runs.

Tip: The UFT One Jenkins plug-in supports a variety of methods for defining nodes for your job. This topic describes one of the most commonly used and recommenced procedures.

For more details, see Create an execution node on the Jenkins plugin page.

Continue with one of the following:

Back to top

Security precaution

Although any sensitive information is encrypted and encoded, Micro Focus encourages you to routinely remove unnecessary files generated by your Jenkins jobs, which are not removed by the Micro Focus Jenkins Application Automation Tools plugin.

These are the files located in the <Jenkins installation folder>\workspace\<job name> folders.

By not implementing the file removal you may expose your system to increased security risks. You understand and agree to assume all associated risks and hold Micro Focus harmless for the same.

It remains at all times the Customer’s sole responsibility to assess its own regulatory and business requirements. Micro Focus does not represent or warrant that its products comply with any specific legal or regulatory standards applicable to Customer in conducting Customer's business.

Back to top

See also: