For teams that work with Jira sprints, ActivityTimeline can display assigned sprint issues on user timelines using the sprint start and end dates.
This is the default behavior when:
-
The issue belongs to an active or planned Jira sprint.
-
The sprint has defined Start and End dates.
-
The issue is assigned to a user.
-
The issue does not already have mapped start and end dates that take priority over sprint dates.
This allows users’ timelines to be populated automatically without manually scheduling each sprint issue on the Planner.
How It Works
When this option is enabled (default), ActivityTimeline can use the start and end dates of the Jira sprint as the planned dates for the issues included in that sprint.
This is useful when:
-
Your team plans work in Jira sprints.
-
Sprint dates are already defined in Jira.
-
Issues are assigned to users.
-
You want sprint issues to appear automatically on users’ timelines in ActivityTimeline.
Date Field Priority
By default, ActivityTimeline gives higher priority to mapped Issue Start Date and Issue End Date fields than to sprint dates.
This means that if an issue already has mapped start and end dates in Jira, ActivityTimeline will use those dates instead of the sprint dates.
To display issues based on sprint dates, make sure that:
-
The mapped Issue Start/End Date fields are empty in Jira, or
-
Start/End Date fields are not mapped in ActivityTimeline.
Prioritizing Sprint Dates
If you want ActivityTimeline to always display issues based on sprint dates when a sprint is selected, you can enable the custom functionality.
To enable it, go to:
Configuration → Advanced Settings → Custom Functionality
Paste the following value:
PRIORITIZE_SPRINT_DATES
Then click Update.
When PRIORITIZE_SPRINT_DATES is enabled, manually dragging and dropping tasks on the Planner may behave differently.
For example, if you drag a task from the Issue Panel to a user or move it from one user to another, the task will initially appear on the dates where you dropped it.
However, after refreshing the Planner, the task will be displayed according to the sprint start and end dates.
