Skip to main content
There is no native one-click import from MS Project. This workflow requires exporting XML from MS Project and using the Polarion REST API to create work items and dependency links.

Prerequisites

  • MS Project file with tasks and dependency links defined
  • Access to the Polarion REST API
  • A Polarion project with the target work item types and link roles configured
  • Dependency roles configured in the Gantt widget parameters

Step 1: Export from MS Project

  1. Open your project in Microsoft Project
  2. Navigate to File > Save As
  3. Select XML Format (.xml) as the file type
  4. Save the file to a local directory
The exported XML contains task definitions, durations, start/end dates, and predecessor relationships with dependency types (FS, SS, FF, SF).

Step 2: Map Dependency Types

MS Project uses four dependency types that map to Gantt dependency link types:
MS Project TypeCodeGantt EquivalentDescription
Finish-to-StartFSfinish_to_startSuccessor starts after predecessor finishes
Start-to-StartSSstart_to_startBoth tasks start together
Finish-to-FinishFFfinish_to_finishBoth tasks finish together
Start-to-FinishSFstart_to_finishSuccessor finishes when predecessor starts
Before importing, ensure your Polarion project has link roles defined for each dependency type you plan to import. The Gantt Dependency Role widget parameter must reference these link roles for dependencies to appear on the chart.

Step 3: Create Work Items via REST API

Parse the MS Project XML and create corresponding Polarion work items using the Polarion REST API:
  1. Extract task names, start dates, end dates, and durations from the XML
  2. For each task, create a work item in Polarion with the mapped fields matching your Gantt data mapping configuration (e.g., gantt_start, gantt_duration)
  3. Record the mapping between MS Project task IDs and Polarion work item IDs
For each predecessor relationship in the MS Project XML:
  1. Look up the Polarion work item IDs for both the predecessor and successor tasks
  2. Create a typed work item link using the appropriate link role
  3. Set the dependency type based on the MS Project relationship type mapping
When configuring the Dependency Role widget parameter, the first selected role is used when creating new dependency links by dragging in the Gantt chart. Place your most common dependency type first.

Step 5: Configure the Gantt Widget

  1. Open your Gantt wiki page in edit mode
  2. Open the widget parameters
  3. Set the Dependency Role to include the link roles you used during import
  4. Set the Parent Role if you also imported parent-child hierarchies
  5. Save and reload the page

Verification

You should now see:
  • Imported tasks displayed as task bars on the Gantt chart
  • Dependency arrows drawn between linked tasks matching the original MS Project relationships
  • Auto-scheduling (if enabled) respecting the imported dependency structure

See Also

Support Tickets