Import from AgileZen

This document covers importing issues from AgileZen instance to YouTrack server using the Python Client Library.

Version compatibility note

Current implementation of the Python Client Library and the script for importing data from AgileZen is compatible with YouTrack 4.x (aka Fascination) REST API only and Python 2.6.

To import data from a AgileZen server to YouTrack:

Download the latest version of YouTrack's Python Client Library and unzip it.
Ensure that Python is installed in your system.

In the file agilezen2youtrack.py, which is located in the unzipped folder with the Python Client Library, specify the following parameters:

Parameter	Description
`source_token`	Your AgileZen API Key. Please refer to the AgileZen help server for details on how to enable API Key.
`target_url`	The URL of your YouTrack server, to which the data should be imported.
`target_login`	YouTrack administrator's login name for the target YouTRack server (for example, "root").
`target_password`	YouTrack administrator's password for the target YouTrack server.

When done configuring the script, execute the following command: python agilezen2youtrack.py
That's it! Your data from your AgileZen instance will be imported into your YouTrack instance.

How AgileZen Stories are Imported to YouTrack

When you import your data from AgileZen to YouTrack, your AgileZen projects, stories and tasks are imported according to the following rules:

For each of your AgileZen project, a new project with the same name is created in YouTrack.
A story becomes an issue with the "Type" field set to "Feature". In YouTrack Agile mode, by default, a feature (that is, AgileZen story) forms a swimlane.
A task becomes an issue with the "Type" field set to "Task", which is linked to the imported story as "subtask".
Story comments are imported as corresponding issue's comments.

Please note that the current version does not support import of attachments from AgileZen!

For each imported project in YouTrack the following issue fields are created and attached:

AgileZen Story Field	YouTrack Issue Field
Story Phase	The default issue field "State". In YouTrack Agile mode, States (that is, imported Phases) are the board columns. You can later configure which states you want to see on the board, and customize their parameters in the board's Settings.
Story Color	A new custom issue field "Color". When the import is finished, you can rename values in its bundle with a name that you associate with particular color). You can also use this field as the source field to colorize cards on the board. To do so, you should select this field in the board's Settings.
Story Status	A new field "Status" is created. This is a field of `enum[1]` type, and the bundle contains values like AgileZen statuses "Blocked", "Ready to pull", etc.
Story Size	Story size is imported to a new integer custom issue field Size. To use it consistently in YouTrack Agile mode, you should select it as Estimation field in the board's Settings.
Story Deadline	A custom issue field "Deadline", which is a date type field.

Last modified: 2 February 2017