Importing Data from Asana
The Asana importer for the Jira Importers plugin allows you to import data from Asana by connecting to a live Asana API.
The Asana import process consists of running the Asana Import Wizard, which will step you through the process to connect to Asana, and map and import your data to Jira. The Asana importer will connect to Asana using your Asana API Key. You can find it in your Asana account settings on https://asana.com - select the "APPS" tab, then click "API Key...".
The Asana importer will be able to access and import data from your all of your Asana workspaces. You don't have to select all your workspaces, the Asana importer will display all projects in all workspaces and allow you to map the Asana projects onto Jira projects.
If you have attachments in Asana and you want to import these too, you must ensure you have attachments enabled in Jira. Attachments are enabled by default.
Running the Asana Import Wizard
If your Jira installation has existing data, then before you begin, back up your existing Jira data.
- Log in to Jira as a user with the Jira Administrators global permission.
- The import wizard allows you to import data from other sources.Choose > System. Select Import & Export > External System Import to open the Import external projects page.
- Select Asana to open the Asana Import Wizard.
On the Asana Connection page, instead of providing regular credentials (login and password), please provide the Asana API key. Asana API Key is a single authentication token that can be used by external systems to connect to Asana for data extraction and insertion. You can find it in your Asana account settings on https://asana.com - select the "APPS" tab, then click "API Key...".
Click Next. The Map projects page displays, and will show a list of all your Asana projects within all the workspaces that you have in Asana.
- On the Map projects page, select the projects you want to import data from, and where you want to import it to.
All Asana projects are initially set to "Don't import this project". To import a project, you must either select an existing compatible project to import the data to, or create a new project.
To create a new project, 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.
- Click Next. On the Map fields page, select the workflow scheme you want to use for your newly created Jira projects.
- Click Next. The Map values page allows you to map your Asana tasks' scheduling status to Jira priorities, and the completion flag to Jira workflow steps.
- Click Next. On the Links page, you can choose how issues that are subtasks of one another will be linked in Jira.
Click Begin import.
- Success! You have completed importing your Asana data to Jira. If there were any errors or warnings, these will be displayed to make you aware that you may need to check some details.
- If you experience problems with the import (or you are curious), click the download a detailed log link to reveal detailed information about the Asana Import Wizard process.
- If you need to import data from another Asana project with the same (or similar) settings to what you used through this procedure, click the save the configuration link to download a Asana configuration file (this will be a text file), which you can use at the first step of the Asana Import Wizard.
- Before performing another import to the same project, you will want to remove the External issue ID field created in the previous import. Otherwise, the importer will associate existing imported issues with the next import, and will skip importing new issues up to the existing ID. For example, if you import 50 issues at first, they will be assigned IDs from 1 to 50. In the next imports, first 50 issues will be skipped, as their IDs will have already existed in Jira.
- Asana tasks can be created without a name. As Jira doesn't allow issues with no summary, such tasks will be given a default name and a warning will displayed in the log.
Congratulations, you have successfully imported your Asana repository data into Jira! If you have any questions or encounter any problems, please contact Atlassian support.