Structure.Gantt is a Structure extension, which brings planning and resource management features to structures.
Important: Structure.Gantt works with Structure 4.5 or newer, so please make sure you have the correct version installed.
Creating Your First Gantt Chart
If you are not familiar with Structure yet, the easiest way to create your first Gantt chart is through the Gantt Chart wizard. In a few steps you can define your structure and the parameters, which will be used for building the Gantt chart (tasks start and end finish dates, duration, dependencies and others).
Once you go through all the steps, the structure, its view and the corresponding Gantt chart are created. You can fine-tune your structure by adjusting the settings of the generators and you can adjust the Gantt chart settings by opening the Configuration, which was created for this chart (please read on for more details).
For an Existing Structure
If you already have a structure you want to use for your Gantt chart, you can select one of the existing configurations or create a new configuration for it manually:
- Open Structure Board and switch to the structure that contains issues that you would like to include in the plan.
- Use Layout menu to switch to either "Gantt Chart" or "Gantt + Resources" layout.
- You will see the Settings screen where you can set the project start date and select one of the available configurations.
- Click Save to save the settings and create the chart.
Gantt Chart configuration defines how the chart is built – where does the information come from, what fields are used, etc. The app comes with a predefined "Default" configuration, which has some default parameters. You can adjust the default configuration or create your own.
In the default configuration, the following settings are used:
- Time tracking is turned on for determining task duration. Default estimation is 1 day. Story Points are turned off.
- Finish-to-Start dependencies are represented by the “blocks” link type, if it is available (if you have BigGantt link types available, "Has to be done before" link will be used instead).
- Manual scheduling is disabled. To enable it, you will need to define which custom fields should be used. You can use existing fields or create new ones.
- Precision is set to 1 hour.
- Standard 40-hour work week calendar is selected as the default.
Creating a New Configuration
- Open the Setting page by clicking the Settings button on the left side of the chart toolbar.
- Click Manage next to the Configuration field to open the Gantt Configurations dialog.
- Click Create New Configuration (or click Edit next to one of the existing configurations to change it).
For detailed description of configuration options, see Configuration Options.
Gantt Chart Elements
Once you define the configuration and save the settings, the Gantt Chart opens.
You can manipulate your Gantt chart using the toolbar, the mouse and a number of keyboard shortcuts.
Gantt chart has the elements described below.
Use the Zoom control in the toolbar to zoom in, zoom out or select the desired zoom level.
Start Date and Current Date
Green vertical dashed line represents the project start and the red orange vertical line shows the current time. Mouse over the points that represent them on the timeline to see the exact dates and time.
Dependencies are shown as arrows between the tasks bars. Clicking the arrow will show the dependency details. To show/hide dependencies use the Options menu in the toolbar.
The cyclic dependencies and dependencies between groups and their children do not allow to schedule tasks correctly. They are highlighted with red and require attention.
You can show issues summaries and keys next to the bars in the chart. To do that, select them in the Display Options menu in the toolbar.
As you set the Start/Finish Date, the task is considered to be scheduled manually, which means that it will stay at the defined position regardless of its dependencies. To switch back to the Automatic scheduling mode, click the task to see the details panel and toggle the Scheduling option to Auto. This will remove the Start/Finish Date value and place the task after the task it depends on or at the project start if no dependencies exist. Removing the value from Start/Finish Date field also switches the task to Auto Scheduling.
You can use Time Tracking, Story Points or both as tasks duration. If you use Story Points, you will need to define how many hours are required to complete one story point.
To adjust duration, mouse over the right end of the task bar and once the mouse pointer changes to the resize tool, click and drag left or right to set the desired duration. If you are using Time Tracking, the Original Estimate field value will be updated for issues with no time logged and Remaining for the issue with time logged. You can also adjust it by changing the value of the Jira fields themselves.
Dependencies are defined based on Issue Links. Changing dependencies creates or removes links between issues (link type is defined in the configuration).
To remove the dependency, click the dependency arrow in the chart and click the Remove link in the Dependency Details panel.
Gantt Chart can show critical path. Tasks included in the critical path are highlighted with red color. To switch off this highlighting, use the Display Options menu in the toolbar.
You can also define the default Max Unit property - this is the property of the tasks, which defines how much of the resource capacity can be used when working on this task. By default it is set to 1. This means that if, for example, you have a resource with the capacity of 3, only one third of the resource will be used when working on a task. You can change both the default setting for the Max Unit and the setting for each individual task (by clicking the task and setting the value in the details panel).
Resource Allocation Chart
There are a number of parameters that a resource has. They taken into account when calculating tasks start/end dates and duration and resource allocation.
- CapacityUnits determines how much work can this resource do during one hour. By default, it is "1", which corresponds to one person. A 5-person team would have the value of "5". A person working only one day a week but using Standard work calendar would have the value "0.2".
- Calendar defines working and non-working time for the resource in the resource's time zone.
- Availability allows to define, what percentage of the resource capacity is used during a certain period. This is especially useful for defining resource vacation days or periods or part-time work.
- Time zone defines the time zone used for the resource.
The default values for these parameters are set in Gantt configuration. You can override them for a specific resource by selecting the resource in the resource panel and clicking the Resource Settings button.
This version comes with two predefined calendars, "Standard" (40-hour work week) and "24 Hour" (all time is work time).
JIRA administrator can define additional calendars through the Administration | Structure | Structure.Gantt | Work Calendars page.
The calendar is defined by the code in JSON format, which sets the working periods for each day of the week and lists exceptions.
A calendar may be based on another calendar. In this case its rules are lain over the rules from the parent calendar.
Gantt Chart Permissions
Currently there are no dedicated permission settings for Gantt and the permissions of the structure are used. Users with View permissions can only view the Gantt Chart. Users with Edit permissions can make changes (for example, set duration). Users with Structure control permissions can change the Gantt Chart settings.
All standard Jira permissions are applied too – you need Edit Issues permission to change the fields, create links, and so on.