You are viewing documentation for the older version of YouTrack!

Icon
Skip to end of metadata
Go to start of metadata

Before you begin:

Icon

Please note that if you try to re-import same project several times, then you must delete previously imported data before the next attempt.

Importing Issues from Redmine

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

Version compatibility note
  • Current implementation of the import script is compatible with YouTrack 4.x REST API and Python 2.6.
  • YouTrack supports import from Redmine 1.4.6 and higher
  • Depending on Redmine version, some import options are not supported:
    • User groups import is supported starting with Redmine 2.1
    • Role permissions import is supported starting with Redmine 2.2

To import issues from a Redmine server to YouTrack:

  1. In your Redmine instance, ensure that REST support is enabled: open Administration > Settings > Authentication tab and select the "Enable REST web service" check box.
  2. Download the latest version of YouTrack's Python Client Library and unzip it.
  3. Ensure that Python is installed in your system.
  4. If needed, correct the default mapping file.
  5. Run the script. The script supports two authentication options for Redmine: using login/password pair or using the API key. Thus, you can use either of them with the respective command:
    Icon

    Please note that you should use user accounts with administrator permissions. Otherwise, some data might not be imported.

    • To run import with API key authentication use -a option:

      Parameter

      Description

      r_url

      Redmine URL

      api_key

      Redmine API Key. Redmine API key can be found on your user account page.

      y_url

      YouTrack base URL

      y_user

      YouTrack user

      y_password

      YouTrack user's password

      project_id

      Redmine project identifier

    • To run import using login/password pair, use the following command:

      Parameter

      Description

      r_url

      Redmine URL

      r_user

      Redmine user

      r_password

      Redmine user's password

      y_url

      YouTrack base URL

      y_user

      YouTrack user

      y_password

      YouTrack user's password

      project_id

      Redmine project identifier

That's it.

(tick) If you run the script with -h option, then short help file will be displayed.

Import notes

Redmine REST API does not support watchers and tags, thus they are not imported to YouTrack.

TimeTracking Import Support

Import of work items is currently not supported and will be available in YouTrack 4.2.
"SpentTime" field is not imported from Redmine. Data is taken from imported work items.

  • No labels