More about jiraNewIssues step.

Overview

This step creates new issues in bulk in the provided JIRA site.

Input

  • issues - issues 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.

Note: It supports all the fields that any jira instance supports including custom fields. For more information about all available input fields, please refer to the JIRA Api documentation depending on your JIRA version.

Output

  • Each step generates generic output, please refer to this link for more information.
  • The api response of this jira_new_issues 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.

Note: response.data returns all the fields returned by JIRA API.

Examples:

  • With default site from global variables.

    node {
  stage('JIRA') {
    # Look at IssueInput class for more information.
    def testIssue1 = [fields: [ project: [id: '10000'],
                                summary: 'New JIRA Created from Jenkins.',
                                description: 'New JIRA Created from Jenkins.',
                                issuetype: [id: '3']]]


    def testIssue2 = [fields: [ project: [id: '10000'],
                                summary: 'New JIRA Created from Jenkins.',
                                description: 'New JIRA Created from Jenkins.',
                                issuetype: [id: '3']]]

    def testIssues = [issueUpdates: [testIssue1, testIssue2]]

    response = jiraNewIssues issues: testIssues

    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']) {
      # Look at IssueInput class for more information.
      def testIssue1 = [fields: [ project: [id: '10000'],
                                  summary: 'New JIRA Created from Jenkins.',
                                  description: 'New JIRA Created from Jenkins.',
                                  issuetype: [id: '3']]]


      def testIssue2 = [fields: [ project: [id: '10000'],
                                  summary: 'New JIRA Created from Jenkins.',
                                  description: 'New JIRA Created from Jenkins.',
                                  issuetype: [id: '3']]]

      def testIssues = [issueUpdates: [testIssue1, testIssue2]]

      response = jiraNewIssues issues: testIssues

      echo response.successful.toString()
      echo response.data.toString()
    }
  }
}

  • Without environment variables.

    # Look at IssueInput class for more information.
def testIssue1 = [fields: [ project: [id: '10000'],
                            summary: 'New JIRA Created from Jenkins.',
                            issuetype: [id: '3']]]


def testIssue2 = [fields: [ project: [id: '10000'],
                            summary: 'New JIRA Created from Jenkins.',
                            description: 'New JIRA Created from Jenkins.',
                            issuetype: [id: '3']]]

def testIssues = [issueUpdates: [testIssue1, testIssue2]]

response = jiraNewIssues issues: testIssues, site: 'LOCAL'

echo response.successful.toString()
echo response.data.toString()
Tags: steps