Internal Importer

• Zephyr for JIRA now provides an in-house importer tool that allows users to import data straight from Excel and XML to JIRA.
• The importer tool utilizes a simple drag-and-drop feature to perform mapping of the issue fields with the Excel and XML fields to a JIRA story.
• Users are able to maintain persistent mapping for future reuse if there needs to be future imports.
• The Zephyr for Jira importer tool allows users the linking of test cases from Excel and XML to a JIRA story.

Click on the “Tests” menu at the top of the navigation bar and then click on the “Importer” tool to bring up the in-house importer tool.

1. Select the project that you want to import the issues to.

2. Select the issue type that you want to import.

• The importer tools allow users to import tests, requirements, tasks, stories, bugs, and epics.

3. Select the file type that you want to import from (either an Excel or XML file).

4. Browse for the Excel or XML file that you want to import

• You can select “Retrieve Mapping” to retrieve the columns so that you can map the fields in your file to the Zephyr fields.
• You can select “Save Mapping” to save any mapping you have below for future reuse.

5. Choose how to discriminate between the issues in your Excel/XML file and then determine the starting row.

• The starting row should be greater than 1 because the first row is usually the row with the header for each column.

6. If you have any previously saved mappings, you can use this select to use a saved mapping.

7. If you don’t have any saved mappings, you can map your import file to the fields that Zephyr for JIRA uses. Mapping is an extremely easy process that allows users to simply drag-and-drop the Excel/XML fields to the mapped fields.

8. After mapping your fields, click on the “Import” button to start importing the issues from the import file to Zephyr for JIRA.

External Importer

If your tests are in Excel:

You have a couple of different options to import them into JIRA:

1. Using the JIRA Importers Plugin
   You will have to convert your files to a CSV format and use this plugin to import your tests into JIRA. See http://confluence.atlassian.com/display/JIRA/Importing+Data+from+CSV for detailed instructions. Note that if you have detailed test steps in your tests, they CANNOT be imported using this mechanism. Use the next option for that.
   
   
2. Using the Zephyr for JIRA Tests Importer Utility
   This utility allows the importing of tests directly from Excel spreadsheets, including detailed test steps.

If your tests are in XML format:

The Zephyr for JIRA Tests Importer Utility supports importing tests that are in the Testlink xml format, not the JIRA xml format yet.