Skip to main content

​
Step 1: Verify Working Calendar Toggle Hierarchy

The working calendar parameters follow a strict dependency chain. Each level must be enabled before the next becomes available:
  1. Open the Gantt widget parameters
  2. Navigate to the Working Calendars section
  3. Confirm the toggles are enabled in order:
    • Use Working Calendar must be Yes
    • Load User Calendars only appears when Use Working Calendar is Yes
    • Load Team Assignments only appears when both above are Yes
diagram
If you do not see the Load User Calendars option, check that Use Working Calendar is set to Yes first. The sub-options are hidden until their parent toggle is enabled.

​
Step 2: Check Calendar Project Configuration Properties

If user calendars are not loading, verify that the required administration properties are set in Administration > Configuration Properties for both the calendar project and the consuming project: 
nextedy.gantt.workitemCalendar.projectId=<PROJECTID>
nextedy.gantt.workitemCalendar.globalID=<WORKITEMID>
  • Replace <PROJECTID> with the project ID of the work item calendar project
  • Replace <WORKITEMID> with the work item ID of the calendar work item used as the global calendar
These properties must be configured in both the work item calendar project and every project that uses it. Missing either side causes silent failures where calendars appear empty.

​
Step 3: Verify Assignee Configuration on Calendar Items

Calendar work items must have the correct assignee set to link to a resource in the Gantt chart.
Calendar Item TypeRequired FieldsPurpose
CalendarAssignee, From/To dates, Weekday hoursDefines regular working schedule
Time OffAssignee, From/To datesMarks non-working periods
Time OnAssignee, From/To datesOverrides Time Off for a user
TweakAssignee, From/To dates, Work Start/EndAdjusts hours for a specific period
Calendar items without an assignee will not be associated with any resource. Ensure every user-specific calendar work item has the correct Polarion user set as the assignee.
Calendar work items use the inherits from link role for parent-child inheritance and the affects link role for exceptions (Time Off, Time On, Tweak).
  • User calendars should have a parent link to the global calendar via inherits from
  • Exception items (Time Off, Time On, Tweak) must be linked to their target calendar via affects
If exception items are not linked to a calendar via the affects link role, they will be silently ignored by the Gantt chart regardless of their date settings.

​
Step 5: Address Version-Specific Regressions

If user calendar changes stop reflecting in resource allocation bubbles after an upgrade:
  • Versions v25.7.0 through v25.8.0 contain a known regression where user calendar loading breaks due to workflow field handling
  • Upgrade to v25.9.0 or later to resolve this issue
  • As a workaround, roll back to v24.10.1 if upgrading is not immediately possible

​
Step 6: Clear the Calendar Cache

If calendar changes are not reflected after editing calendar work items, the server-side calendar cache may be stale.
  • Set nextedy.gantt.workingCalendar.useCache to true in Administration properties if caching is enabled
  • Clear the cache via the /api/clearCalendarCache endpoint or wait for the scheduled clear job to run

​
Verification

You should now see:
  • The Working Calendars section in widget parameters shows all three toggles in sequence
  • User-specific non-working days appear as gray areas on the resource view
  • Resource allocation markers reflect correct capacity based on each user’s calendar
  • Time Off, Time On, and Tweak items correctly adjust the displayed availability

​
See Also

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.client/src/types/state.d.ts
  • prod-gantt-src/com.nextedy.polarion.gantt.client/cypress/e2e/gantt-scripts/hideResourceOptionsIfResourceHidden.cy.ts
  • prod-gantt-src/com.nextedy.polarion.gantt.client/cypress/e2e/Aresource-view/AganttInitialEstimation.cy.ts
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/model/impl/CalendarCache.java