Skip to main content

​
Per-Type Configuration Parameters

Each work item type added to the Work Item Types configuration block exposes the following sub-parameters:
NameTypeDefaultDescription
Presentation ModeEnumSee applicationControls how the type renders on the chart: as a regular task bar, a project (summary) bar, or a milestone diamond.
Parent ModeEnumSee applicationDetermines how parent-child hierarchy is resolved for this type. Options include link-role-based or enumeration-based parent resolution.
Parent EnumStringSee applicationWhen Parent Mode uses enumeration-based resolution, specifies the enum field to determine the parent work item.
Additional Dialog FieldsField listEmptyExtra work item fields displayed in the lightbox editor for this type, beyond the standard start/end/duration/progress fields.
Sync to PlansBooleanfalseWhen enabled, links work items of this type to a Polarion Plan and adds plan due date markers to the chart.
Enable CreateBooleanfalseWhen enabled, this type appears in the New toolbar dropdown, allowing users to create work items of this type directly from the Gantt chart.
Extra Child QueryStringEmptyA Lucene query that loads additional child items for this type beyond the standard parent-child link traversal.
Dynamic TypeBooleanfalseWhen enabled, the presentation mode of the work item is determined dynamically at runtime based on whether it has children.
Fields already bound as Start Field, End Field, Duration Field, or Progress Field in the Data Mapping Parameters cannot be added to Additional Dialog Fields. The system validates this at load time and logs a warning for invalid field references.

​
Default Work Item Types

The Gantt chart ships with three built-in work item type configurations:
Type IDPresentation ModeDescription
featureTask (leaf)Standard task bars displayed as individual bars on the chart.
workpackageProject (summary)Parent containers displayed as summary bars spanning child items.
releaseMilestoneMilestone-style containers rendered as diamond shapes with no duration.
The default types serve as a starting reference. Override them in the widget parameter editor to match your project’s work item type IDs (e.g., epic, story, task).

​
Presentation Modes

diagram Task — Rendered as a standard task bar with start date, end date, and duration. The bar is directly editable by dragging. Project — Rendered as a summary bar whose schedule is derived from its child items. You cannot directly drag the start or end date of a project-type item; it auto-calculates from children. Milestone — Rendered as a diamond shape at a single point in time. Milestones have no duration.

​
Collapse Behavior via Item Script

You can control the initial collapsed state of parent work items per type using the Item Script API: 
// Collapse all workpackage-type items by default
if (wi.getType().getId() === "workPackage") {
    task.open = false;
}
This sets the task.open property to false, causing the item to appear collapsed when the Gantt chart loads.

​
Work Items Gantt vs. Plans Gantt

The per-type configuration applies differently depending on the Gantt mode:
AspectWork Items GanttPlans Gantt
Type sourcePolarion work item type IDPlan template type
Presentation modesTask, Project, MilestoneProject, Milestone
Enable CreateCreates a new work itemCreates a new plan from a template
Parent resolutionLink roles or enumerationPlan hierarchy
Additional Dialog FieldsWork item custom fieldsPlan-level fields
For Plans Gantt configuration, see Plans Gantt Widget Parameters.

​
Configuration Example

To configure an epic type as a project container and a release type as a milestone:
  1. Open Widget Properties for the Gantt widget.
  2. In the Work Item Types section, add an entry for epic:
    • Set Presentation Mode to Project
    • Set Enable Create to Yes if you want users to create epics from the toolbar
  3. Add another entry for release:
    • Set Presentation Mode to Milestone
  4. Save the widget parameters.
Setting a type as Project or Milestone does not add or remove items from the Gantt view. It only changes how items of that type are rendered. The visible items are determined by the Work Items data set parameter in Work Items Gantt Widget Parameters.
KB ArticlesSupport TicketsSource Code
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/model/impl/types/TypeConfigWidgetParameters.java
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/model/Config.java
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/widget/GanttWidgetDependenciesProcessor.java
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/default.json
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/widget/GanttWidget.java