Run tests using a CI system

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

1. Install the OpenText Functional Testing for Developers 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 tests (DLLs/JARs) to the agent computer.

3. Configure the Jenkins agent to maintain an active Windows session. This is needed so that the 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 runtime engine.

   2. In the Engine tab of the 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:

      <Installdir>\bin\PasswordEncryption.exe passwordToEncrypt

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

5. Configure your Jenkins job to run your 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 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 OpenText Functional Testing for Developers report file for each build.