Configuring a Jenkins environment for viewing test results

If your Jenkins environment has the HCL OneTest API Results plug-in for Jenkins installed, you can view test suite results from Jenkins jobs within the Jenkins interface.

Before you begin

  • Ensure that the HCL OneTest™ API project that you are using has a valid project results database configuration.
  • Verify that the connection to project results database is working correctly. Click Project > Project Settings on the menu bar of HCL OneTest API, click the Server Settings tab on the Project Settings window, and then click Test Connection.
  • Ensure that your project is connected to a valid instance of the server. Details about the instance are used by the test execution when it is generating console output that is used by Jenkins to display test results.
  • Verify that the connection is working correctly. Click Project > Project Settings on the menu bar, then click the Server Settings tab on the Project Settings window, and verify that a green check mark icon is displayed next to the URL field on the HCL Quality Server area of the tab. If no URL is displayed or if there is a red X icon next to the URL field, contact your HCL OneTest API project administrator.
  • Ensure that the HCL Quality Server instance that you are using has the same project results database configuration as the project; to do so, click Project > Project Settings on the menu bar, click the Server Settings tab on the Project Settings window, and then in the HCL Quality Server section, click Publish results database connection.
  • Ensure that the HCL OneTest API Results plug-in is installed. For details, see Setting up the integration with Jenkins.
  • Configure a Jenkins project (job) to run an HCL OneTest API test suite either by using Ant or by using the HCL OneTest API Test Execution plug-in. For details, see Configuring the Jenkins environment for running tests.

Procedure

  1. On the Jenkins dashboard, click the relevant project.
  2. On the Project page, click Configure.
  3. Under Post-build Actions, click Add post-build action.
  4. Click HCL OneTest API Results View.
  5. Click Save.
Feedback