NewIssue

jiraNewIssue

Creates new issue based on given input, which should have some minimal information on that object.

Input

• issue - issue to be created.
• site - Optional, default: JIRA_SITE environment variable.
• failOnError - Optional. default: true.
• auditLog - Optional. default: true. Append a panel to the comment with the build url and build user name.

Output

• Each step generates generic output, please refer to this link for more information.
• The api response of this jira_new_issue step can be reused later in your script by doing response.data.required_field_name.
• You can see some example scenarios here
• All the available fields for a jira response can be found in JIRA API documentation depending on your JIRA version.

Examples

• With default site from global variables.

  node {
    stage('JIRA') {
      # Look at IssueInput class for more information.
      def testIssue = [fields: [ // id or key must present for project.
                                 project: [id: '10000'],
                                 summary: 'New JIRA Created from Jenkins.',
                                 description: 'New JIRA Created from Jenkins.',
                                 customfield_1000: 'customValue',
                                 // id or name must present for issueType.
                                 issuetype: [id: '3']]]
  
      response = jiraNewIssue issue: testIssue
  
      echo response.successful.toString()
      echo response.data.toString()
    }
  }
  

• withEnv to override the default site (or if there is not global site)

  node {
    stage('JIRA') {
      withEnv(['JIRA_SITE=LOCAL']) {
        def testIssue = [fields: [ project: [id: '10000'],
                                   summary: 'New JIRA Created from Jenkins.',
                                   description: 'New JIRA Created from Jenkins.',
                                   issuetype: [id: '3']]]
  
        response = jiraNewIssue issue: testIssue
  
        echo response.successful.toString()
        echo response.data.toString()
      }
    }
  }
  

• Without environment variables.

  def testIssue = [fields: [ project: [id: '10000'],
                             summary: 'New JIRA Created from Jenkins.',
                             description: 'New JIRA Created from Jenkins.',
                             issuetype: [id: '3']]]
  
  response = jiraNewIssue issue: testIssue, site: 'LOCAL'
  
  echo response.successful.toString()
  echo response.data.toString()