Importing data from Bitbucket
The Jira Bitbucket Importer plugin allows you to import data from Bitbucket into your local Jira instance.
Before you begin
Note: For all of the following procedures, you must be logged in as a user with the Jira Administrators global permission.
- Install the Jira Bitbucket Importer plugin. For instructions on how to install a plugin, see Installing Marketplace apps.
- Ensure that you are using version 6.0.4 or later of the Jira Importers Plugin. This plugin is bundled with Jira. For instructions on how to update a plugin, see Updating apps.
- Back up your existing Jira data.
- Be sure that you have enabled the issue tracker on your Bitbucket repository and that you have administrator permission on it.
Import your Bitbucket data
The Jira Bitbucket Importer plugin provides a wizard that walks you through the process of importing data and integrating it with Jira. After you've installed it, run the wizard to import your Bitbucket data:
- Choose > System.
- In the Import & Export section, select Bitbucket.
Complete the fields as prompted in the wizard. Depending on how your sites are configured, you might be redirected to Bitbucket in order to set the authorization needed to export data.
If you are importing Bitbucket issues into an existing Jira project, you must choose the Jira workflow scheme used by that existing Jira project when you are prompted to select the workflow scheme. Otherwise, your import may not complete successfully.
In addition, you must map Bitbucket statuses to Jira statuses in order for Jira workflows to work with the issues.
Tips for importing Bitbucket data into Jira fields
The import process converts Bitbucket data as follows:
Bitbucket data is imported on a per-project basis. You can either specify an existing Jira project as the target, or the importer will automatically create one or more projects during the import. See Defining a project for more information about Jira projects.
Bitbucket subject is imported as the Jira issue summary.
|Worklog||Worklog||See Configuring time tracking.|
|Reporter||Reporter||Bitbucket issue author is mapped as Jira Issue Reporter.|
Attachments are extracted from Bitbucket and saved. Information on the date the file was attached and the user who attached it is retained, as well. To specify the location where the attachments are stored, see Configuring file attachments.
You can configure the mapping of specific kinds to specific Jira issue types.
You can configure the mapping of specific Bitbucket values to specific Jira values.
You can configure the mapping of specific Bitbucket values to specific Jira values, provided you create your workflows in Jira before running the importer.
You can choose to have the importer automatically create Jira users for any Bitbucket users who do not already exist in Jira.