Configuring the Freestyle project
You must configure a Freestyle project to add a build step, and then run test assets from Jenkins.
Before you begin
You must have completed the following tasks:
-
Installed the DTUI-FunctionalTest-Jenkins-HCL plugin on the Jenkins primary server. See Installing the plugin on the Jenkins primary server.
-
Created an Agent in Jenkins. For more information about creating Agents, refer to the Jenkins documentation.
-
Copied the name of the labels that you provided in the Labels field when you created the Agent.
-
Created a Jenkins Freestyle project.
About this task
Procedure
- Open the Jenkins Freestyle project, and then click Configure.
- Click the Build tab, and then click Add build step.
- Select the Run an HCL DevOps Test UI - Functional Test option from the drop-down list.
-
Provide the details about the test run for the fields in the following
table:
Field Description Name Required. The name of the test. Project Directory Required. The fully qualified path to the Test UI project directory. You must use '\\' or '/' as the file separator. Script Name Required. The name of the script to be run. Log Format Optional. The format of the script run logs. The available options are as follows: - Default
- none
- json
- xml
- html
- TPTP
- Text
Iteration Count Optional. The number of dataset iterations to be run. User Arguments Optional. Additional playback arguments, if any. For multiple arguments, you must enclose each argument within double quotation marks and separate the arguments by providing a space between them. For example, "password" "7891230" "20". Project Dependencies Optional. The complete path to the project that your test depends for the run. If there are multiple projects, you must separate each project path with a semicolon. Disconnected Mode Optional. The option to run the test through an agent in the background. The options are as follows:- True: Runs the test through an agent, and the test run continues even when the screen is locked or the agent is disconnected.
- False: Runs the test, but the test run stops when the screen is locked or the agent is disconnected.
- Optional: Click Add build step again, and provide details for the next test to run multiple tests under the same job.
- Click Save.