Qualitia Automation Studio (QAS) supports Jenkins, an open-source automation server written in Java. It is a cross-platform, continuous integration, and continuous delivery application that increases your productivity. 

You can integrate Qualitia to execute test cases through Jenkins. In order to do so, you must configure your offline package accordingly.

📚Prerequisites

1. In order to push results, the machine which you are using to trigger the test case execution must have access to the machine where Qualitia Server is installed.

2. You must have access to port 8887 from the machine where Qualitia Server is installed.

3. Qualitia must be installed.

4. Projects, Testcases, and Suites must be created in QAS - client.

5. Testcases must be in Published state.

Jenkins Installation

Jenkins can be installed using following two methods. However, Qualitia recommends installing Jenkins using the war file.

Installing Jenkins using war File

1. Download Jenkins JDK 1.6, 1.7.

2. Install JDK 1.6, 1.7.

3. Do one of the following:

   1. If Java_Path is not added as Enviornment Variable: Open the Command Prompt window, navigate to the folder where you have downloaded JDK 1.6, 1.7,  and then navigate to the folder where you have downloaded Jenkins. 

   2. If Java_Path is added as Enviornment Variable: Open the Command Prompt window and navigate to the folder where you have downloaded Jenkins. 

4. Execute the following command:
    java -Dhudson.model.DirectoryBrowserSupport.CSP="default-src 'self';img-src 'self'; style-src 'self' 'unsafe-inline'; child-src 'self'; frame-src 'self'; script-src 'self' 'unsafe-inline'; frame-ancestors 'self';" -jar jenkins.war.
   Default port is 8080.

Installing Jenkins as a Service

1. Install JDK 1.6, 1.7.

2. Download and Install Jenkins following the onscreen instructions.

3. Once the installation process is completed, open the location where Jenkins is installed. 

4. Open the jenkins.xml.

5. Update the argument for %Base%\jre\bin\java as follows:
   -Dhudson.model.DirectoryBrowserSupport.CSP="default-src 'self';img-src 'self'; style-src 'self' 'unsafe-inline'; 
   child-src 'self'; frame-src 'self'; script-src 'self' 'unsafe-inline'; frame-ancestors 'self';"
    Do not remove the existing value. Just add to the existing value as displayed in the image above.

6. Save and close the file.
    Restart the Jenkins service once you update the XML values from the Services.msc console.

Jenkins Configuration

Once you have installed Jenkins, you can proceed for Jenkins configurations.

1. Launch Jenkins Instance.

2. Enter the Administrator password.
   Take the Administrator password from the initialAdminPassword file located in the .jenkins\secrets folder.

3. Click Continue.

4. Click New Item on left-hand side to create a New Jenkins job.

6. Click OK to go to the Configuration page.

7. To configure enter the Job Description under General settings.

8. Now set up the build steps, go to the Build Steps tab

   1. Click Add a build step.

   2. If you are using a Windows machine, select Execute Windows batch command.

   3. In the Command text box, enter the command to execute qualitia-offline.xxxx.jar.
      For example: If your offline package is stored in the D > OfflinePackage, enter the command to navigate to the D drive and then command to execute the offline package.

      

   4. First command hits Qualitia Bot API endpoints to generate a executionAgent.jar. This jar is bridge between CI tool (in this case Jenkins) and Qualitia Server for provided server URL.

   5. In second command, utilize this bridge and provide arguments to access required artifacts.

   6. The required parameters are:

      1. ServerUrl: The server URL where your server is hosted.

      2. ProjectName: The name of the project for which you want to execute testcases and suites.

      3. SuiteName: The name of the suite which you want to execute using Jenkins integration.

      4. Executiontrigger: The mode of execution that you want to trigger from Jenkins.

      5. You can provide any arguments using this command like browser, driver path, polling interval etc.

   7. During the execution, Qualitia engine creates a property file qer.properties which will help you to read report in CI/CD.

   8. Make sure to install Inject environment variables plugin to read this file. Once you install this plugin, select Inject environment variables option in Build Steps.

   9. Provide a complete path of qer.properties.

      

9. Next step is to set up Post-build Actions to get an execution report.

   1. Go to Post-build Actions and click Add post-build action.

   2. To publish execution report, install Publish HTML Reports plugin.

   3. Select Publish HTML Reports option.

   4. Add values we read from qer.properties in previous step.

   5. To publish the report.

      • HTML directory to archive: Enter the HTML directory path where report exists. Provide variable present in qer.properties for HTML directory where report exists.

      • Index page[s]: Enter variable reportfilename in qer.properties. This is the page users want to publish.

      • Report title: Provide any name of your choice for the file.

      • Click Apply and then save the data by clicking Save.

        

   6. Once the setup is done. Click Build Now.

   7. If the job is successfully executed, it will publish a report in Jobs.

      

   8. Download the Zip file and take a glance at it. It downloads all the supported files for reports as well.

   9. You can also view the complete build history in the left pane under Build History.