Configuring a Jenkins environment for viewing test results

The Integration Tester Test Execution plugin helps to run the test suites. You can also view the test suite results. The Jenkins environment must have the Integration Tester Results plugin for Jenkins installed.

Before you begin

You must have performed the following tasks:

  • Ensured that the HCL DevOps Test Integrations and APIs (Test Integrations and APIs) project that you are using has a valid project results database configuration.
  • Verified that the connection to the project results database is functioning. Click Project > Project Settings on the menu bar of Test Integrations and APIs, click the Server Settings tab on the Project Settings window, and then click Test Connection.
  • Ensured that your project is connected to a valid instance of the server. Details about the instance are used by the test execution when it generates console output that is used by Jenkins to display test results.
  • Verified that the connection is functioning. 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 Control Panel area of the tab. If no URL is displayed or if there is a red X icon next to the URL field, contact your Test Integrations and APIs project administrator.
  • Ensured that the Test Virtualization Control Panel instance that you are using has the same project results database configuration as the project. Click Project > Project Settings on the menu bar, click the Server Settings tab on the Project Settings window, and then in the Control Panel section, click Publish results database connection.
  • Ensured that the Integration Tester Results plugin is installed. For details, see Setting up the integration with Jenkins.
  • Configured a Jenkins project (job) to run an Test Integrations and APIs test suite either by using Ant or by using the Integration Tester Test Execution plugin. For details, see Configuring the Freestyle project by using the Integration Tester Jenkins Plugin or Configuring the Freestyle project by using the Ant script.

Procedure

  1. Log in to the Jenkins server.

    The Jenkins dashboard is displayed.

  2. Open your Jenkins Freestyle or Pipeline project from the list.
  3. Click Configure on the Project page.
  4. Click the option, Add post-build action under Post-build Actions.
  5. Click Integration Tester Results View.
  6. Click Save.

What to do next

You can run test assets from the Jenkins server. See Running tests from Jenkins.