The projects timeline is where you can get an overview of issue (and it's parents) scheduling.
You can see the time span for items, navigate back/forth and change the time scope to get a good overview of the time schedule for the project(s). You can also filter on different fields, making it easier to find things.
The timeline is available in the General panel, and a Project specific Timeline is also available as a View option under the Issues tab.
The toolbar have these sections:
This section contains four arrows: forward, fast forward, backward and fast backward.
- The single step arrows will move the vieved time interval one small step (In the 3 month view above, it would move 1 week back/forward).
- The fast forward/backward arrows will move the viewed time interval one whole interval. (In the 3 month view above, it would move 3 months back/forward)
This section allows you to choose the scope of the viewed interval. Just click on the relevant button to change the time interva. These options are available:
- 1 Day
- 1 Week
- 4 Weeks (the default)
- 3 Months
- 6 Months
- 1 Year
- Zoom to fit - adapts the view so that all items included in the Timeline fit in the current view
This section contains checkboxes for each item time to control which items are shown in the timeline. Check any option or all of these:
Note that only the lowest level of checked items are movable. If you want to say, move releases by drag-n-drop, you need to hide projects, sprints and issues.
This section allows you to filter the items. The checkbox dropdowns allow for multiple selections, allowing you to narrow down your view to what you want to see. The Timeline should remember your last chosen filters.
These filters are available:
- Project Category
- Owner group
Forces a refresh of the grid.
If you click on the 'Settings' button a new dialog is displayed with more options for the Timeline:
This section contains checkboxes with options for how item modification affect other items.
Note: The "Recalculate parents" and "Recalculate children" options are mutually exclusive.
- Cascade changes - if this is set, then moving an issue or sprint that is linked to others will move the linked issues in tandem with the issue/sprint you're changing.
- Recalculate parents - if this is set, the parent item (for example a sprint that has multiple issues) are having its start date and end date dependent on its children. The parent start date is set to the same start date as the first issue/child item. The parent end date is likewise set to the end date of the last issue/child.
- Recalculate children - If this is set, then changing the start date of a parent will move the start dates of the children the same amount of time. (Ex: A sprint has its start date pushed 7 days into the future - then this setting will update the start date of all the issues in the sprint by adding 7 days to each. There is currently no check for the Due date.
This section allows the user to decide how to calculate the progress of items.
- Estimated time - The task completion bar is calculated on the amount of Estimated time set on the issues. The percentage is 100*(Est. time - Remaining time)/Est. time. For a sprint/project etc, the percentage is calculated on the total Est. time and Remaining time for the issues on the parent item.
- Completed status - The task completion bar is calculated by dividing the number of completed issues on the parent item with the total number of issues. i.e 100*(number completed issues)/(total number of issues)
Show the help info in the knowledge base (KB). In fact, it should lead to this article!
Examine and manipulate items in the timeline:
You can examine and manipulate objects in the timeline in a couple of ways:
- Right clicking on an issue name in the left side will open the full context menu for issues.
- Right clicking on other items will give you option to open the product/release/project/sprint in its own tab.
- Click on the start/end dates to open a date editor.
- Hover the mouse over an item to see its name, start/end dates and progress in a hovertext. The progress percentage is calculated by dividing the sum actual time on the issues divided by the sum of all estimated time, and multiplying by 100.
- Dragging/dropping: Note that only the "lowest" item type can be moved/resized. This is issues by default. If you want to move somethinge else in the timeline, you need to uncheck items in the "Show section.