Run tests using a CI system

The procedure below focuses on Jenkins, but you can apply the same concepts to most CI systems.

Note: If you are running UFT Developer tests from Jenkins, you can track the tests in ALM. For details, see the ALM Help Center.

  1. Install the UFT Developer runtime engine and your AUT on the agent.

    If your tests were created in the context of a unit testing framework (such as NUnit or JUnit), make sure that the relevant framework's runner is also installed on the agent computer.

  2. Deploy the UFT Developer tests (DLLs/JARs) to the agent computer.

  3. Configure the Jenkins agent to maintain an active Windows session. This is needed so that the UFT Developer runtime engine can access the UI elements of your AUT during the run.

  4. For non-Web applications:

    1. On the agent computer, start the UFT Helper service from: Computer > Manage > Services and Applications > Services.

      Note: Make sure the service starts before the UFT Developer runtime engine.

    2. In the Engine tab of the UFT Developer Settings dialog box, under Runtime Settings, enter the user name and encrypted password of the agent computer.

      To generate the encrypted password, run the following command line from the agent computer and copy the encrypted string to the clipboard:

      <UFT_Developer_installdir>\bin\PasswordEncryption.exe passwordToEncrypt

      Note: The encrypted password is based on the computer where you run the utility, so make sure to generate the password on the computer where you plan to use it.

  5. Configure your Jenkins job to run your UFT Developer tests.

    For example if your tests were created in the context of an NUnit project, your build step may look like this: 

    <NUnit Path>\bin\nunit-console-x86.exe" "%PATH_TO_TEST_PROJECT_DLL%\DLLFileName.dll

  6. Optional. Configure your job to archive the UFT Developer HTML report files, so that they are available in Jenkins for each build of your job. You can also customize your job to include a direct link to the UFT Developer report file for each build.

See also: