Import from Trac

Import Details

Entity	Description
Projects	The Python script lets you import all issues from a source project at once. If the project does not already exist, a new project is created. The project name and ID are assigned based on the values from the Trac database. The user who executes the import script is set as the project owner.
Users	Several issue attributes like `reporterName` and `Assignee` store references to user accounts. For each account that does not match the login or email for an existing user in YouTrack, a new user account is created. There are two types of users in Trac: Registered users with a login and a password. These users are imported to YouTrack with their original name and email. Unregistered users who specified a name and an email address or a name only when creating or adding a comment the ticket. These users are imported only when an email address is provided. Users without email addresses are imported as guest. There is an option in the mapping file that lets you import all unregistered users as guest instead of creating new accounts in YouTrack. All new user accounts are assigned randomly-generated passwords. To log in to YouTrack, imported users must click the Reset password link on the login page and create a new password. warning References to users in the imported data are mapped to existing accounts in YouTrack. If a match is not found, a new user account is created. Imported users are allocated a license according to your subscription plan. For users that exceed your per-user license limit, the imported users are flagged as banned. For more information, see Ban User Accounts.
Custom Fields	If the import data contains a field that does not exist in YouTrack, the custom field is created and added to the target project. The field name and type are set according to the definitions in your mapping file. The properties for the custom field are set as follows: `autoAttached=true`, `isPrivate=false`, `defaultVisibility=false`.
Field Values	If the source file contains new values for an existing field, they are added to the current set of values.
Tags	Keywords in Track are imported as tags.
Work Items	Trac offers plugins that support time tracking. The import script automatically detects and imports time tracking values from supported plugins. These values are added to imported issues as work items.

Set Up Your Environment

To set up your environment:

Download and install Python. The Python Client Library is compatible with Python 2.7+. Python 3 releases are not supported. You can choose whichever installation directory you prefer.

The latest versions of macOS, CentOS, Red Hat Enterprise Linux (RHEL), and Ubuntu come with Python 2.7 out of the box. If you're working with any of these operating systems, continue with the next step.
Install the package that contains the import scripts. Open the command-line interface that is supported by your operating system and enter the following command:
```
pip install youtrack-scripts
```
- The import scripts are installed in your local environment.
- The youtrack package that contains the Python client library for the YouTrack REST API is installed automatically as a dependency.
If you prefer not to install the packages globally, you can install them for your user account only with the command:
```
pip install --user youtrack-scripts
```

Customize the Mapping Definitions

To customize the mapping definitions:

Locate the default mapping file for importing issues from Trac and open it for editing. This file is included in the installation package that contains the import scripts. The file is located in the youtrackutils/trackLib subdirectory and is saved as defaultTrac.py.
Update the mapping to ensure that all of the data that you want to import from the Trac database is mapped to the desired values in YouTrack. If the file contains one or more fields that you don't want to import, you can remove the references from the mapping file. For a description of the default mappings, see Default Mapping.
Set values for the parameters that manage user import:
- default_email — Assigns a default email address to users who are imported without an email.
- accept_non_authorised_users — If True, unregistered users are imported to YouTrack. If False, unregistered users are imported as guest.
If used, specify the time tracking plugin that is enabled in Trac. The default parameter in the mapping file is set to support_time_tracking = "auto", which detects and imports time tracking values from supported plugins automatically. You can also specify the plugin from which data is imported:

Value
Description
trachours
Imports data from the TracHoursPlugin.
timingandestimationplugin
Imports data from the TimingAndEstimationPlugin.
Save your changes and close the mapping file.

Value	Description
`trachours`	Imports data from the TracHoursPlugin.
`timingandestimationplugin`	Imports data from the TimingAndEstimationPlugin.

Import Your Data

To import your data:

Open the command-line interface that is supported by your operating system.
If necessary, change the current directory to the installation directory for Python. For example (Windows):
```
cd C:\Python27
```

Enter the following command:

trac2youtrack target_url target_login target_password project_ID project_name path_to_trac_environment

Replace the command-line parameters with values as described here:

Parameter	Description
`target_url`	The base URL of the target YouTrack server. For YouTrack InCloud instances, your base URL includes the trailing `/youtrack`. For example: `https://company.myjetbrains.com/youtrack`
`target_login`	The login for a YouTrack administrator account.
`target_password`	The password for the YouTrack administrator account.
`project_ID`	The ID of the target project in YouTrack.
`project_name`	The name of the target project in YouTrack.
`path_to_trac_environment`	The path to the source project in Trac.

The command executes the Python import script.
If successful, the following line is printed in the command-line interface for each issue:
```
Issue [ <issue ID> ] imported successfully
```

Check the project that you imported issues into and verify that the data is presented properly. If you are not satisfied with the results and want to re-import the data:
- Delete all of the issues that were created during import. If you imported issues into a new project, simply delete the project.
- Edit your mapping file.
- Run the import script again.

Default Mapping

The Python Client Library includes a default mapping file for importing issues from Trac to YouTrack. The file is saved as defaultTrac.py in the youtrackutils/tracLib subfolder of the repository.

Ticket Type

Tickets in Trac use the default types defect, enhancement, and task. The default mapping file contains a types dictionary that maps these values to corresponding values for the Type field in YouTrack.

types = {
    "defect"        :   "Bug",
    "enhancement"   :   "Feature",
    "task"          :   "Task",
}

Ticket Priority

priorities = {
    "trivial"       :   "Minor",            #Minor
    "minor"         :   "Normal",           #Normal
    "major"         :   "Major",            #Major
    "critical"      :   "Critical",         #Critical
    "blocker"       :   "Show-stopper"      #Show-stopper
}

Ticket Resolution and Status

resolutions = {
    "duplicate"     :   "Duplicate",
    "fixed"         :   "Fixed",
    "wontfix"       :   "Won't fix",
    "worksforme"    :   "Can't Reproduce",
    "invalid"       :   "Can't Reproduce"
    #               :   "To be discussed
}
    states = {
    "accepted"      :   "Submitted",
    "new"           :   "Open",
    "reopened"      :   "Reopened",
    "assigned"      :   "Submitted",
    "closed"        :   None
}

Ticket Fields

The field_names dictionary maps field names in Trac to custom fields in YouTrack. You can update the mappings in this section to import data to specific custom fields. The default mapping file only contains definitions for fields that do not match existing fields in YouTrack:

field_names = {
    "Resolution"        :   "State",
    "Status"            :   "State",
    "Owner"             :   "Assignee",
    "Version"           :   "Fix versions",
    "Component"         :   "Subsystem",
    "Test_five"         :   "YT Select"
}

Custom Field Types

The field_types dictionary maps data types in Trac to custom field types in YouTrack. If you have added fields to the mapping for custom fields, add a corresponding entry to this dictionary to define how the data is stored in YouTrack. The default mapping file contains definitions for the following field types:

field_types = {
    "Priority"          :   "enum[1]",
    "Type"              :   "enum[1]",
    "State"             :   "state[1]",
    "Fix versions"      :   "version[*]",
    "Affected versions" :   "version[*]",
    "Assignee"          :   "user[1]",
    "Severity"          :   "enum[1]",
    "YT Select"         :   "enum[*]",
    "Subsystem"         :   "ownedField[1]"
}

Import from Trac﻿

Import Details﻿

warning

Set Up Your Environment﻿

To set up your environment:﻿

Customize the Mapping Definitions﻿

To customize the mapping definitions:﻿

Import Your Data﻿

To import your data:﻿

Default Mapping﻿

Ticket Type﻿

Ticket Priority﻿

Ticket Resolution and Status﻿

Ticket Fields﻿

Custom Field Types﻿