Skip to main content

​
Working Calendar Widget Parameters

​
Three-Level Calendar Cascade

The working calendar system resolves capacity through three levels, each overriding the previous:
diagram
Level 1 — Global Calendar: Defines the base working week (default: Monday—Friday, 8 hours/day). All resources inherit this calendar unless overridden. Level 2 — User Calendars: Personal calendars defined as Calendar-type work items in Polarion. Each calendar can include schedule exceptions (time off, holidays) and custom working hours per user. Level 3 — Team Assignments: Team assignment records that apply partial availability multipliers (e.g., a team member at 50% allocation on a project).

​
Progressive Disclosure

The working calendar parameters are interdependent. The widget parameter editor reveals options progressively:
  1. Enable Use Working Calendar — unlocks Load User Calendars, Next Years to Load, Previous Years to Load, and Cache Working Calendars.
  2. Enable Load User Calendars — unlocks Load Team Assignments.
  3. Enable Load Team Assignments — loads team capacity data.
Set Next Years to Load and Previous Years to Load to 1 or 2 for typical use. Higher values increase memory usage and Gantt startup time.

​
Administration Properties

To use work item calendars from another Polarion project, configure these properties under Administration > Configuration Properties:
Both properties must be set in the calendar source project and in any projects that consume the calendar data.
For detailed administration property reference, see Calendar and Working Hours Properties.

​
Calendar Cache

When Cache Working Calendars is enabled:
  • The server caches computed calendar data between page loads.
  • Repeated Gantt loads reuse cached calendar data, reducing load time.
  • After calendar changes (new holidays, modified working hours), you must clear the cache. Use the Clear Calendar Cache toolbar button, which appears when caching is active.

​
Resource Load and Calendars

Working calendars directly affect resource load calculations in the resource view:
  • Without calendars: All days are working days with equal capacity. Resource load is a simple task count or duration sum.
  • With global calendar: Non-working days (weekends, holidays) are excluded from capacity. Resource markers reflect actual working days.
  • With user calendars: Each user’s personal schedule exceptions (vacation, part-time hours) reduce their available capacity individually.
  • With team assignments: Team allocation percentages further adjust each user’s effective hours.

​
Configuration Example

To enable calendar-aware scheduling with user calendars:
  1. Open Widget Properties for the Gantt widget.
  2. In the Working Calendars section:
    • Set Use Working Calendar to Yes.
    • Set Load User Calendars to Yes.
    • Set Next Years to Load to 1.
    • Set Previous Years to Load to 1.
  3. Optionally enable Cache Working Calendars for faster repeated loads.
  4. In Administration > Configuration Properties, add:
  5. Save the widget parameters.
Last modified on July 10, 2026