Configuration Questions - Nextedy Documentation

What is the difference between widget parameters and administration properties?

Gantt uses two levels of configuration. Widget parameters are set per-widget instance on the Polarion page and control the behavior of that specific Gantt chart. Administration properties are set globally in the Polarion administration panel and apply to all Gantt widgets across the project or server. Widget parameters take precedence over administration properties when both define the same setting.

Configuration Level	Scope	Set Where	Example
Widget parameter	Per widget instance	Polarion page widget editor	`showResourceView`, `readonly`
Administration property	Project or server-wide	Polarion Administration panel	`nextedy.gantt.default.auto_scheduling`

How do I set up field mappings for the Gantt chart?

Field mappings tell the Gantt which Polarion work item fields to use for task start dates, end dates, duration, and progress. You need at least two of the three date fields configured: startField + endField, startField + durationField, or endField + durationField. The Gantt validates these mappings at render time and displays an error message if the combination is invalid.

You must configure at least two of startField, endField, and durationField. The Gantt widget will not render without a valid field mapping combination.

How do I configure dependency link roles?

Set the Dependency Role parameter (dependsRoles) to specify which Polarion link role IDs represent finish-to-start dependencies between tasks. Work items connected with these link roles appear as dependency arrows in the Gantt chart. Similarly, use Parent Role (parentRoles) to define which link roles represent parent-child hierarchical relationships displayed in the Gantt tree structure.

How do I configure the Gantt to show a specific work item type?

The work items shown in the Gantt are selected by the Work Items dataset parameter (query, collection, or scope) — there is no dedicated work item type parameter. Restrict the displayed type by writing the query accordingly, for example type:workpackage. See Work Items Gantt Widget Parameters for the dataset parameter. To control how each work item type renders (as a task bar, summary, or milestone), set the Gantt Presentation Mode per type in the Work Item Types Configuration.

The exact work item type IDs available depend on your Polarion project configuration. Check your project’s work item type definitions.

Can I make the Gantt chart read-only?

Yes, enable the Read-only parameter (readonly) to disable all editing capabilities. This hides the Edit button and prevents drag, resize, and add-task operations. Conversely, enable always-edit mode (alwaysedit) if you want the Gantt to always be in edit mode without requiring users to click an Edit button first.

How do I configure the resource field for task assignment?

The Resource Field parameter (resourceField) specifies which Polarion work item field is used as the assigned resource. This drives both the resource view display and the resource filter functionality. The field can be set to the assignee field, a category field, or a custom field depending on your resource management model.For full setup instructions, see Set Up a Basic Gantt Chart and the Reference documentation.