GanttProject User Guide
GanttProject User Guide
Release 2.8
2
Table of Contents
Introduction ......................................................................................................................... 4
What’s new............................................................................................................................................. 4
Feedback................................................................................................................................................. 4
Get started ........................................................................................................................... 4
Downloading and installing GanttProject .............................................................................................. 4
Screen layout .......................................................................................................................................... 5
Overview of creating a project and adding tasks and resources ........................................................... 6
Projects ................................................................................................................................ 7
Creating a project ................................................................................................................................... 7
Changing project properties ................................................................................................................... 7
Opening and saving a project ................................................................................................................. 8
Resources ............................................................................................................................. 8
Resource roles ........................................................................................................................................ 8
Adding, modifying, deleting, and e-mailing a resource.......................................................................... 8
Changing the listed order of a resource ............................................................................................... 10
Tasks .................................................................................................................................. 10
Creating a task ...................................................................................................................................... 10
Creating a summary task ...................................................................................................................... 13
Modifying or deleting tasks .................................................................................................................. 14
Changing the listed order of tasks ........................................................................................................ 15
Linking and unlinking tasks ................................................................................................................... 15
Displaying critical path through tasks .................................................................................................. 16
Baselining task dates to see schedule changes .................................................................................... 16
Common operations .......................................................................................................... 17
Searching for a task or resource ........................................................................................................... 17
Cutting, copying, and pasting tasks and resources .............................................................................. 18
Undoing and redoing operations ......................................................................................................... 18
Printing tasks and resources................................................................................................................. 19
Viewing GanttProject version, license, and software libraries ............................................................ 19
Workspace, FTP, and CSV settings .................................................................................... 19
Changing days visible in a task or resource chart................................................................................. 19
Introduction
This user guide describes how to use GanttProject, which is a project management software application.
You can use it to create a schedule of tasks, assign resources to them, and track the progress of a
project. GanttProject is similar to Microsoft Project but has fewer features and is simpler. Also, it is
open-source software and has been in existence since 2003.
What’s new
New GanttProject features and enhancements are summarized in the following table.
GanttProject
Release Description
2.8 The use of all functionality in this release is
described in the first version of this guide.
Feedback
If you have comments on this document, please send them to [email protected].
Get started
To start using GanttProject, you first need to download and install it. Then, to quickly get oriented with
it, it helps to understand the overall layout of the task and resource screens, which are the two main
screens and are similar. Lastly, before starting to use GanttProject, it helps to understand the main steps
needed to create a project in it.
3. For option one, select an operating system, or, for option two, select the Free Download link.
4. Follow the on-screen instructions to download the installation software, which will be in an
executable file with a .exe extension.
5. GanttProject requires the Java Runtime Environment (JRE). If you do not have JRE on your
device, then download and install it by doing the following:
a. Select the provided Java link on the GanttProject webpage.
b. At the Java site, follow the on-screen instructions to download the JRE software, which
will be in an executable file with a .exe extension.
Screen layout
Figure 1 and 2 below show example screenshots of the tasks in a project and the associated resources in
that project, respectively. Many display options are available for these screens, especially for tasks, so
you can change the information displayed in them. These two screenshots are from the project in the
file HouseBuildingSample.gan. This file is in the folder named GanttProject-X.Y, which is named after a
specific version of GanttProject and is created when GanttProject is installed. You may want to open this
file to learn more about the ways GanttProject can be used to schedule and track a project.
Both screenshots in the figures contain a panel on the left for the tasks or resources in the project and a
corresponding chart in the area on the right. This house building project runs for about 20 weeks, but
only the first 7 weeks are shown in the charts. Some additional explanatory information is provided in
the callouts on the screenshots.
Milestone
name
Summary
task Milestone
indicator
Black bar
represents
percentage of
task completed
Diagonal lines Note on
indicate a task task in
on critical path this row
Red indicates
resource is
utilized more
than 100%
Resource
Green indicates
resource is
Tasks for utilized less
resource Gray indicates
than 100% resource is
utilized 100%
5. Links: If you did not add all needed links in the previous step, then link tasks, as described in To
link tasks.
Projects
Before creating a task schedule and associated needed resources, you first create a project that will
contain them. In a project, you can also create resource roles, such as developer and tester, which you
can assign to resources. Also, you can create a calendar of holidays and nonwork days. After creating a
project, you then save this information in a project file.
Creating a project
You can create a project that contains the name of the project, resource roles, which you can assign to
resources, and a calendar of holidays and nonwork days. Later you can add tasks and associated
resources to the project.
To create a project
1. Select Project > New or Ctrl+N.
2. In the dialog box, enter a name for the project and other information as needed.
3. Select Next.
4. (Optional) Select from available role sets to add the included roles to the project. You can hover
over a role set to see the included roles.
5. Select Next.
6. Configure holidays and nonwork days for the project as needed.
✓ Tip: You can also import a holiday calendar, as described in To import a holiday calendar
in an iCalendar file.
7. Select OK.
To open a project
• Go to Project > Open.
To save a project
• Select Project > Save or Project > Save As.
Resources
Resources are typically used for people who complete tasks but could be for things, such as equipment
or materials, that are needed for tasks. You can create resources and roles for them, such as developer
and tester. Later, when you create tasks, you can assign these resources to them.
Resource roles
You can create resource roles, such as developer and tester, and then assign these roles to resources.
These roles are maintained in a project’s Properties. For information on adding and deleting resource
roles, see the subsections on roles in Changing project properties.
To add a resource
1. Go to the Resources Chart tab.
To modify a resource
1. Go to the Resources Chart tab.
2. Double-click the resource that needs to be modified.
3. Change the contact information, role, pay rate, days off, and other information as needed.
4. Select OK.
To delete a resource
1. Go to the Resources Chart tab.
2. Select the resource to delete.
3. Select Delete resource or the Delete key.
Warning: There is not a confirmation step for this delete operation. However, if a
resource is accidentally deleted, you can restore it by selecting Undo .
To e-mail a resource
1. Go to the Resources Chart tab.
2. Select the resource to e-mail.
3. Right-click on the selected resource and select Send an e-mail. A message composition window
will open using your default e-mail program. Note that the e-mail address used is taken from the
Mail entry in the resource’s Properties.
Tasks
You can create and link tasks that you want to track in a project. Also, to organize tasks and better
visualize projects that contain many tasks, you can create summary tasks that contain subtasks.
Additionally, you can show the critical path through the tasks in a chart to see the tasks that determine
when a project completes. You can also create baselined copies of a chart and then later display a
comparison of one to a changed version of the chart, such as after some tasks are delayed.
Creating a task
When you create a task, you can select dates for it, such as for starting and completing the task, create
links from other tasks, and select resources needed for the task.
To create a task
1. Go to the Gantt tab.
2. If you want to create the task directly below an existing task in the task panel, select that task.
Otherwise, the task will be created at the bottom of the current list of tasks.
3. Do one of the following:
• Select New task , Ctrl+T, or Tasks > New Task.
• Right-click in the task panel or chart and select New task.
4. Enter the name of the task and then select the Enter key.
✓ Tip: If you select Alt+Enter here instead of Enter, you can skip the next step.
5. Double-click the new task to open it.
• Earliest begin: Select if there is a restriction on the earliest date the task can start. Also,
select the associated Copy begin date link to use the value of the task’s Begin date.
• Priority: Select the priority of the task. The priority can be displayed as a small colored
circle in the Priority column in the task panel. The priority colors are as follows:
Priority Color Displayed in Priority Column
Lowest and Low Green
Normal Blue
High and Highest Red
For information on displaying the Priority column, see To show or hide task or resource
columns.
• Progress: Enter a value from 0 to 100 to indicate the percentage of the task that has
been completed. In the task chart, a horizontal black bar is displayed inside the task, and
the length of the bar corresponds to this percentage.
• Show in timeline: Select to display the task name immediately above the task’s start
date on the timeline at the top of the task chart.
• Shape: To make a task appear unique, select a pattern to fill the task bar in the task
chart.
• Colors: To make a task appear unique, select the Choose link to set the color of the task
in the chart. In this dialog box, multiple color models are available to specify a color, as
indicated by the tab names. Select a color in one of the tabs and then select OK.
7. Enter values in the remaining tabs or select OK if done.
• Link hardness: To change the amount of flexibility in the time between the tasks, select
the default value in the Link hardness cell, and then select a value from the list. The
following values are available:
Link hardness Description
Strong There is no flexibility in the time between tasks. For
example, if the Type of link is Finish-Start and the Delay is 2
days, then the task being created must start exactly 2 days
after the added task finishes. Solid lines are used for Strong
links in the task chart.
Rubber There is flexibility in the time between tasks. For example, if
the Type of link is Finish-Start and the Delay is 2 days, then
the task being created can start 2 or more days after the
added task finishes. This also means that the added task can
finish 2 or more days before the start of the task being
created. Dashed lines are used for Rubber links in the task
chart.
Note: The default value for Link hardness is configured in GanttProject’s
settings, as described in To change Gantt chart settings.
12. (Optional) Add more linked tasks by repeating the previous three steps.
13. Enter values in the remaining tabs or select OK if done.
Custom Columns tab: Create custom task columns for task panel
20. To create custom columns that will be displayed in the task panel, go to the Custom Columns
tab.
21. Select Manage columns.
22. Select Add.
23. Enter the name of the column and then select the Enter key.
24. (Optional) Change the Column type and enter a Default value.
25. (Optional) Add more columns by repeating the previous three steps.
26. Select OK to complete the creation of the columns.
27. Select OK to complete the creation of the task.
a. Select Move task up as many times as needed until the summary task is right
above the task or tasks that are to be subtasks.
b. Select the task or tasks below the summary task that are to be subtasks. Use
Shift and click to select two or more consecutive rows.
c. In the upper left part of the task panel, select Indent .
To delete tasks
1. Go to the Gantt tab.
2. Select the task or tasks to delete. Use Shift and click to select two or more consecutive rows, or
use Shift, Ctrl, and click to select two or more non-consecutive rows.
3. Select Delete task or the Delete key.
To link tasks
1. Go to the Gantt tab.
2. Do one of the following, depending on whether you prefer to create the link by drawing it in the
task chart or selecting tasks in the task panel:
• Task chart: Click on a task and drag the link arrow to another task.
• Task panel:
a. Select two or more tasks that are currently not linked to each other. Use Shift
and click to select two or more consecutive rows, or use Shift, Ctrl, and click to
select two or more non-consecutive rows.
b. Select the link button at the top of the task panel.
To unlink tasks
1. Go to the Gantt tab.
2. Select two or more tasks that are currently linked to each other. Use Shift and click to select two
or more consecutive rows, or use Shift, Ctrl, and click to select two or more non-consecutive
rows.
3. Select the unlink button at the top of the task panel.
For example, Figure 3 below shows the original version of a schedule that was baselined. Figure 4 below
it shows the schedule later after some changes were made. In Figure 4, for tasks that have changed,
colored bars show them in their originally scheduled positions. Using default colors, green is used to
indicate tasks that will complete earlier than originally scheduled, and red is used to indicate tasks that
will complete later.
Common operations
You can perform common operations on tasks and resources, including searching, cutting, copying,
pasting, undoing, redoing, and printing.
To paste tasks
1. Select a row in the task panel to specify the row after which tasks will be pasted.
2. Select Paste , Ctrl+V, or Edit > Paste.
To paste resources
1. In the Resources Chart tab, select Paste , Ctrl+V, or Edit > Paste. Note that resources are
pasted at the bottom of the resource panel.
2. (Optional) To move a pasted resource up in the list of resources, select the resource and then
select Move resource up in the upper left part of the resource panel.
To undo an operation
• Select Undo , Ctrl+Z, or Edit > Undo.
To redo an operation
• Select Redo , Ctrl+Y, or Edit > Redo.
◦ At the top of the chart, select a value from the list, which is in bold and has a
default value of Today.
◦ Select Past or Future in the upper right of the chart.
File types that GanttProject supports include Microsoft Project and comma-separated values (CSV).
Note that many spreadsheet programs, such as Microsoft Excel, can open and save CSV files.
6. Select OK.
Also, you can import a calendar of holidays and nonwork days into a project. Calendar files must comply
with the iCalendar standard, and files of this type have a .ics suffix.
PERT charts
You can view a program evaluation and review technique (PERT) chart of the tasks in a project to see an
alternative visualization of them. Figure 5 below shows the first part of a PERT chart. In these charts,
tasks on the critical path are shown in yellow, and summary tasks, which contain subtasks, are shown
with a red border. This example was taken from the project in the file HouseBuildingSample.gan. This
file is in the folder named GanttProject-X.Y, which is named after a specific version of GanttProject and
is created when GanttProject is installed.
Troubleshooting
GanttProject provides two options that can help you resolve errors and recover from malfunctions. First,
you can view information about errors in the GanttProject log file. This information may help you
understand the cause of an error and how to resolve it. Alternatively, after a malfunction occurs, you
can retrieve an earlier version of a project file that GanttProject automatically saved. This earlier version
may not have been affected by the malfunction.
Index
B L
baselined schedule, 16 link hardness, 12
links
C add, 15
delete, 15
calendars type, 11
change, 7 log file, view, 25
import, 23
columns, change, 20
copy, 18
M
critical path, 16 Microsoft Project files
CSV files export, 23
change fields, 22 import, 23
export, 23
import, 23 P
custom columns, 20
cut, 18 paste
resources, 18
tasks, 18
E PERT charts, 24
error information, 25 print, 19
priority, tasks, 11
F projects, 7
add tasks and resources, 6
feedback, user guide, 4 change calendar, 7
files, recover, 25 change description, 7
FTP server, configure access, 21 change name, 7
change properties, 7
G create, 7
Gantt chart open, 8
change settings, 21 overview of creation, 6
change view, 19 reports, 22
Gantt screen, 5 save, 8
GanttProject
install, 4 R
license, 19 redo, 19
new features, 4 reports, 22
software libraries, 19 resource roles, 8
version, 19 add, 8
GanttProject files, import, 23 delete, 8
resources, 8
I add, 8
installation, 4 change columns, 20
T V
task chart version, GanttProject, 19
change settings, 21
change view, 19 W
task cost, 12
workspace settings, 19