taskjuggler 3.8.2 → 3.8.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG +5 -0
- data/data/tjp.vim +1 -1
- data/lib/taskjuggler/version.rb +1 -1
- data/man/tj3.1 +1 -1
- data/man/tj3client.1 +1 -1
- data/man/tj3d.1 +1 -1
- data/man/tj3man.1 +1 -1
- data/man/tj3ss_receiver.1 +1 -1
- data/man/tj3ss_sender.1 +2 -2
- data/man/tj3ts_receiver.1 +1 -1
- data/man/tj3ts_sender.1 +2 -2
- data/man/tj3ts_summary.1 +2 -2
- data/man/tj3webd.1 +86 -0
- data/taskjuggler.gemspec +2 -1
- metadata +23 -288
- data/manual/html/Day_To_Day_Juggling.html +0 -365
- data/manual/html/Getting_Started.html +0 -64
- data/manual/html/How_To_Contribute.html +0 -95
- data/manual/html/Installation.html +0 -205
- data/manual/html/Intro.html +0 -104
- data/manual/html/List_Attributes.html +0 -76
- data/manual/html/Reporting_Bugs.html +0 -49
- data/manual/html/Rich_Text_Attributes.html +0 -179
- data/manual/html/Software.html +0 -151
- data/manual/html/TaskJuggler_2x_Migration.html +0 -71
- data/manual/html/TaskJuggler_Internals.html +0 -63
- data/manual/html/The_TaskJuggler_Syntax.html +0 -92
- data/manual/html/Tutorial.html +0 -511
- data/manual/html/account.html +0 -163
- data/manual/html/account.task.html +0 -47
- data/manual/html/accountprefix.html +0 -69
- data/manual/html/accountreport.html +0 -488
- data/manual/html/accountroot.html +0 -144
- data/manual/html/active.html +0 -68
- data/manual/html/adopt.task.html +0 -74
- data/manual/html/aggregate.html +0 -147
- data/manual/html/alert.html +0 -69
- data/manual/html/alertlevels.html +0 -104
- data/manual/html/allocate.html +0 -98
- data/manual/html/alphabet.html +0 -40
- data/manual/html/alternative.html +0 -79
- data/manual/html/author.html +0 -71
- data/manual/html/auxdir.html +0 -69
- data/manual/html/auxdir.report.html +0 -71
- data/manual/html/balance.html +0 -148
- data/manual/html/booking.resource.html +0 -124
- data/manual/html/booking.task.html +0 -123
- data/manual/html/caption.html +0 -100
- data/manual/html/cellcolor.column.html +0 -108
- data/manual/html/celltext.column.html +0 -109
- data/manual/html/center.html +0 -93
- data/manual/html/charge.html +0 -92
- data/manual/html/chargeset.html +0 -76
- data/manual/html/columnid.html +0 -433
- data/manual/html/columns.html +0 -78
- data/manual/html/complete.html +0 -88
- data/manual/html/copyright.html +0 -99
- data/manual/html/credits.html +0 -123
- data/manual/html/css/tjmanual.css +0 -85
- data/manual/html/css/tjreport.css +0 -493
- data/manual/html/currency.html +0 -135
- data/manual/html/currencyformat.html +0 -101
- data/manual/html/dailymax.html +0 -146
- data/manual/html/dailymin.html +0 -134
- data/manual/html/dailyworkinghours.html +0 -92
- data/manual/html/date.extend.html +0 -79
- data/manual/html/date.html +0 -103
- data/manual/html/definitions.html +0 -96
- data/manual/html/depends.html +0 -113
- data/manual/html/details.html +0 -71
- data/manual/html/disabled.html +0 -93
- data/manual/html/duration.html +0 -135
- data/manual/html/efficiency.html +0 -95
- data/manual/html/effort.html +0 -136
- data/manual/html/effortdone.html +0 -105
- data/manual/html/effortleft.html +0 -105
- data/manual/html/email.html +0 -70
- data/manual/html/enabled.html +0 -77
- data/manual/html/end.column.html +0 -69
- data/manual/html/end.html +0 -89
- data/manual/html/end.limit.html +0 -71
- data/manual/html/end.report.html +0 -107
- data/manual/html/end.timesheet.html +0 -96
- data/manual/html/endcredit.html +0 -121
- data/manual/html/epilog.html +0 -76
- data/manual/html/export.html +0 -271
- data/manual/html/extend.html +0 -134
- data/manual/html/fail.html +0 -107
- data/manual/html/fdl.html +0 -430
- data/manual/html/flags.account.html +0 -69
- data/manual/html/flags.html +0 -68
- data/manual/html/flags.journalentry.html +0 -68
- data/manual/html/flags.report.html +0 -71
- data/manual/html/flags.resource.html +0 -71
- data/manual/html/flags.statussheet.html +0 -68
- data/manual/html/flags.task.html +0 -71
- data/manual/html/flags.timesheet.html +0 -68
- data/manual/html/fontcolor.column.html +0 -108
- data/manual/html/footer.html +0 -98
- data/manual/html/formats.export.html +0 -74
- data/manual/html/formats.html +0 -83
- data/manual/html/functions.html +0 -80
- data/manual/html/gapduration.html +0 -95
- data/manual/html/gaplength.html +0 -95
- data/manual/html/halign.center.html +0 -68
- data/manual/html/halign.column.html +0 -104
- data/manual/html/halign.left.html +0 -68
- data/manual/html/halign.right.html +0 -68
- data/manual/html/hasalert.html +0 -73
- data/manual/html/header.html +0 -98
- data/manual/html/headline.html +0 -71
- data/manual/html/height.html +0 -74
- data/manual/html/hideaccount.html +0 -111
- data/manual/html/hidejournalentry.html +0 -71
- data/manual/html/hidereport.html +0 -104
- data/manual/html/hideresource.html +0 -111
- data/manual/html/hidetask.html +0 -111
- data/manual/html/icalreport.html +0 -145
- data/manual/html/include.macro.html +0 -72
- data/manual/html/include.project.html +0 -72
- data/manual/html/include.properties.html +0 -78
- data/manual/html/index.html +0 -19
- data/manual/html/inherit.extend.html +0 -70
- data/manual/html/interval1.html +0 -101
- data/manual/html/interval2.html +0 -100
- data/manual/html/interval3.html +0 -101
- data/manual/html/interval4.html +0 -102
- data/manual/html/isactive.html +0 -69
- data/manual/html/ischildof.html +0 -69
- data/manual/html/isdependencyof.html +0 -77
- data/manual/html/isdutyof.html +0 -73
- data/manual/html/isfeatureof.html +0 -73
- data/manual/html/isleaf.html +0 -68
- data/manual/html/ismilestone.html +0 -69
- data/manual/html/isongoing.html +0 -69
- data/manual/html/isresource.html +0 -68
- data/manual/html/isresponsibilityof.html +0 -73
- data/manual/html/istask.html +0 -68
- data/manual/html/isvalid.html +0 -68
- data/manual/html/journalattributes.html +0 -115
- data/manual/html/journalentry.html +0 -85
- data/manual/html/journalmode.html +0 -95
- data/manual/html/leaveallowance.html +0 -141
- data/manual/html/leaves.html +0 -146
- data/manual/html/left.html +0 -92
- data/manual/html/length.html +0 -106
- data/manual/html/limits.allocate.html +0 -47
- data/manual/html/limits.html +0 -74
- data/manual/html/limits.resource.html +0 -82
- data/manual/html/limits.task.html +0 -115
- data/manual/html/listitem.column.html +0 -68
- data/manual/html/listtype.column.html +0 -81
- data/manual/html/loadunit.html +0 -103
- data/manual/html/logicalexpression.html +0 -86
- data/manual/html/logicalflagexpression.html +0 -84
- data/manual/html/macro.html +0 -105
- data/manual/html/managers.html +0 -112
- data/manual/html/mandatory.html +0 -68
- data/manual/html/markdate.html +0 -69
- data/manual/html/maxend.html +0 -71
- data/manual/html/maximum.html +0 -101
- data/manual/html/maxstart.html +0 -71
- data/manual/html/milestone.html +0 -73
- data/manual/html/minend.html +0 -71
- data/manual/html/minimum.html +0 -101
- data/manual/html/minstart.html +0 -71
- data/manual/html/monthlymax.html +0 -101
- data/manual/html/monthlymin.html +0 -101
- data/manual/html/navbar.html +0 -567
- data/manual/html/navigator.html +0 -103
- data/manual/html/newtask.html +0 -85
- data/manual/html/nikureport.html +0 -218
- data/manual/html/note.task.html +0 -70
- data/manual/html/novevents.html +0 -68
- data/manual/html/now.html +0 -69
- data/manual/html/number.extend.html +0 -79
- data/manual/html/numberformat.html +0 -87
- data/manual/html/onend.html +0 -70
- data/manual/html/onstart.html +0 -70
- data/manual/html/opennodes.html +0 -70
- data/manual/html/outputdir.html +0 -69
- data/manual/html/overtime.booking.html +0 -78
- data/manual/html/period.column.html +0 -69
- data/manual/html/period.limit.html +0 -71
- data/manual/html/period.report.html +0 -71
- data/manual/html/period.task.html +0 -71
- data/manual/html/persistent.html +0 -68
- data/manual/html/precedes.html +0 -89
- data/manual/html/priority.html +0 -116
- data/manual/html/priority.timesheet.html +0 -70
- data/manual/html/project.html +0 -90
- data/manual/html/projectid.html +0 -68
- data/manual/html/projectid.task.html +0 -70
- data/manual/html/projectids.html +0 -68
- data/manual/html/projection.html +0 -81
- data/manual/html/prolog.html +0 -76
- data/manual/html/properties.html +0 -262
- data/manual/html/purge.html +0 -74
- data/manual/html/rate.html +0 -68
- data/manual/html/rate.resource.html +0 -70
- data/manual/html/rawhtmlhead.html +0 -70
- data/manual/html/reference.extend.html +0 -79
- data/manual/html/remaining.html +0 -119
- data/manual/html/replace.html +0 -71
- data/manual/html/reportprefix.html +0 -69
- data/manual/html/resource.html +0 -208
- data/manual/html/resourceattributes.html +0 -85
- data/manual/html/resourceprefix.html +0 -69
- data/manual/html/resourcereport.html +0 -410
- data/manual/html/resourceroot.html +0 -94
- data/manual/html/resources.limit.html +0 -84
- data/manual/html/responsible.html +0 -72
- data/manual/html/richtext.extend.html +0 -80
- data/manual/html/right.html +0 -92
- data/manual/html/rollupaccount.html +0 -106
- data/manual/html/rollupresource.html +0 -129
- data/manual/html/rolluptask.html +0 -106
- data/manual/html/scale.column.html +0 -89
- data/manual/html/scenario.html +0 -107
- data/manual/html/scenario.ical.html +0 -69
- data/manual/html/scenarios.export.html +0 -68
- data/manual/html/scenarios.html +0 -71
- data/manual/html/scenariospecific.extend.html +0 -70
- data/manual/html/scheduled.html +0 -70
- data/manual/html/scheduling.html +0 -77
- data/manual/html/schedulingmode.html +0 -74
- data/manual/html/select.html +0 -88
- data/manual/html/selfcontained.html +0 -70
- data/manual/html/shift.allocate.html +0 -79
- data/manual/html/shift.html +0 -136
- data/manual/html/shift.resource.html +0 -82
- data/manual/html/shift.task.html +0 -82
- data/manual/html/shift.timesheet.html +0 -72
- data/manual/html/shifts.allocate.html +0 -73
- data/manual/html/shifts.resource.html +0 -75
- data/manual/html/shifts.task.html +0 -75
- data/manual/html/shorttimeformat.html +0 -69
- data/manual/html/sloppy.booking.html +0 -79
- data/manual/html/sloppy.projection.html +0 -74
- data/manual/html/sortaccounts.html +0 -75
- data/manual/html/sortjournalentries.html +0 -85
- data/manual/html/sortresources.html +0 -75
- data/manual/html/sorttasks.html +0 -75
- data/manual/html/start.column.html +0 -69
- data/manual/html/start.html +0 -80
- data/manual/html/start.limit.html +0 -71
- data/manual/html/start.report.html +0 -71
- data/manual/html/startcredit.html +0 -76
- data/manual/html/status.statussheet.html +0 -75
- data/manual/html/status.timesheet.html +0 -93
- data/manual/html/statussheet.html +0 -126
- data/manual/html/statussheetreport.html +0 -131
- data/manual/html/strict.projection.html +0 -74
- data/manual/html/summary.html +0 -71
- data/manual/html/supplement.html +0 -110
- data/manual/html/supplement.resource.html +0 -209
- data/manual/html/supplement.task.html +0 -325
- data/manual/html/tagfile.html +0 -79
- data/manual/html/task.html +0 -316
- data/manual/html/task.statussheet.html +0 -76
- data/manual/html/task.timesheet.html +0 -91
- data/manual/html/taskattributes.html +0 -117
- data/manual/html/taskprefix.html +0 -69
- data/manual/html/taskreport.html +0 -446
- data/manual/html/taskroot.export.html +0 -106
- data/manual/html/taskroot.html +0 -107
- data/manual/html/text.extend.html +0 -79
- data/manual/html/textreport.html +0 -429
- data/manual/html/timeformat.html +0 -162
- data/manual/html/timeformat1.html +0 -69
- data/manual/html/timeformat2.html +0 -69
- data/manual/html/timeoff.nikureport.html +0 -73
- data/manual/html/timesheet.html +0 -131
- data/manual/html/timesheetreport.html +0 -131
- data/manual/html/timezone.export.html +0 -68
- data/manual/html/timezone.html +0 -74
- data/manual/html/timezone.report.html +0 -70
- data/manual/html/timezone.shift.html +0 -72
- data/manual/html/timingresolution.html +0 -73
- data/manual/html/title.column.html +0 -69
- data/manual/html/title.html +0 -70
- data/manual/html/toc.html +0 -2521
- data/manual/html/tooltip.column.html +0 -109
- data/manual/html/tracereport.html +0 -426
- data/manual/html/trackingscenario.html +0 -82
- data/manual/html/treelevel.html +0 -68
- data/manual/html/vacation.html +0 -73
- data/manual/html/vacation.resource.html +0 -75
- data/manual/html/vacation.shift.html +0 -73
- data/manual/html/warn.html +0 -107
- data/manual/html/weeklymax.html +0 -101
- data/manual/html/weeklymin.html +0 -101
- data/manual/html/weekstartsmonday.html +0 -68
- data/manual/html/weekstartssunday.html +0 -68
- data/manual/html/width.column.html +0 -68
- data/manual/html/width.html +0 -74
- data/manual/html/work.html +0 -107
- data/manual/html/workinghours.project.html +0 -104
- data/manual/html/workinghours.resource.html +0 -81
- data/manual/html/workinghours.shift.html +0 -83
- data/manual/html/yearlyworkingdays.html +0 -72
data/manual/html/Tutorial.html
DELETED
|
@@ -1,511 +0,0 @@
|
|
|
1
|
-
<!DOCTYPE html>
|
|
2
|
-
<!-- This file has been generated by tj3man v3.8.1 -->
|
|
3
|
-
<html lang="en" xml:lang="en">
|
|
4
|
-
<head>
|
|
5
|
-
<title>Tutorial</title>
|
|
6
|
-
<meta content="text/html; charset=utf-8" http-equiv="Content-Type"/>
|
|
7
|
-
<meta content="IE=9" http-equiv="X-UA-Compatible"/>
|
|
8
|
-
</head>
|
|
9
|
-
<link href="css/tjmanual.css" rel="stylesheet" type="text/css"></link>
|
|
10
|
-
<body>
|
|
11
|
-
<div align="center">
|
|
12
|
-
<h3 align="center">The TaskJuggler User Manual</h3>
|
|
13
|
-
<em align="center">Project Management beyond Gantt Chart Drawing</em>
|
|
14
|
-
</div>
|
|
15
|
-
<br/>
|
|
16
|
-
<hr/>
|
|
17
|
-
<table style="width:90%; margin-left:5%; margin-right:5%"><tr>
|
|
18
|
-
<td style="text-align:left; width:35%;"><< <a href="Getting_Started.html">Getting_Started</a> <<</td>
|
|
19
|
-
<td style="text-align:center; width:30%;"><a href="toc.html">Table Of Contents</a></td>
|
|
20
|
-
<td style="text-align:right; width:35%;">>> <a href="The_TaskJuggler_Syntax.html">The_TaskJuggler_Syntax</a> >></td>
|
|
21
|
-
</tr></table>
|
|
22
|
-
<hr/>
|
|
23
|
-
<br/>
|
|
24
|
-
<div style="width:90%; margin-left:5%; margin-right:5%"><div class="manual">
|
|
25
|
-
<h1 class="manual" id="The_Tutorial_Your_first_Project">4 The Tutorial: Your first Project</h1>
|
|
26
|
-
<p class="manual">We have mentioned already that TaskJuggler uses plain text files that capture the known parts of the project. As you will see now, the syntax of these files is easy to understand and very intuitive. This chapter will walk you step by step through your first project. You create the project plan for a made-up accounting software project. This project demonstrates most of the commonly used features of TaskJuggler. It also includes some of the more advanced concepts that you may or may not need for your projects. Don't get scared by them. You can use them once you are more familiar with TaskJuggler and your projects grow larger. The complete tutorial example comes with your TaskJuggler software installation. You can use the following command to find the base directory of the example projects.</p>
|
|
27
|
-
<div class="manual" codesection="1"><pre class="manual" codesection="1"> ruby -e "puts Gem::Specification.find_by_name('taskjuggler').gem_dir"
|
|
28
|
-
</pre></div>
|
|
29
|
-
<p class="manual">The file for the tutorial project is called <code class="manual">examples/Tutorial/tutorial.tjp</code>. You can use any plain text editor to view and modify it.</p>
|
|
30
|
-
<h2 class="manual" id="Starting_the_project">4.1 Starting the project</h2>
|
|
31
|
-
<p class="manual">Every TaskJuggler project file must start with the <a href="project.html">project</a> property. It tells TaskJuggler the name of your project and a start and end date. The start and end dates don't need to be exact, but must fit all tasks of the project. It is the time interval the TaskJuggler scheduler will use to fit the tasks in. So, make it large enough for all your tasks to fit in. But don't make it too large, because this will result in longer scheduling times and higher memory consumption.</p>
|
|
32
|
-
<div class="codeframe"><pre class="code">project acso "Accounting Software" 2002-01-16 +4m {
|
|
33
|
-
}
|
|
34
|
-
</pre></div>
|
|
35
|
-
<p class="manual">All TaskJuggler properties have a unique ID, a name, and a set of optional attributes. The name must always be specified. The ID can be omitted if you never have to reference the property from another context. If you omit the ID, TaskJuggler will automatically generate a unique ID. The optional attributes are always enclosed in curly braces. If no optional attributes are specified, the braces can be omitted as well. In this example we will introduce a number of the attributes that may or may not matter for your specific projects. If you don't see an immediate need for a specific attribute, feel free to ignore it for now. You can always come back to them later. A full list of the supported project attributes can be found in the <i>attributes</i> section of the <a href="project.html">project</a> property documentation.</p>
|
|
36
|
-
<p class="manual">Attributes always start with a keyword that identifies them. The meaning and parameters of attributes depends on the property context that they are used in. A context is delimited by a set of curly braces that enclose optional attributes of a property. The area outside of any property is called the global scope. Usually, attributes have one or more arguments. These arguments can be dates, character strings, numbers or symbols. Strings must be enclosed in single or double quotes. The argument types and meaning is explained for each keyword in the syntax reference section of this manual.</p>
|
|
37
|
-
<p class="manual">TaskJuggler manages all events with an accuracy of up to 15 minutes. In many cases, you don't care about this level of accuracy. Nevertheless, it's good to have it when you need it. All dates can optionally be extended by a time. By default, TaskJuggler assumes that all times are UTC (world time) times. If you prefer a different time zone, you need to use the <a href="timezone.html">timezone</a> attribute.</p>
|
|
38
|
-
<div class="codeframe"><pre class="code"> timezone "Europe/Paris"
|
|
39
|
-
</pre></div>
|
|
40
|
-
<p class="manual">Be aware that the project start and end dates in the project header are specified before you specify the time zone. The project header dates are always assumed to be UTC unless you specify differently. See <a href="interval2.html">interval2</a> for details.</p>
|
|
41
|
-
<div class="manual" codesection="1"><pre class="manual" codesection="1">project acso "Accounting Software" 2002-01-16-0:00-+0100
|
|
42
|
-
</pre></div>
|
|
43
|
-
<p class="manual">The <a href="currency.html">currency</a> attribute specifies the unit of all currency values.</p>
|
|
44
|
-
<div class="codeframe"><pre class="code"> currency "USD"
|
|
45
|
-
</pre></div>
|
|
46
|
-
<p class="manual">Because each culture has its own way of specifying dates and numbers, the format for these is configurable. Use the <a href="timeformat.html">timeformat</a> attribute to specify the default format for dates. This format is used for reports, it does not affect the way you specify dates in the project files. Here you always need to use the <a href="date.html">TaskJuggler date
|
|
47
|
-
notation</a>.</p>
|
|
48
|
-
<div class="codeframe"><pre class="code"> timeformat "%Y-%m-%d"
|
|
49
|
-
numberformat "-" "" "," "." 1
|
|
50
|
-
currencyformat "(" ")" "," "." 0
|
|
51
|
-
</pre></div>
|
|
52
|
-
<p class="manual">We also can specify the way numbers or currency values are shown in the reports. Use the <a href="numberformat.html">numberformat</a> and <a href="currencyformat.html">currencyformat</a> attributes for this.</p>
|
|
53
|
-
<p class="manual">The attribute <a href="now.html">now</a> is used to set the current day for the scheduler to another value than to the moment your invoke TaskJuggler. If this attribute is not present, TaskJuggler will use the current moment of time to determine where you are with your tasks. To get a defined result for the reports in this example we've picked a specific date that fits our purpose here. In your projects, you would use <a href="now.html">now</a> to generate status reports for the date you specify.</p>
|
|
54
|
-
<div class="codeframe"><pre class="code"> now 2002-03-05-13:00
|
|
55
|
-
</pre></div>
|
|
56
|
-
<p class="manual">In this tutorial we would like to compare two scenarios of the project. The first scenario is the one that we have planned. The second scenario is how it really happened. The two scenarios have the same task structure, but the start and end dates and other attributes of the task that are scenario specific may vary. In this example we assume that the project got delayed and use a second scenario that we name "Delayed" to describe the actual project. The scenario property is used to specify the scenarios. The delayed scenario is nested into the plan scenario. This tells TaskJuggler to use all values from the plan scenario also for the second scenario unless the second scenario has it's own values. This is a very easy but also powerful way to analyze the impact of certain changes to the plan of record. We'll see further below, how to specify values for a scenario and how to compare the results.</p>
|
|
57
|
-
<div class="codeframe"><pre class="code"> scenario plan "Plan" {
|
|
58
|
-
scenario delayed "Delayed"
|
|
59
|
-
}
|
|
60
|
-
</pre></div>
|
|
61
|
-
<p class="manual">To summarize the above, let's look at the complete header again. Don't get scared by the wealth of attributes here. They are all optional and mostly used to illustrate the flexibility of TaskJuggler.</p>
|
|
62
|
-
<div class="codeframe"><pre class="code">project acso "Accounting Software" 2002-01-16 +4m {
|
|
63
|
-
# Set the default time zone for the project. If not specified, UTC
|
|
64
|
-
# is used.
|
|
65
|
-
timezone "Europe/Paris"
|
|
66
|
-
# Hide the clock time. Only show the date.
|
|
67
|
-
timeformat "%Y-%m-%d"
|
|
68
|
-
# Use US format for numbers
|
|
69
|
-
numberformat "-" "" "," "." 1
|
|
70
|
-
# Use US financial format for currency values. Don't show cents.
|
|
71
|
-
currencyformat "(" ")" "," "." 0
|
|
72
|
-
# Pick a day during the project that will be reported as 'today' in
|
|
73
|
-
# the project reports. If not specified, the current day will be
|
|
74
|
-
# used, but this will likely be outside of the project range, so it
|
|
75
|
-
# can't be seen in the reports.
|
|
76
|
-
now 2002-03-05-13:00
|
|
77
|
-
# The date that is used to show additional line on a Gannt chart
|
|
78
|
-
# and can be specified by the user.
|
|
79
|
-
markdate 2002-08-07-03:00
|
|
80
|
-
# The currency for all money values is the Euro.
|
|
81
|
-
currency "USD"
|
|
82
|
-
|
|
83
|
-
# We want to compare the baseline scenario to one with a slightly
|
|
84
|
-
# delayed start.
|
|
85
|
-
scenario plan "Plan" {
|
|
86
|
-
scenario delayed "Delayed"
|
|
87
|
-
}
|
|
88
|
-
extend resource {
|
|
89
|
-
text Phone "Phone"
|
|
90
|
-
}
|
|
91
|
-
}
|
|
92
|
-
</pre></div>
|
|
93
|
-
<h2 class="manual" id="Global_Attributes">4.2 Global Attributes</h2>
|
|
94
|
-
<p class="manual">For this tutorial, we also like to do a simple profit and loss analysis of the project. We will track labor cost versus customer payments. To calculate the labor costs we have to specify the default daily costs of an employee. This can be changed for certain employees later, but it illustrates an important concept of TaskJuggler – inheritance of attributes. In order to reduce the size of the TaskJuggler project file to a readable minimum, properties inherit many attributes from their enclosing scopes. We'll see further below, what this actually means. Right after the project property we are at top-level scope, so this is the default for all following properties.</p>
|
|
95
|
-
<div class="codeframe"><pre class="code">rate 390.0
|
|
96
|
-
</pre></div>
|
|
97
|
-
<p class="manual">The <a href="rate.html">rate</a> attribute can be used to specify the daily costs of resources. All subsequently declared resources will get this rate. But it can certainly be changed to a different rate at group or individual resource level.</p>
|
|
98
|
-
<p class="manual">You may also want to tell TaskJuggler about holidays that affect all resources. Global holidays are time periods where TaskJuggler does not do any resource assignments to tasks.</p>
|
|
99
|
-
<div class="codeframe"><pre class="code">leaves holiday "Good Friday" 2002-03-29
|
|
100
|
-
</pre></div>
|
|
101
|
-
<p class="manual">Use the <a href="leaves.html">leaves</a> attribute to define a global holiday. Global holidays may have a name and must have a date or date range. Other leaves for individual resources or groups of resources can be defined similarly.</p>
|
|
102
|
-
<h2 class="manual" id="Macros">4.3 Macros</h2>
|
|
103
|
-
<p class="manual">Macros are another TaskJuggler feature to save you typing work and to keep project files small and maintainable. Macros are text patterns that can be defined once and inserted multiple times in the project file. A <a href="macro.html">macro</a> always has a name and the text pattern is enclosed by square brackets.</p>
|
|
104
|
-
<div class="codeframe"><pre class="code">macro allocate_developers [
|
|
105
|
-
allocate dev1
|
|
106
|
-
allocate dev2
|
|
107
|
-
allocate dev3
|
|
108
|
-
]
|
|
109
|
-
</pre></div>
|
|
110
|
-
<p class="manual">To use the macro you simply have to write <code class="manual">${allocate_developers}</code> and TaskJuggler will replace the term <code class="manual">${allocate_developers}</code> with the pattern. We will use this macro further below in the example and then explain the meaning of the pattern.</p>
|
|
111
|
-
<h2 class="manual" id="Declaring_Flags">4.4 Declaring Flags</h2>
|
|
112
|
-
<p class="manual">A TaskJuggler feature that you will probably make heavy use of is flags. Once declared you can attach them to any property. When you generate reports of the TaskJuggler results, you can use the flags to filter out unwanted properties and limit the report to exactly those details that you want to have included.</p>
|
|
113
|
-
<div class="codeframe"><pre class="code">flags team
|
|
114
|
-
</pre></div>
|
|
115
|
-
<p class="manual">This is a <a href="flags.html">flags</a> declaration. All flags need to be declared before they can be used to avoid hard to find errors due to misspelled flag names. The flags should be declared before any property at global scope. We will see further down, how we can make use of these flags.</p>
|
|
116
|
-
<h2 class="manual" id="Declaring_Accounts">4.5 Declaring Accounts</h2>
|
|
117
|
-
<p class="manual">The use of our resources will generate costs. For a profit and loss analysis, we need to balance the cost against the customer payments. In order not to get lost with all the various amounts, we declare 3 <a href="account.html">accounts</a> to credit the amounts to. We create one account for the development costs, one for the documentation costs, and one for the customer payments. Actually, there is a fourth account consisting of two accounts nested into it.</p>
|
|
118
|
-
<div class="codeframe"><pre class="code">account cost "Project Cost" {
|
|
119
|
-
account dev "Development"
|
|
120
|
-
account doc "Documentation"
|
|
121
|
-
}
|
|
122
|
-
account rev "Payments"
|
|
123
|
-
</pre></div>
|
|
124
|
-
<p class="manual">The account needs an ID and a name. IDs may only consist of the characters a to z, A to Z and the underscore. All but the first character may also be digits 0 to 9. The ID is necessary so that we can reference the property again later without having to write the potentially much longer name. The name may contain space characters and therefore has to be enclosed with single or double quotes.</p>
|
|
125
|
-
<p class="manual">Accounts can be grouped by nesting them. You can use this feature to create sets of accounts. Such sets can then be balanced against each other to create a profit and loss analysis. When you have specified accounts in your project, you must at least define one default <a href="balance.html">balance</a>.</p>
|
|
126
|
-
<div class="codeframe"><pre class="code">balance cost rev
|
|
127
|
-
</pre></div>
|
|
128
|
-
<h2 class="manual" id="Declaring_Resources">4.6 Declaring Resources</h2>
|
|
129
|
-
<p class="manual">While the above introduced account property is only needed if you want to do a P&L analysis, resources are usually found in almost any project.</p>
|
|
130
|
-
<div class="codeframe"><pre class="code">resource boss "Paul Henry Bullock" {
|
|
131
|
-
email "phb@crappysoftware.com"
|
|
132
|
-
Phone "x100"
|
|
133
|
-
rate 480
|
|
134
|
-
}
|
|
135
|
-
resource dev "Developers" {
|
|
136
|
-
managers boss
|
|
137
|
-
resource dev1 "Paul Smith" {
|
|
138
|
-
email "paul@crappysoftware.com"
|
|
139
|
-
Phone "x362"
|
|
140
|
-
rate 350.0
|
|
141
|
-
}
|
|
142
|
-
resource dev2 "Sébastien Bono" {
|
|
143
|
-
email "SBono@crappysoftware.com"
|
|
144
|
-
Phone "x234"
|
|
145
|
-
}
|
|
146
|
-
resource dev3 "Klaus Müller" {
|
|
147
|
-
email "Klaus.Mueller@crappysoftware.com"
|
|
148
|
-
Phone "x490"
|
|
149
|
-
leaves annual 2002-02-01 - 2002-02-05
|
|
150
|
-
}
|
|
151
|
-
flags team
|
|
152
|
-
}
|
|
153
|
-
resource misc "The Others" {
|
|
154
|
-
managers boss
|
|
155
|
-
resource test "Peter Murphy" {
|
|
156
|
-
email "murphy@crappysoftware.com"
|
|
157
|
-
Phone "x666"
|
|
158
|
-
limits { dailymax 6.4h }
|
|
159
|
-
rate 310.0
|
|
160
|
-
}
|
|
161
|
-
resource doc "Dim Sung" {
|
|
162
|
-
email "sung@crappysoftware.com"
|
|
163
|
-
Phone "x482"
|
|
164
|
-
rate 300.0
|
|
165
|
-
leaves annual 2002-03-11 - 2002-03-16
|
|
166
|
-
}
|
|
167
|
-
|
|
168
|
-
flags team
|
|
169
|
-
}
|
|
170
|
-
</pre></div>
|
|
171
|
-
<p class="manual">This snippet of the example shows the use of the <a href="resource.html">
|
|
172
|
-
resource property</a>. Just like accounts, resources should have an ID and must have a name. Resource IDs, like account IDs must also be unique within their property class. As you can see, resource properties can be nested: <code class="manual">dev</code> is a group or container resource, a team that consists of three other resources.</p>
|
|
173
|
-
<p class="manual">
|
|
174
|
-
<code class="manual">dev1</code>, alias Paul Smith, costs more than the normal employee. So the declaration of <code class="manual">dev1</code> overwrites the inherited default rate with a higher value.</p>
|
|
175
|
-
<p class="manual">The default value has been inherited from the enclosing scope, resource <code class="manual">dev</code>, which in turn has inherited it from the global scope. The declaration of the resource Klaus Müller uses another optional attribute. Attributes are only inherited from the parent property if the attribute was declared in the parent property before the child property declaration was started.</p>
|
|
176
|
-
<p class="manual">The syntax reference lists for each property whether an attribute is inherited from the parent or the attribute in the global scope.</p>
|
|
177
|
-
<p class="manual">With <a href="leaves.html">leaves</a> you can specify certain time intervals where the resource is not available. Leaves are list attributes. They accumulate the declarations. If you want to get rid of inherited or previously assigned values, you can use the <a href="purge.html">purge</a> attribute to clear the list.</p>
|
|
178
|
-
<p class="manual">
|
|
179
|
-
<code class="manual">leaves</code> requires a time interval. It is important to understand how TaskJuggler handles time intervals. Internally, TaskJuggler uses the number of seconds after January 1st, 1970 to store any date. So all dates are actually stored with an accuracy of 1 second in UTC time. <code class="manual">2002-02-01</code> specifies midnight February 1st, 2002. Following the TaskJuggler concept of requiring as little information as necessary and extending the rest with sensible defaults, TaskJuggler adds the time 0:00:00 if nothing else has been specified. So the vacation ends on midnight February 5th, 2002. Well, almost. Every time you specify a time interval, the end date is not included in the interval. So Klaus Müller's vacation ends exactly at 0:00:00 on February 5th, 2002. February 5 is not part of the leave!</p>
|
|
180
|
-
<p class="manual">Peter Murphy only works 6.4 hours a day. So we use the <a href="limits.resource.html">limits</a> attribute to limit his daily working hours. We could also define exact working hours using the <a href="shift.html">shift
|
|
181
|
-
property</a>, but we ignore this for now.</p>
|
|
182
|
-
<p class="manual">Note that we have attached the flag <code class="manual">team</code> after the declaration of the sub-resources to the team resources. This way, these flags don't get passed down to the sub-resources. If we would have declared the flags before the sub-resources, then they would have the flags attached as well.</p>
|
|
183
|
-
<h2 class="manual" id="Specifying_the_Tasks">4.7 Specifying the Tasks</h2>
|
|
184
|
-
<p class="manual">Let's focus on the real work now. The project should solve a problem: the creation of an accounting software. Because the job is quite complicated, we break it down into several subtasks. We need to do a specification, develop the software, test the software, and write a manual. Using the <a href="task.html">task property</a>, this would look as follows:</p>
|
|
185
|
-
<div class="codeframe"><pre class="code">task AcSo "Accounting Software" {
|
|
186
|
-
task spec "Specification" {
|
|
187
|
-
}
|
|
188
|
-
task software "Software Development" {
|
|
189
|
-
}
|
|
190
|
-
task test "Software testing" {
|
|
191
|
-
}
|
|
192
|
-
task manual "Manual" {
|
|
193
|
-
journalentry 2002-02-28 "User manual completed" {
|
|
194
|
-
author boss
|
|
195
|
-
summary "The doc writers did a really great job to finish on time."
|
|
196
|
-
}
|
|
197
|
-
}
|
|
198
|
-
task deliveries "Milestones" {
|
|
199
|
-
}
|
|
200
|
-
}
|
|
201
|
-
</pre></div>
|
|
202
|
-
<p class="manual">Similar to resources, tasks are declared by using the task keyword followed by an ID and a name string. All TaskJuggler properties have their own namespaces. This means, that it is quite OK to have a resource and a task with the same ID. Tasks may have optional attributes which can be tasks again, so tasks can be nested. In contrast to all other TaskJuggler properties, task IDs inherit the ID of the enclosing task as a prefix to the ID. The full ID of the spec task is AcSo.spec. You need to use this absolute ID when you want to reference the task later on. This hierarchical name space for tasks was chosen to support large projects where multiple project managers may use the same ID in different sub tasks.</p>
|
|
203
|
-
<p class="manual">To track important milestones of the project, we also added a task called Milestones. This task, like most of the other tasks will get some subtasks later on.</p>
|
|
204
|
-
<p class="manual">We consider the specification task simple enough, so we don't have to break it into further subtasks. So let's add some more details to it.</p>
|
|
205
|
-
<div class="codeframe"><pre class="code"> task spec "Specification" {
|
|
206
|
-
effort 20d
|
|
207
|
-
${allocate_developers}
|
|
208
|
-
depends !deliveries.start
|
|
209
|
-
}
|
|
210
|
-
</pre></div>
|
|
211
|
-
<p class="manual">The <a href="effort.html">effort</a> to complete the task is specified with 20 man-days. Alternatively we could have used the <a href="length.html">length</a> attribute or the <a href="duration.html">duration</a> attribute. <code class="manual">length</code> specifies the duration of the task in working days while <code class="manual">duration</code> specifies the duration in calendar days. Contrary to <code class="manual">effort</code>, these two don't have to have a specification of the involved resources. Since <code class="manual">effort</code> specifies the duration in man-days, we need to say who should be allocated to the task. The task won't finish before the resources could be allocated long enough to reach the specified effort. Tasks with <code class="manual">length</code> or <code class="manual">duration</code> criteria and allocated resources will last exactly as long as requested. Resources will be allocated only if available. It's possible that such a task ends up with no allocations at all if the resources are always assigned to other tasks for that period. Each task can only have one of the three duration criteria. Container tasks may never have a duration specification. They are automatically adjusted to fit all sub tasks.</p>
|
|
212
|
-
<p class="manual">Here we use the allocate_developers macro mentioned above. The expression <code class="manual">${allocate_developers}</code> is simply expanded to</p>
|
|
213
|
-
<div class="codeframe"><pre class="code"> allocate dev1
|
|
214
|
-
allocate dev2
|
|
215
|
-
allocate dev3
|
|
216
|
-
</pre></div>
|
|
217
|
-
<p class="manual">If you need to <a href="allocate.html">allocate</a> the same bunch of people to several tasks, the macro saves you some typing. You could have written the allocate attributes directly instead of using the macro. Since the allocation of multiple resources to a task is a good place for macro usage, we found it a good idea to use it in this example as well.</p>
|
|
218
|
-
<p class="manual">For TaskJuggler to schedule a task, it needs to know either the start and end criteria of a task, or one of them and a duration specification. The start and end criteria can either be fixed dates or relative dates. Relative dates are specifications of the type <i>task B starts after task A has finished</i>. Or in other words, task B depends on task A. In this example the spec task depends on a subtask of the deliveries task. We have not specified it yet, but it has the local ID <code class="manual">start</code>.</p>
|
|
219
|
-
<p class="manual">To specify the dependency between the two tasks, we use the <a href="depends.html">depends</a> attribute. This attribute must be followed by one or more task IDs. If more than one ID is specified, each ID has to be separated with a comma from the previous one. Task IDs can be either absolute IDs or relative IDs. An absolute ID of a task is the ID of this task prepended by the IDs of all enclosing tasks. The task IDs are separated by a dot from each other. The absolute ID of the specification task would be <code class="manual">AcSo.spec</code>.</p>
|
|
220
|
-
<p class="manual">Relative IDs always start with one or more exclamation marks. Each exclamation mark moves the scope to the next enclosing task. So <code class="manual">!deliveries.start</code> is expanded to <code class="manual">AcSo.deliveries.start</code> since <code class="manual">AcSo</code> is the enclosing task of <code class="manual">deliveries</code>. Relative task IDs are a little bit confusing at first, but have a real advantage over absolute IDs. Sooner or later you want to move tasks around in your project and then it's a lot less likely that you have to fix dependency specifications of relative IDs.</p>
|
|
221
|
-
<p class="manual">The software development task is still too complex to specify it directly. So we split it further into subtasks.</p>
|
|
222
|
-
<div class="codeframe"><pre class="code"> task software "Software Development" {
|
|
223
|
-
priority 1000
|
|
224
|
-
task database "Database coupling" {
|
|
225
|
-
journalentry 2002-02-03 "Problems with the SQL Libary" {
|
|
226
|
-
author dev1
|
|
227
|
-
alert yellow
|
|
228
|
-
summary -8<-
|
|
229
|
-
We ran into some compatibility problems with the SQL
|
|
230
|
-
Library.
|
|
231
|
-
->8-
|
|
232
|
-
details -8<-
|
|
233
|
-
We have already contacted the vendor and are now waiting for
|
|
234
|
-
their advise.
|
|
235
|
-
->8-
|
|
236
|
-
}
|
|
237
|
-
}
|
|
238
|
-
task gui "Graphical User Interface" {
|
|
239
|
-
}
|
|
240
|
-
task backend "Back-End Functions" {
|
|
241
|
-
}
|
|
242
|
-
}
|
|
243
|
-
</pre></div>
|
|
244
|
-
<p class="manual">We use the <a href="priority.html">priority</a> attribute to mark the importance of the tasks. 500 is the default priority of top-level tasks. Setting the priority to 1000 marks the task as most important task, since the possible range is 1 (not important at all) to 1000 (ultimately important). <code class="manual">priority</code> is an attribute that is passed down to subtasks if specified before the subtasks' declaration. So all subtasks of software have a priority of 1000 as well, unless they have their own priority definition.</p>
|
|
245
|
-
<div class="codeframe"><pre class="code"> task database "Database coupling" {
|
|
246
|
-
effort 20d
|
|
247
|
-
allocate dev1, dev2
|
|
248
|
-
journalentry 2002-02-03 "Problems with the SQL Libary" {
|
|
249
|
-
author dev1
|
|
250
|
-
alert yellow
|
|
251
|
-
summary -8<-
|
|
252
|
-
We ran into some compatibility problems with the SQL
|
|
253
|
-
Library.
|
|
254
|
-
->8-
|
|
255
|
-
details -8<-
|
|
256
|
-
We have already contacted the vendor and are now waiting for
|
|
257
|
-
their advise.
|
|
258
|
-
->8-
|
|
259
|
-
}
|
|
260
|
-
}
|
|
261
|
-
</pre></div>
|
|
262
|
-
<p class="manual">The work on the database coupling should not start before the specification has been finished. So we again use the <a href="depends.html">depends</a> attribute to let TaskJuggler know about this. This time we use two exclamation marks for the relative ID. The first one puts us in the scope of the enclosing software task. The second one is to get into the AcSo scope that contains the spec tasks. For a change, we <a href="allocate.html">allocate</a> resources directly without using a macro.</p>
|
|
263
|
-
<div class="codeframe"><pre class="code"> task gui "Graphical User Interface" {
|
|
264
|
-
effort 35d
|
|
265
|
-
delayed:effort 40d
|
|
266
|
-
depends !database, !backend
|
|
267
|
-
allocate dev2, dev3
|
|
268
|
-
# Resource dev2 should only work 6 hours per day on this task.
|
|
269
|
-
limits {
|
|
270
|
-
dailymax 6h {
|
|
271
|
-
resources dev2
|
|
272
|
-
}
|
|
273
|
-
}
|
|
274
|
-
}
|
|
275
|
-
</pre></div>
|
|
276
|
-
<p class="manual">One more interesting thing to note is the fact that we like the resource <code class="manual">dev2</code> only to work 6 hours each day on this task, so we use the optional attribute <a href="limits.resource.html">limits.resource</a> to specify this.</p>
|
|
277
|
-
<p class="manual">TaskJuggler can schedule your project for two different <a href="scenario.html">
|
|
278
|
-
scenarios</a>. We have called the first scenario <code class="manual">plan</code> scenario and the second <code class="manual">delayed</code> scenario. Many of the reports allow you to put the values of both scenarios side by side to each other, so you can compare the scenarios. All scenario-specific values that are not explicitly stated for the <code class="manual">delayed</code> scenario are taken from the <code class="manual">plan</code> scenario. So the user only has to specify the values that differ in the delayed scenario. The two scenarios must have the same task structure and the same dependencies. But the start and end dates of tasks as well as the duration may vary. In the example we have planned the work on the graphical user interface to be 35 man-days. It turned out that we actually needed 40 man-days. By prefixing the <a href="effort.html">effort</a> attribute with <code class="manual">delayed:</code>, the effort value for the <code class="manual">delayed</code> scenario can be specified.</p>
|
|
279
|
-
<div class="codeframe"><pre class="code"> task backend "Back-End Functions" {
|
|
280
|
-
effort 30d
|
|
281
|
-
complete 95
|
|
282
|
-
depends !database
|
|
283
|
-
allocate dev1, dev2
|
|
284
|
-
}
|
|
285
|
-
</pre></div>
|
|
286
|
-
<p class="manual">By default, TaskJuggler assumes that all tasks are on schedule. Sometimes you want to generate reports that show how much of a task actually has been completed. TaskJuggler uses the current date for this, unless you have specified another date using the now attribute. If a task is ahead of schedule or late, this can be specified using the <a href="complete.html">complete</a> attribute. This specifies how many percent of the task have been completed up to the current date. In our case the back-end implementation is slightly ahead of schedule as we will see from the report.</p>
|
|
287
|
-
<div class="codeframe"><pre class="code"> task test "Software testing" {
|
|
288
|
-
|
|
289
|
-
task alpha "Alpha Test" {
|
|
290
|
-
effort 1w
|
|
291
|
-
depends !!software
|
|
292
|
-
allocate test, dev2
|
|
293
|
-
note "Hopefully most bugs will be found and fixed here."
|
|
294
|
-
journalentry 2002-03-01 "Contract with Peter not yet signed" {
|
|
295
|
-
author boss
|
|
296
|
-
alert red
|
|
297
|
-
summary -8<-
|
|
298
|
-
The paperwork is stuck with HR and I can't hunt it down.
|
|
299
|
-
->8-
|
|
300
|
-
details -8<-
|
|
301
|
-
If we don't get the contract closed within the next week,
|
|
302
|
-
the start of the testing is at risk.
|
|
303
|
-
->8-
|
|
304
|
-
}
|
|
305
|
-
}
|
|
306
|
-
|
|
307
|
-
task beta "Beta Test" {
|
|
308
|
-
effort 4w
|
|
309
|
-
depends !alpha
|
|
310
|
-
allocate test, dev1
|
|
311
|
-
}
|
|
312
|
-
}
|
|
313
|
-
</pre></div>
|
|
314
|
-
<p class="manual">The software testing task has been split up into an alpha and a beta test task. The interesting thing here is, that efforts can not only be specified as man-days, but also man-weeks, man-hours, etc. By default, TaskJuggler assumes a man-day is 8 hours, man-week is 40 man-hours or 5 man-days. The conversion factor can be changed using the <a href="dailyworkinghours.html">dailyworkinghours</a> attribute.</p>
|
|
315
|
-
<p class="manual">Let's go back to the outermost task again. At the beginning of the example we stated that we want to credit all development work to one account with ID dev and all documentation work to the account doc. To achieve this, we use the attribute <a href="chargeset.html">chargeset</a> to credit all tasks to the <code class="manual">dev</code> account.</p>
|
|
316
|
-
<p class="manual">For the duration of the <code class="manual">AcSo</code> task we also have running costs for the lease on the building and the equipment. To compensate this, we charge a daily rate of USD 170 per day using the <a href="charge.html">charge</a> attribute.</p>
|
|
317
|
-
<div class="codeframe"><pre class="code">task AcSo "Accounting Software" {
|
|
318
|
-
chargeset dev
|
|
319
|
-
charge 170 perday
|
|
320
|
-
task spec "Specification" {
|
|
321
|
-
</pre></div>
|
|
322
|
-
<p class="manual">Since we specify the attribute for the top-level task before we declare any subtasks, this attribute will be inherited by all subtasks and their subtasks and so on. The only exception is the writing of the manual. We need to change the chargeset for this task again, as it is also a subtask of AcSo and we want to use a different account for it.</p>
|
|
323
|
-
<div class="codeframe"><pre class="code"> task manual "Manual" {
|
|
324
|
-
effort 10w
|
|
325
|
-
depends !deliveries.start
|
|
326
|
-
allocate doc, dev3
|
|
327
|
-
purge chargeset
|
|
328
|
-
chargeset doc
|
|
329
|
-
journalentry 2002-02-28 "User manual completed" {
|
|
330
|
-
author boss
|
|
331
|
-
summary "The doc writers did a really great job to finish on time."
|
|
332
|
-
}
|
|
333
|
-
}
|
|
334
|
-
</pre></div>
|
|
335
|
-
<h2 class="manual" id="Specifying_Milestones">4.8 Specifying Milestones</h2>
|
|
336
|
-
<p class="manual">All tasks that have been discussed so far, had a certain duration. We did not always specify the duration explicitly, but we expect them to last for a certain period of time. Sometimes you just want to capture a certain moment in your project plan. These moments are usually called milestones, since they have some level of importance for the progress of the project.</p>
|
|
337
|
-
<p class="manual">TaskJuggler has support for milestones as well. Milestones are leaf tasks that don't have a duration specification.</p>
|
|
338
|
-
<div class="codeframe"><pre class="code"> task deliveries "Milestones" {
|
|
339
|
-
purge chargeset
|
|
340
|
-
chargeset rev
|
|
341
|
-
|
|
342
|
-
task start "Project start" {
|
|
343
|
-
start ${projectstart}
|
|
344
|
-
delayed:start 2002-01-20
|
|
345
|
-
charge 21000.0 onstart
|
|
346
|
-
}
|
|
347
|
-
|
|
348
|
-
task prev "Technology Preview" {
|
|
349
|
-
depends !!software.backend
|
|
350
|
-
charge 31000.0 onstart
|
|
351
|
-
note "All '''major''' features should be usable."
|
|
352
|
-
}
|
|
353
|
-
|
|
354
|
-
task beta "Beta version" {
|
|
355
|
-
depends !!test.alpha
|
|
356
|
-
charge 13000.0 onstart
|
|
357
|
-
note "Fully functional, may contain bugs."
|
|
358
|
-
}
|
|
359
|
-
|
|
360
|
-
task done "Ship Product to Customer" {
|
|
361
|
-
# maxend 2002-04-17
|
|
362
|
-
depends !!test.beta, !!manual
|
|
363
|
-
charge 33000.0 onstart
|
|
364
|
-
note "All priority 1 and 2 bugs must be fixed."
|
|
365
|
-
}
|
|
366
|
-
}
|
|
367
|
-
}
|
|
368
|
-
</pre></div>
|
|
369
|
-
<p class="manual">We have put all important milestones of the project as subtasks of the deliveries task. This way they show up nicely grouped in the reports. All milestones either have a dependency or a fixed start date. For the first milestone we have used the attribute <a href="start.html">start</a> to set a fixed start date. All other tasks have direct or indirect dependencies on this task. Moving back the start date will slip the whole project. This has actually happened, so we use the <code class="manual">delayed:</code> prefix again to specify the start date for the delayed scenario.</p>
|
|
370
|
-
<p class="manual">Every milestone is linked to a customer payment. By using the <a href="charge.html">charge</a> attribute we can credit the specified amount to the account associated with this task. Since we have assigned the <code class="manual">rev</code> account to the enclosing task, all milestones will use this account as well. This time, we use the keyword <code class="manual">onstart</code> to indicate that this is not a continuous charge but a one-time charge that is credited at the begin of the task.</p>
|
|
371
|
-
<p class="manual">Did you notice the line in the task done that starts with a hash? This line is commented out. If TaskJuggler finds a hash, it ignores the rest of the line. This way you can include comments in your project. The <a href="maxend.html">maxend</a> attribute specifies that the task should end no later than the specified date. This information is not used for scheduling, but only for checking the schedule afterwards. Since the task will end later than the specified date, commenting out the line would trigger a warning.</p>
|
|
372
|
-
<p class="manual">Now the project has been completely specified. Stopping here would result in a valid TaskJuggler file that could be processed and scheduled. But no reports would be generated to visualize the results.</p>
|
|
373
|
-
<h2 class="manual" id="Visualizing_the_Project">4.9 Visualizing the Project</h2>
|
|
374
|
-
<p class="manual">To see and share the project data, reports can be generated. You can generate any number of reports and you can select from a variety of report types and output formats. To have a report generated after the project scheduling has been completed, you need include a report definition into the project description. Report definitions are properties that are very similar to the task and resource properties that you are already familiar with. Just like these, report definitions can be nested to take advantage of the attribute inheritance mechanism. Every report definition starts with the type of the report. Each type of report has a particular focus. A <a href="taskreport.html">taskreport</a> lists the project data in the form of a task list. A <a href="resourcereport.html">resourcereport</a> does the same in form of a resource list. For a more generic report, you can use the <a href="textreport.html">textreport</a>.</p>
|
|
375
|
-
<p class="manual">A <code class="manual">textreport</code> does not directly present the data in form of a task or resource list. It just consists of text building blocks that are described by <a href="Rich_Text_Attributes.html">Rich Text</a>. There can be a building block at the top and bottom, as well as three columns in the center. The column are called <code class="manual">left</code>, <code class="manual">center</code> and <code class="manual">right</code>.</p>
|
|
376
|
-
<p class="manual">For our first report, we'll just use the center column for now. Like every property, you need to specify a name. This name will be the base name of the generated report file. Depending on the output format, the proper suffix is appended. For this report, we only chose to generate a web page in HTML format. There is no default format defined for reports. If the <a href="formats.html">formats</a> attribute is not specified, no output file will be generated for the report specification.</p>
|
|
377
|
-
<p class="manual">This may seem odd at first glance since TaskJuggler syntax always tries to use the most compact and readable syntax for the common case. As you will see in a minute, reports may be composed of several report specifications. One report specification can include the output of another report specification as well. In this case, the included report does not need to generate it's own file. The output will be included within the output of another report specification. In case of such composed reports, the output format specification of the top-level format will be used for all included reports as well.</p>
|
|
378
|
-
<div class="codeframe"><pre class="code">textreport frame "" {
|
|
379
|
-
textreport index "Overview" {
|
|
380
|
-
formats html
|
|
381
|
-
center '<[report id="overview"]>'
|
|
382
|
-
}
|
|
383
|
-
}
|
|
384
|
-
</pre></div>
|
|
385
|
-
<p class="manual">For the main report, we choose the file name <code class="manual">Overview</code> and the format <code class="manual">html</code>. So, the generated file will be called <code class="manual">Overview.html</code>.</p>
|
|
386
|
-
<p class="manual">As we've mentioned before, the sections of a <code class="manual">textreport</code> are defined in Rich Text format. Here we use a so called block generator to include the HTML output of another report definition. The <code class="manual">report</code> block generator allows us to compose reports by combining their output into a single report. You must provide the <code class="manual">id</code> parameter to specify which report definition you would like to use. In this case, it is a report definition with the ID <code class="manual">overview</code>. Note that generator parameters need to be enclosed in single or double quotes. We are essentially marking a string within a string. This can only work out, if we don't use the same parameter for both. Let's define this report first.</p>
|
|
387
|
-
<div class="codeframe"><pre class="code">taskreport overview "" {
|
|
388
|
-
columns bsi { title 'WBS' },
|
|
389
|
-
name, start, end, effort, cost,
|
|
390
|
-
revenue, chart { ${TaskTip} }
|
|
391
|
-
}
|
|
392
|
-
</pre></div>
|
|
393
|
-
<p class="manual">Instead of another <a href="textreport.html">textreport</a> definition we are now using a <a href="taskreport.html">taskreport</a>. A task report contains a list of tasks in a table structure. By default, it contains all tasks of the project. As we will see later on, we can use filter expressions to limit the content to a well defined subset of tasks. The table contains a line for each task and comes by default with a few columns like the name of the task, and the start and end dates. For this project overview report, we like to have also the effort for each task, the duration, the effort, the cost and revenue numbers included. To top it off, we also include a column with a Gantt chart.</p>
|
|
394
|
-
<p class="manual">By including the cost and revenue column, we are able to do a simple profit and loss analysis on the project. This P&L is computed from the accounts that we have provided above. For this to work, we need to tell TaskJuggler which accounts are cost accounts and which are revenue accounts. We have already conveniently grouped the accounts and the <a href="balance.html">balance</a> attribute specifies which accounts are used for the P&L in this report.</p>
|
|
395
|
-
<div class="codeframe"><pre class="code"> balance cost rev
|
|
396
|
-
</pre></div>
|
|
397
|
-
<p class="manual">The columns of the report can be customized. You can overwrite the default title or the cell content. See <a href="columns.html">columns</a> for a full list of available attributes. For the chart column, we'd like to have a tool tip that displays additional details when the mouse pointer is placed over a task bar. Since we use this tool tip in several reports, we have defined the <code class="manual">TaskTip</code> macro for it.</p>
|
|
398
|
-
<div class="codeframe"><pre class="code">macro TaskTip [
|
|
399
|
-
tooltip istask() -8<-
|
|
400
|
-
'''Start: ''' <-query attribute='start'->
|
|
401
|
-
'''End: ''' <-query attribute='end'->
|
|
402
|
-
----
|
|
403
|
-
'''Resources:'''
|
|
404
|
-
|
|
405
|
-
<-query attribute='resources'->
|
|
406
|
-
----
|
|
407
|
-
'''Precursors: '''
|
|
408
|
-
|
|
409
|
-
<-query attribute='precursors'->
|
|
410
|
-
----
|
|
411
|
-
'''Followers: '''
|
|
412
|
-
|
|
413
|
-
<-query attribute='followers'->
|
|
414
|
-
->8-
|
|
415
|
-
]
|
|
416
|
-
</pre></div>
|
|
417
|
-
<p class="manual">The <a href="tooltip.column.html">tooltip</a> attribute describes the content of the tool tip. The first parameter is a logical expression that determines when the tool tip is active. You can specify multiple tool tips. The first matching one is being displayed. The condition is evaluated for each report line. The <code class="manual">istask()</code> function only evaluates to true for task lines. See <a href="functions.html">functions</a> for a complete list of functions that can be used in <a href="logicalexpression.html">logical expressions</a>.</p>
|
|
418
|
-
<p class="manual">The content of the tool tip is a template that uses <a href="Rich_Text_Attributes.html#Block_and_Inline_Generators">query
|
|
419
|
-
generators</a> to include task attributes such as the start and end date.</p>
|
|
420
|
-
<p class="manual">We have chosen to include the start and end date of each task in the report. By default, TaskJuggler lists dates as day, month and year. We like the format to be similar to the format that the project syntax uses, but also like to include the weekday. To change the date format, the <a href="timeformat.html">timeformat</a> attribute can be used.</p>
|
|
421
|
-
<p class="manual">The project will last a few weeks. The most convenient unit to list efforts in is man or resource days. The <a href="loadunit.html">loadunit</a> attribute tells TaskJuggler to list the load of each task or resource in man days. Since this will just be a number without a unit, it is advisable to include a small hint for the reader that these values are indeed man or resource days. The caption of the table is a convenient place to put this information by using the <a href="caption.html">caption</a> attribute.</p>
|
|
422
|
-
<div class="codeframe"><pre class="code"> timeformat "%a %Y-%m-%d"
|
|
423
|
-
loadunit days
|
|
424
|
-
caption 'All effort values are in man days.'
|
|
425
|
-
</pre></div>
|
|
426
|
-
<p class="manual">The <code class="manual">taskreport</code> can contain more than just the table. It is not as flexible as the <code class="manual">textreport</code>, but still has support for a header and footer. Let's look at the header first. We not only like to put a headline here, but several paragraphs of text. The <a href="header.html">header</a> attribute is a <a href="Rich_Text_Attributes.html">Rich Text</a> attribute just like <a href="center.html">center</a>. We could enclose it in single or double quotes again. But for Strings that span multiple lines and potentially include single or double quotes as well, scissor-marks or cut-here-marks are recommended. These marks look like a pair of scissors that cut along a dashed line. Use <code class="manual">-8<-</code> to begin a string and <code class="manual">->8-</code> to terminate it. The opening cut mark must be immediately followed by a line break. The indentation of the following line defines the indentation that will be ignored for all lines of the string. The following lines must have at least the same indentation. The indentation that exceeds the indentation of the first line will be kept in the resulting string. With this feature, you can define multi-line Rich Text strings without disturbing the indentation structure of your project file.</p>
|
|
427
|
-
<div class="codeframe"><pre class="code"> header -8<-
|
|
428
|
-
=== Project Overview ===
|
|
429
|
-
|
|
430
|
-
The project is structured into 3 phases.
|
|
431
|
-
|
|
432
|
-
# Specification
|
|
433
|
-
# <-reportlink id='frame.development'->
|
|
434
|
-
# Testing
|
|
435
|
-
|
|
436
|
-
=== Original Project Plan ===
|
|
437
|
-
->8-
|
|
438
|
-
</pre></div>
|
|
439
|
-
<p class="manual">Section headers are surrounded by <code class="manual">==</code>. The number of equal signs, define the section level. You need to start with two equal characters for the first level. Text that is surrounded by blank lines will create a paragraph. Bullet lists can be made by starting a line with a <code class="manual">#</code> character. Remember that the indentation of cut-mark strings will be ignored. Your <code class="manual">#</code> character must not be the first character in the line as long it is only preceded by the exact same number of blanks as the first line of the cut-mark string.</p>
|
|
440
|
-
<p class="manual">If you want to reference other reports from this report, you can include the file name of this report by <code class="manual">[[</code> and <code class="manual">]]</code>. Don't include the extension of the file name, it will be automatically appended. The actual representation of the reference depends on the chosen output format. For HTML output, the reference is a click-able link to the referenced report file.</p>
|
|
441
|
-
<p class="manual">For the <a href="footer.html">footer</a> we can proceed accordingly. We just add a few more paragraphs of text to describe certain aspects of the project. By putting it all together, we end up with the following report definition.</p>
|
|
442
|
-
<div class="codeframe"><pre class="code">taskreport overview "" {
|
|
443
|
-
header -8<-
|
|
444
|
-
=== Project Overview ===
|
|
445
|
-
|
|
446
|
-
The project is structured into 3 phases.
|
|
447
|
-
|
|
448
|
-
# Specification
|
|
449
|
-
# <-reportlink id='frame.development'->
|
|
450
|
-
# Testing
|
|
451
|
-
|
|
452
|
-
=== Original Project Plan ===
|
|
453
|
-
->8-
|
|
454
|
-
columns bsi { title 'WBS' },
|
|
455
|
-
name, start, end, effort, cost,
|
|
456
|
-
revenue, chart { ${TaskTip} }
|
|
457
|
-
# For this report we like to have the abbreviated weekday in front
|
|
458
|
-
# of the date. %a is the tag for this.
|
|
459
|
-
timeformat "%a %Y-%m-%d"
|
|
460
|
-
loadunit days
|
|
461
|
-
hideresource @all
|
|
462
|
-
balance cost rev
|
|
463
|
-
caption 'All effort values are in man days.'
|
|
464
|
-
|
|
465
|
-
footer -8<-
|
|
466
|
-
=== Staffing ===
|
|
467
|
-
|
|
468
|
-
All project phases are properly staffed. See [[ResourceGraph]] for
|
|
469
|
-
detailed resource allocations.
|
|
470
|
-
|
|
471
|
-
=== Current Status ===
|
|
472
|
-
|
|
473
|
-
The project started off with a delay of 4 days. This slightly affected
|
|
474
|
-
the original schedule. See [[Deliveries]] for the impact on the
|
|
475
|
-
delivery dates.
|
|
476
|
-
->8-
|
|
477
|
-
}
|
|
478
|
-
</pre></div>
|
|
479
|
-
<p class="manual">The generated report can be found <a href="http://www.taskjuggler.org/tj3/examples/Tutorial/Overview.html" target="_top">here</a>. It serves as an entry page for the other reports. While it already contains some references, a navigator bar would be handy as well. Fortunately, there is a block generator called 'navigator' to take care of this. But before we can include the navigator in the report, we need to define it first.</p>
|
|
480
|
-
<div class="codeframe"><pre class="code">navigator navbar {
|
|
481
|
-
hidereport @none
|
|
482
|
-
}
|
|
483
|
-
</pre></div>
|
|
484
|
-
<p class="manual">
|
|
485
|
-
<a href="hidereport.html">hidereport</a> is a filter attribute. The logical expression determines which reports will be included in the navigator bar. A logical expression of 0 means hide no reports, so all are included.</p>
|
|
486
|
-
<p class="manual">The best place to put a navigator bar in the report is right at the top. We use two horizontal lines to separate the navigator from the main headline and the rest of the report. <code class="manual">----</code> at the begin of the line create such a horizontal separation line.</p>
|
|
487
|
-
<div class="codeframe"><pre class="code">textreport frame "" {
|
|
488
|
-
header -8<-
|
|
489
|
-
== Accounting Software Project ==
|
|
490
|
-
<[navigator id="navbar"]>
|
|
491
|
-
->8-
|
|
492
|
-
footer "----"
|
|
493
|
-
textreport index "Overview" {
|
|
494
|
-
formats html
|
|
495
|
-
center '<[report id="overview"]>'
|
|
496
|
-
}
|
|
497
|
-
}
|
|
498
|
-
</pre></div>
|
|
499
|
-
</div></div>
|
|
500
|
-
<br/>
|
|
501
|
-
<hr/>
|
|
502
|
-
<table style="width:90%; margin-left:5%; margin-right:5%"><tr>
|
|
503
|
-
<td style="text-align:left; width:35%;"><< <a href="Getting_Started.html">Getting_Started</a> <<</td>
|
|
504
|
-
<td style="text-align:center; width:30%;"><a href="toc.html">Table Of Contents</a></td>
|
|
505
|
-
<td style="text-align:right; width:35%;">>> <a href="The_TaskJuggler_Syntax.html">The_TaskJuggler_Syntax</a> >></td>
|
|
506
|
-
</tr></table>
|
|
507
|
-
<hr/>
|
|
508
|
-
<br/>
|
|
509
|
-
<div align="center" style="font-size:10px;">Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 by Chris Schlaeger <cs@taskjuggler.org>.<a href="http://www.taskjuggler.org">TaskJuggler</a> is a trademark of Chris Schlaeger.</div>
|
|
510
|
-
</body>
|
|
511
|
-
</html>
|