Skip to main content

​
Baselines Widget Parameters

NameTypeDefaultDescription
Show BaselinesBooleanfalseWhen enabled, the Gantt automatically loads and displays baseline data on every page load using the configured Compare to date value.
Compare to dateStringEmptyThe default comparison reference point. Accepts a relative date (T-minus), a specific date, or a page parameter reference. Only visible when Show Baselines is true.
The Compare to date parameter only appears in the widget parameter editor after you set Show Baselines to Yes.

​
Comparison Modes

The Gantt supports three methods for comparing the current schedule against a historical snapshot:
ModeDescriptionAvailable Since
Specific dateSelect a calendar date to compare against. The Gantt loads task positions as of that date.Version 1.5
Named baselineSelect a named Polarion baseline from a dropdown. The baseline revision provides the historical snapshot.Version 2.4.0
SVN revisionEnter a specific SVN revision number. The system validates the revision exists before applying.Version 25.3.0
diagram

​
Automatic vs. One-Time Comparison

Automatic comparison (Show Baselines = Yes): The Gantt loads baseline data on every page render using the Compare to date value. Baseline bars are always visible. One-time comparison (toolbar button): Click the Compare with History toolbar button to open a dialog where you select the comparison mode and reference point. The comparison persists until you close it or navigate away.
When Show Baselines is configured but the user triggers a one-time comparison with a different date, the one-time comparison takes precedence and refreshes the baseline display.

​
Compare to Date Formats

The Compare to date widget parameter accepts the following formats:
FormatExampleDescription
Relative (T-minus)T-30Compare against the schedule 30 days ago.
Specific date2024-01-15Compare against a fixed historical date.
Page parameter$pageParamUse a Polarion page parameter value, allowing users to pick the date dynamically.

​
NEW Badge for Added Tasks

Since version 25.3.0, tasks created after the selected comparison point are marked with a NEW badge. This helps you identify work items that were added to the schedule after the baseline was taken.

​
Baseline Data Fields

When baseline comparison is active, the Gantt data response includes two additional fields per task:
FieldTypeDescription
planned_start_dateDateThe start date of the task as of the comparison date.
planned_durationNumberThe duration (in working days) of the task as of the comparison date.
These fields drive the secondary baseline bar rendered below each current task bar.

​
Baseline API

Named baselines are fetched from the Polarion server via the baselines API endpoint. Each baseline record contains:
FieldTypeDescription
revisionIdStringThe SVN revision number associated with the baseline.
nameStringThe user-defined name of the baseline.
createdDateThe creation timestamp of the baseline.

​
Pre-Conditions

  • Unsaved changes: The Compare with History dialog cannot be opened when the Gantt has unsaved edits. Save or discard changes before comparing.
  • Read-only mode: Baseline comparison is fully available in read-only mode.

​
Item Script Approach

For item-specific baselines (instead of a single historical date), use the Item Script API to set planned dates per item: 
task.planned_start_date = util.getDate(wi, "gantt_initial_start");
task.planned_duration = util.getDuration(wi, "gantt_initial_duration");
This compares each item against its own saved initial schedule rather than a single global date.

​
Configuration Example

To show automatic baseline comparison against a date 30 days ago:
  1. Open Widget Properties for the Gantt widget.
  2. In the Baselines section:
    • Set Show Baselines to Yes.
    • Set Compare to date to T-30.
  3. Save the widget parameters.
The Gantt chart now displays baseline bars on every load, comparing the current schedule against the state 30 days prior.
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/impl/types/TypeConfigWidgetParameters.java
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/model/impl/BaselineDTO.java
  • prod-gantt-src/com.nextedy.polarion.gantt.client/cypress/e2e/gantt-Baseline.cy.ts
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/main.js