> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nextedy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Import Dependencies from MS Project

> Transfer dependency relationships from Microsoft Project into Polarion so that Nextedy GANTT can display and schedule tasks based on the imported links.

export const LastReviewed = ({date}) => {
  if (!date) return null;
  const formatted = new Date(`${date}T00:00:00Z`).toLocaleDateString("en-US", {
    year: "numeric",
    month: "long",
    day: "numeric",
    timeZone: "UTC"
  });
  return <p className="mt-10 text-sm text-gray-400 dark:text-zinc-500 not-prose">
      Last reviewed on {formatted}
    </p>;
};

<Info title="Verify in application">
  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.
</Info>

## 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

<Steps>
  <Step title="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>

  <Step title="Map Dependency Types">
    MS Project uses four dependency types that map to Gantt dependency link types:

    | MS Project Type  | Code | Gantt Equivalent   | Description                                 |
    | ---------------- | ---- | ------------------ | ------------------------------------------- |
    | Finish-to-Start  | FS   | `finish_to_start`  | Successor starts after predecessor finishes |
    | Start-to-Start   | SS   | `start_to_start`   | Both tasks start together                   |
    | Finish-to-Finish | FF   | `finish_to_finish` | Both tasks finish together                  |
    | Start-to-Finish  | SF   | `start_to_finish`  | Successor finishes when predecessor starts  |

    <Warning title="Link role configuration required">
      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.
    </Warning>
  </Step>

  <Step title="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
  </Step>

  <Step title="Create Dependency Links">
    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

    <Tip title="First link role is the default">
      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.
    </Tip>
  </Step>

  <Step title="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
  </Step>
</Steps>

## 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

* [Create and Configure Dependency Links](/gantt/guides/dependencies/create-dependency-links)
* [Configure Advanced Dependency Types (FS, SS, FF, SF)](/gantt/guides/dependencies/advanced-dependency-types)
* [Configure Auto-Scheduling](/gantt/guides/scheduling/configure-auto-scheduling)

<LastReviewed date="2026-07-02" />