Skip to end of metadata
Go to start of metadata

Supported version of Jenkins: 2.73.3 and above


Jenkins
is a continuous integration tool that helps with the deployment of software projects. Through this, you can run automated tests while building a project, and monitor the results. 

The TM4J Jenkins plugin enables a set of tasks that both report on automated test results and run BDD test cases from within JIRA. 


Installing the plugin 

  1. Go to the settings page and click 'Manage plugins'



  2. Click tab “Available” and search for 'Test Management for Jira'



  3. Select the plugin and click install

Plugin setup

  1. After installing the Test Management for JIRA plugin for Jenkins, return to the Jenkins home page. 
  2. Click on 'Manage Jenkins' then click 'Configure System'. 



  3. Scroll down to TM4J Configurations and fill out the following details for your JIRA server instance:
    1. JIRA Server IP address or hostname

    2. JIRA username 

    3. JIRA password




  4. Click 'Test Configuration' to ensure that this works before saving settings.

Post-build task - Publish Test Results to TM4J  

The Publish Test Results to TM4J post-build task will post results of automated tests to JIRA once the project build has run. 

To enable this task to run once a build has complete:

  1. Click on your Project in Jenkins then click 'Configure' in the sidebar 
  2. Scroll down to the 'Post Build Actions' section and click 'Publish Test Results to TM4J' in the dropdown 



  3. Fill out the configuration details, including the following:
    1. JIRA URL - the url of your JIRA instance 
    2. Project key - the JIRA project key where the results will be sent
    3. Test Framework - select Cucumber of JUnit 
    4. File path - the file path for the results file that is generated from the automated tests



  4. Check the box to 'Create test cases automatically if they do not exist' if necessary. This will relate to the test case key used to annotate a test within a development project. 
  5. Save the configurations

Build task - BDD test cases running in JIRA 

The Test Management for JIRA Export Feature Files build task will pull existing BDD test cases from TM4J, execute these within Jenkins and the results will be sent back to TM4J. 

To enable this task to run before a build takes place:

  1. Click on your Project in Jenkins then click 'Configure' in the sidebar 
  2. Scroll down to the 'Build' section and click 'Test Management for JIRA Export Feature Files' in the dropdown 




  3. Fill out the configuration details, including the following:
    1. JIRA URL - the url of your JIRA instance 
    2. Project key - the JIRA project key where the results will be sent
    3. File path - the file path for the results file that is generated from the automated tests




  4. Save the configurations

Have a question for us?




  • No labels