1.1. Creating your own Jira issues 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.

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 automatically be displayed into your web browser. To save the file, search for a save option within the menus of your browser or hit Ctrl+S (which is normally the default shortcut on most browsers).

You're done!

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

Custom Field Support

If your issues have custom fields (these are automatically added in the XML file by the Jira exporter), Gaia will import the values of the associated custom fields (see supported custom field types) and associate the custom field to the project being created by Gaia.

If the custom field doesn't exist in the Jira instance, it will be automatically created and associated to the corresponding issue type (and to the project being created by Gaia).

If the custom field exists but doesn't have the right type, a new custom field will be created (with a (X) suffix) and will be automatically associated to the corresponding issue type (and to the project being created by Gaia).

Note

Only Jira's native custom field types that do not require options are automatically created if they do not already exists. If the custom field types that do require options exist but the options containted in the issues do not, those new options are not automaticity created.

For example, these custom fields types and associated options are not automatically created if they do not already exists:

Checkboxes;
Radio Buttons;
Select List (cascading);
Select List (multiple choices);
Select List (single choice).

What's next

Now that you have you own Jira template file, use it in a Gaia for Jira template. See the how to create a template guide for more information.

Knowledge level	LOW
Access level required	USER

Table of contents