Skip to content

Import issues from YAML file

David Michel edited this page Apr 22, 2015 · 10 revisions

This plugin allows you to import requirements from a YAML file and convert them to issues.

## Import issues

In a project's menu, you will find a tab called 'Import'. From there, you will be able to upload a YAML file that describes requirements. Once you click on the 'save' button, the requirements will be loaded and converted to issues.

Example of YAML file that can be imported :

---
requirements:
 - name: My Awesome Issue
   description: A very important awesome issue
   charge: 9.5
   type: my_tracker
   start_date: 01/04/2015
   effective_date: 20/04/2015
   priority: 1
   category: A Project's Category
   children:
    - name: My Awesome Sub-Issue
      description:
      charge: 9.5
      type: my_tracker

import issues into a project's version

If you want to create the issues in a specific project's version. You can select the version from the IHM or you can also indicate a version in the YAML file. If the version doesn't exist, it will be automatically created.

Example of YAML file with a version:

---
version:
 name: My Version
 date: 20/04/2015

requirements:
 - name: My Awesome Issue
   description: A very important awesome issue
   charge: 9.5
   type: my_tracker

assign a user to an issue

You can assign a user to an issue directly from the YAML file. By default, the issues created are assigned to the current Redmine user, but you can override this by setting the property assignee to a requirement with the login of another Redmine user.

Example of YAML file with a user assigned to a requirement:

---
requirements:
 - name: Learn something
   description: A very important awesome issue
   assignee: jsnow
   type: my_tracker

## create a checklist in an issue

If you use the Checklist Redmine Plugin, you can import a checklist directly from the YAML file.

Example:

---
requirements:
 - name: My Awesome Issue
   description: A very important awesome issue
   type: my_tracker
   checklist:
    - item 1
    - item 2
    - item 3
Clone this wiki locally