Skip to main content

Prerequisites

  • Gantt version 4.4.0 or later (the version that added mapping of advanced dependencies to Polarion link roles)
  • A Dependency Role already configured in the widget parameters (see Create and Configure Dependency Links)
1

Enable Advanced Dependencies

Open Project / Repository Administration > Configuration Properties and add:
This tells the Gantt to preserve the specific dependency type when you create or edit a link. Without this property, every dependency link is automatically converted to Finish-to-Start.
2

Hide the Metadata Field

When advanced dependency types are enabled, the Gantt stores type and lag information in a custom field called gantt_dependency_metadata. End users should not see or edit this field directly.
  1. Open Administration > Form Configuration for the relevant work item types.
  2. Locate the gantt_dependency_metadata field.
  3. Mark it as hidden so it does not appear on work item forms.
Polarion Form Layout Configuration editor with the allCustomFields panel showing the gantt_dependency_metadata field entry
Removing or renaming gantt_dependency_metadata will cause the Gantt to lose all advanced dependency type information. Always keep the field — just hide it from users.
3

Map Dependency Types to Link Roles (Optional)

By default, all four dependency types share the same Polarion link role. If your project requires separate link roles for each type, add the following to Configuration Properties:
Replace each value with the actual Polarion link role ID used in your project.
You can specify a comma-separated list of link role IDs if different work item types use different dependency roles. For example:

Dependency Types Reference

All constraints allow the target to shift later — they define the earliest possible start or finish, not an exact alignment.
Finish-to-Start link: the arrow leaves the end of Mark a book as favorite and connects to the start of Maintain the list of favorites
Start-to-Start link: the arrow leaves the start of Mark a book as favorite and connects to the start of the Maintain task
Finish-to-Finish link: the arrow leaves the end of Mark a book as favorite and connects to the end of Maintain the list of favorites
Start-to-Finish link: the arrow leaves the start of Mark a book as favorite and connects to the end of Maintain the list of favorites
1

Create a Dependency Link with a Specific Type

  1. Enter Edit mode on the Gantt chart.
  2. Drag from the link circle on one task bar to another task bar to create a dependency link.
  3. The dependency type is assigned based on which edge (start or end) you drag from and drop onto.
If dependency links are not loaded due to item limits or filtering, the Gantt ignores them entirely. This affects both visualization and auto-scheduling calculations.
2

Identify Constraint Violations

When a dependency constraint is violated — for example, a Start-to-Finish link where the target task ends before the source task starts — the Gantt displays a red dotted line beneath the incorrectly positioned task bar.
A red dotted line running beneath the Maintain the list of favorites task bar, flagging a violated dependency constraint
To resolve the violation, drag the affected task bar so its dates satisfy the dependency constraint.

Verification

You should now see:
  • Dependency arrows drawn between tasks reflecting the specific type (FS, SS, FF, or SF)
  • The link type preserved when you save and reload the Gantt chart
  • Red dotted violation indicators appearing when a task position violates its dependency constraint

See Also

Last modified on July 10, 2026