1.1.1 How to create your Jira issue XML file ?

Goal

This section contains the instructions to create your own Jira issues files.

Jira issues files are XML files containing a list of issues. These files can be added to any Gaia template to generate new JIRA projects containing a list of pre-defined issues.

Pre-requisites

This tutorial was written considering that :

  • you have a Jira instance installed and running on your server;
  • you are logged in Jira.

Creating a Jira issues file

1. Go to the "Issues" menu in Jira 

In the top menu of a Jira window, find the "Issues" item. This menu shows existing filters and search options for finding issues based on search criteria. A Jira issues file can be generated from any filter or lists of issues.

2. Filter the issues you want to export :

Open an existing filter or launch a new JQL query to get the list of issues you want to export. If you need information on JQL, read this article.

Note

Please note that the maximum number of issues that can be exported is limited 1000. Also note that the more issues you try to import, the longer it will take. Please read 13370362 article regarding project creation timeout.

 

3. Generate the XML file :

Once the list of issues is ready to be exported, click the export button on the upper right corner of the page. Select "XML" from the drop-down list.

4. Save the generated file :

The generated file will be redirected and open automatically into your web browser. To save the file, search for a save option within the browser menus or hit Ctrl+S (which is normally the default shortcut on most browsers).

Do not cut & paste!

Tempted to select all, copy and paste to an external text editor, such as Notepad, or Eclipse ? Don't do that! By doing so, you will lose some important information related to file character encoding, making the XML file not compatible with the import mechanisms of the Gaia add-ons. We have had several support request for that. Please make sure you hit CTRL-S!



You're done!

There you go, you have a new JIRA issues file ready to use in a Gaia Activity Issue Template!

 

What's next

Now that you have you own JIRA Issue file, use it in a Gaia Activity and an Issue Template (see instructions here).

Knowledge level

MODERATE

Access level required

USER


Table of contents