Importing data from Pivotal Tracker
Preparing Pivotal Tracker for data import into JIRA
In Pivotal Tracker, please ensure you have switched on Allow API Access in your Pivotal Project's Settings.
Running the Pivotal Tracker Import Wizard
Before you begin, please back up your JIRA data.
- Log in to JIRA as a user with the JIRA Administrators global permission.
- Choose > System. Select Import & Export > External System Import to open the Import external projects page.
- Select Pivotal Tracker to open the Connect with Pivotal Tracker page.
On the Connect with Pivotal Tracker page, specify the following:
Pivotal Username or Email Specify the user account that JIRA will use to access issues on your Pivotal Tracker site. Pivotal Password Specify the password of the user (above). Map user names
(in expanded Advanced tab)Select this checkbox if you want to modify the name details of Pivotal Tracker users (which would be associated with Pivotal Tracker issues) when these users are created in JIRA. Use an existing configuration file
(in expanded Advanced tab)Leave this checkbox cleared if you do not have a configuration file or if you want to create a new configuration file. Configuration files specify a mapping between fields in Pivotal Tracker and those in JIRA.
Note:- If you select this option, you will be asked to specify an Existing Configuration File.
- If you do not select this option, then at the end of the Pivotal Tracker Import Wizard, JIRA will create a configuration file which you can use for subsequent Pivotal Tracker imports (for re-use at this step of the Pivotal Tracker Import Wizard).
- Click the Next button to proceed to the Setup project mappings step of the Pivotal Tracker Import Wizard.
- On the Setup project mappings page, select which Pivotal Tracker projects you wish to import into JIRA.
All Pivotal Tracker projects are selected by default, so clear the checkboxes under Import of the Pivotal Tracker projects you do not wish to import into JIRA.
For Pivotal Tracker projects you wish to import into JIRA, click in Select a project and then do either of the following:- Select Create New from the drop-down menu and in the resulting Add A New Project dialog box, type the following:
- A new project Name.
- A new project Key.
This will be used as the prefix for all issue IDs in your JIRA project. - The Project Lead.
- Start typing the name (or key) of a project that already exists in JIRA or use the drop-down menu to select an existing JIRA project.
Only JIRA projects that use the PT Workflow Scheme (which is created with your first Pivotal Tracker import into JIRA) can be chosen from the Select a project list. The PT Workflow Scheme consists of the:- PT Workflow — mapped to all standard issue types.
- PT Subtask Workflow — mapped to JIRA's sub-task issue type.
- Use the Pivotal Tracker Import Wizard to import your issues into a new JIRA project. Upon doing so, JIRA will create the PT Workflow Scheme and PT Issue Type Scheme. The PT Issue Type Scheme consists of additional issue types that do not exist in a default JIRA installation, such as Chore and Release.
- (Optional) Delete this project if you do not intend to use it any further.
- Apply the PT Workflow Scheme and PT Issue Type Scheme to the existing JIRA project you want to import your Pivotal Tracker issues into. (See Defining a project for details.)
- Re-use the Pivotal Tracker Import Wizard to import your issues into this existing JIRA project.
- Select Create New from the drop-down menu and in the resulting Add A New Project dialog box, type the following:
- Click the Next button to proceed to the Setup user mappings step of the Pivotal Tracker Import Wizard.
If you did not select Map user names option above, skip to step 8. (The Next button will not be available.) - On the Setup user mappings step of the Pivotal Tracker Import Wizard, in the Target value in JIRA field:
- Specify the username of a JIRA user to match Pivotal Tracker users to existing JIRA users.
- Leave blank to add the Pivotal Tracker user's name details 'as is'. The user's Full Name in JIRA is derived from the Pivotal Tracker's username value and the JIRA username is derived from this Full Name (made lower-case).
- Specify the Full Name in JIRA to change a Pivotal Tracker's user's name details. The JIRA username is derived from this Full Name (made lower-case).
- Click the Begin Import button when you are ready to begin importing your Pivotal Tracker data into JIRA. The importer will display updates as the import progresses, then a success message when the import is complete.
Note:- If you experience problems with the import (or you are curious), click the download a detailed log link to reveal detailed information about the Pivotal Tracker Import Wizard process.
- If you need to import data from another Pivotal Tracker project or site with the same (or similar) settings to what you used through this procedure, click the save the configuration link to download a Pivotal Tracker configuration file, which you can use at the first step of the Pivotal Tracker Import Wizard.
Congratulations, you have successfully imported your Pivotal Tracker project(s) into JIRA! If you have any questions or encounter any problems, please contact Atlassian support.
Tips for importing Pivotal Tracker data into JIRA fields
The import process converts Pivotal Tracker data as follows:
Pivotal Tracker | JIRA | Import Notes |
---|---|---|
Project | Project | Each Pivotal Tracker project is imported into a new JIRA project. You can optionally import into an existing project if you have used the importer before. |
Story | Issue | Pivotal Tracker story types are recreated in JIRA. |
Summary | Summary | |
Comments | Comments | |
Attachments | Attachments | Attachments are extracted from the Pivotal Tracker database and saved to disk. The dates and user attaching the attachments will be retained. |
Status | Status | JIRA will recreate the Pivotal Tracker workflow and statuses during import. |
Labels | Labels | Pivotal Tracker labels with spaces are imported with underscores (JIRA does not support spaces in labels). |
Story ID | External issue ID and External issue URL | JIRA will create these as custom fields. |
Iterations | Fix Version/s | Past iterations in Pivotal are imported as released versions in JIRA. |
Story Estimates | Story Points | |
Order of stories | Rank | You will need to configure this custom field in JIRA after the import. If you are using JIRA Software, you may wish to activate issue ranking. This can be done either before or after importing your Pivotal Tracker data. |
Time Tracker | Time Tracking | If you use time tracking in Pivotal this data will be automatically imported into a new JIRA issue type called 'Chore' with a Summary field value of "Placeholder for imported time tracking data". |
User | User | The importer will automatically create JIRA users for any Pivotal Tracker users who do not exist in JIRA.
|
User Roles | Project Roles | Viewer = User ; Member = Developers ; Owner = Administrators |