User story: “I have a Microsoft Project plan and I want to export the tasks to my JIRA”.

First, install and start Task Adapter. Then follow these steps:

Create a config

To export tasks from a bug tracker like JIRA or a Microsoft Project file, you first need to create a “synchronization config” which will keep settings like your JIRA server URL, login, password, your Microsoft Project file location, etc.

Use “New Config” button on the main application page to create a new config.

Create config

Select two systems (Atlassian JIRA and Microsoft Project in this example). You can also provide a description. As you see, the headers don’t say “Source” and “Destination, but rather “System 1” and “System 2”. This is to indicate that you can transfer both ways, so it does not matter if you select JIRA on the left and Microsoft Project on the right, or the other way around. Once you click “Create” button, the new config file is created in your data directory (/taskadapter folder).

Configure.

Here is what you will see for a new Atlassian JIRA and Microsoft Project config:

Edit config for Atlassian JIRA and Microsoft Project

This page has two buttons to edit settings, two “start export” buttons and a “Fields mapping” panel.

Click the big blue buttons to configure Atlassian JIRA or Microsoft Project:

Edit JIRA Edit Microsoft Project

Configure Atlassian JIRA settings, like JIRA server URL, your JIRA login name and password.

Edit Atlassian JIRA settings

Here’s the complete description of the JIRA configuration dialog.

Close the JIRA configuration panel. Now click “Microsoft Project” button to open the project settings. Provide the file location -

Edit Microsoft Project settings in Task Adapter local mode

(This is the panel you see when you run Task Adapter in “local” mode. The server mode has a bit different one.)

Now close the Microsoft Project panel. You’re back to “Edit Config” screen. Select task fields you want to export.

You can change default mapping for some of them. E.g. JIRA’s “Due Date” field can be saved into “Finish” or “Deadline” field in a Microsoft Project file. See Microsoft Project configuration page for more details.

Edit config for Atlassian JIRA and Microsoft Project

Export tasks.

Click arrow-buttons to start export to the left or right system: Export left right

A confirmation dialog is shown when the tasks are loaded from the source system:

Export confirmation

You can change the fields mappings before the export. Only the selected fields will be transferred to the destination system.

Confirm Fields Mapping

The transfer result is shown on the next page with the number of tasks created or updated.

Open your JIRA web page in the browser to see the new tasks:

Update MSP File

Link to this page

You can update a Microsoft Project XML file with the data from an external system (Redmine/JIRA/MantisBT).

Either you want to export data from a Microsoft Project file to an external system OR Load data from an external system into the MSP XML file - In either case select “Id” field before the “save data” operation. ID selected

The task IDs provided by the external system will be saved in the specified field (“TEXT22” in this example) in the Microsoft Project XML file.

Use “Only update tasks present in the file” button:

Choose File Operation

Only the tasks which have “remote IDs” field set in the MSP file will be updated. The selected tasks will be re-loaded from the external system (JIRA in this example) and updated in the MSP XML file. The other tasks in the XML file will be left unchanged.