File Importer

Description/Features

This plugin creates JIRA issues from text files copied into a specific import directory.

The text file contains one line for each JIRA issue field. The format is the field name, followed by a colon ':', followed by the content of the field.

When using a field name of "Summary", "Description", "Assignee" (or "Zusammenfassung", "Beschreibung", "Bearbeiter" if it is a german language JIRA), the standard JIRA fields will be filled out. Any other field name is expected to be the name of a custom field. The name can also include spaces but no colon as this is the delimiter in the import file.

For custom fields of Date/Time type, the contents must be of the format 'dd.MM.yyyy', for example 31.1.2011. If it is of type User, the contents must be the full name of a JIRA user.

If there is any problem with the input file, the issue is not created.

After the file is processed, it is deleted (even in the case of a syntax error or any other problem).

Installation

1. Copy the contents of the zip archive file into the $JIRA-Standalone/atlassian-jira/WEB-INF/classes directory. Note that the file fileservice.xml replaces an existing file, which is ok. If you have modified that file yourself or if you are using a JIRA release other than 4.0.2 you may want to manually modify your version instead of copying ours over your file.

2. After restarting JIRA, go to "Services" and click on the "File Handler" link. Add a new service of type xxx.

3. The Service must be configured individually: you need to define which project will hold the new issues, which issue type and priority it should have, the user name of the creator and finally the path to the import directory and the intervall between scans for new files.

Usage

Copy the import files to the import directory. After the defined interval the files will be read, issues will be created and the files will be deleted.

Examples

Example file (note that the corresponding custom fields must exist):

Zusammenfassung:Training Reisekostenabrechnung
Schulungsvorgang:Aktivschulung
Termin Schulung:01.04.2010
Schulungsinhalt:Änderungen der gesetzlichen Grundlagen der Reisekostenabrechnung
Beschreibung:Weitere Details zum angebotenen Training
Dokumente Link:http://www.company.de/
Referent:Hans-Peter Müller
Bearbeiter:Arne Schirmacher
Bereich:XY

Version History

Open Issues

Screenshots

none