Skip to main content

​
Resource View Widget Parameters

NameTypeDefaultDescription
Show Resource ViewBooleanfalseMaster toggle that enables the resource view panel below the Gantt chart. All parameters below require this to be true.
Resource Load CalculationEnumSee applicationControls how resource utilization is calculated and displayed. See Load Modes below.
Resource FieldStringSee applicationThe Polarion work item field used to determine the assigned resource (user ID). Drives the resource view rows and the resource filter.
Resource LabelStringSee applicationControls the display label for each resource row in the resource view.
Show UnassignedBooleanSee applicationWhen enabled, displays an “Unassigned” row for tasks that have no resource assignment.
Items OK LimitIntegerSee applicationThe threshold number of items or hours below which the resource marker displays in the “OK” (green) color.
HeightIntegerSee applicationThe pixel height of the resource view panel.
The Resource Load Calculation, Resource Field, Resource Label, Show Unassigned, Items OK Limit, and Height parameters only appear in the widget parameter editor after you set Show Resource View to Yes. This progressive disclosure avoids clutter when the resource view is not in use.

​
Load Modes

The Resource Load Calculation parameter determines how workload is computed for each resource:
ModeValueDescription
Task countnumCounts the number of tasks assigned to the resource in each time period.
HourstimeSums the actual scheduled hours for each resource based on task duration and working calendar.
Remaining estimateremainingSums the remaining estimated hours for each resource in the visible time range.
Allocation percentageallocationCalculates the allocation percentage against the resource’s available capacity from the working calendar.
diagram

​
Resource Marker Colors

The resource view displays color-coded markers for each time cell:
Marker StateDefault ColorDescription
Within capacity (OK)#4CAF50 (green)The resource is at or below the configured capacity threshold.
Over capacityRed/orange gradientThe resource exceeds the capacity threshold, indicating overallocation.
You can customize these colors using the resourceMarkersColorConfig property in Color and Styling Properties.

​
Leaf Task Filtering

The onlyLeafTasks configuration property affects resource view calculations:
  • When onlyLeafTasks is true, only leaf tasks (tasks with no children) are counted in resource allocation.
  • Parent or summary tasks (presentation mode Project) are excluded from workload calculations.
  • Work items that have a parent presentation mode but no visible children due to filtering are treated as leaf items and included in calculations.
The exact behavior of filtered workpackages without visible children in resource calculations may vary by version. Verify the resource count behavior in your specific Gantt version.

​
Unassigned Resource Row

Tasks with no value in the configured Resource Field are grouped under a synthetic “Unassigned” resource row. This row uses the internal constant UNASSIGNED_ID and appears at the bottom of the resource view when Show Unassigned is enabled.

​
Team-Based Resource View

When team assignments are enabled (via Team and Resource Properties), the resource view displays team rows instead of individual user rows. In team mode:
  • Each team appears as a resource row with aggregated workload from all assigned tasks.
  • The lightbox shows a team picker instead of a user picker for the resource field.
  • Capacity is derived from team assignment records rather than individual working calendars.

​
Configuration Example

To enable a resource view showing hours-based allocation:
  1. Open Widget Properties for the Gantt widget.
  2. In the Resource View section, set Show Resource View to Yes.
  3. Set Resource Load Calculation to time (Hours).
  4. Set Resource Field to the Polarion field holding the assignee (e.g., assignee).
  5. Optionally enable Show Unassigned to see unassigned tasks.
  6. Save the widget parameters.
For accurate resource load calculations, enable Working Calendars so that non-working days, holidays, and per-user schedule exceptions are reflected in the capacity values.
KB ArticlesSupport TicketsSource Code
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/widget/GanttWidgetDependenciesProcessor.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/GanttWidget.java
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/model/impl/types/TypeConfigWidgetParameters.java
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/globals.js