YouTrack Standalone 2017.1 Help

Import from Redmine

This page provides instructions for importing issues from a Redmine instance to YouTrack with the Python Client Library.

Import Details

When you import issues from Redmine, be aware of the following mechanics:

  • The Redmine REST API does not support watchers and tags. These elements are not imported to YouTrack.
  • When you import work items from Redmine, the values that are stored in the SpentTime field are not imported to YouTrack. This data is derived from imported work items.

The Python script lets you import all issues from a source project at once. The target project is created automatically.

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:
    • To run import with API key authentication use -a option:
      python redmine2youtrack.py -a api_key r_url y_url y_user y_password [project_id ...]

      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:
      python redmine2youtrack.py r_url r_user r_pass y_url y_user y_password [project_id ...]

      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.

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

Last modified: 18 April 2017