The TaskJuggler Manual Chris Schläger Marc Rührschneck The TaskJuggler Manual by Chris Schläger and Marc Rührschneck Copyright © 2001, 2002, 2003, 2004, 2005 Chris Schläger This document describes TaskJuggler version 2.1.1 Table of Contents About this document.............................................................................................................................. viii 1. Introduction............................................................................................................................................1 1.1. About TaskJuggler ......................................................................................................................1 1.2. Features and Highlights ..............................................................................................................1 1.3. TaskJuggler on the Web ..............................................................................................................2 1.4. Change Log .................................................................................................................................2 1.4.1. Version 1.0.0 (2002-03-14).............................................................................................2 1.4.2. Version 1.0.1 (2002-03-15).............................................................................................2 1.4.3. Version 1.1 (2002-05-27)................................................................................................3 1.4.4. Version 1.2 (2002-06-17)................................................................................................3 1.4.5. Version 1.3 (2002-07-30)................................................................................................4 1.4.6. Version 1.4 (2002-12-18)................................................................................................5 1.4.7. Version 1.4.1 (2003-02-24).............................................................................................6 1.4.8. Version 1.4.2 (2003-03-10).............................................................................................7 1.4.9. Version 1.9.0-unstable (2003-06-25)..............................................................................7 1.4.10. Version 1.9.1-unstable (2003-07-29)............................................................................8 1.4.11. Version 1.9.2-unstable (2003-09-05)............................................................................9 1.4.12. Version 2.0.0 (2003-11-24)...........................................................................................9 1.4.13. Version 2.0.1 (2004-03-08).........................................................................................10 1.4.14. Version 2.1.0 (2005-03-07).........................................................................................10 1.4.15. Version 2.1.1 (2005-08-04).........................................................................................11 1.5. How to Contribute.....................................................................................................................12 1.5.1. Why contribute? ...........................................................................................................12 1.5.2. Preparing a contribution ...............................................................................................12 1.5.3. Creating a Patch............................................................................................................13 1.5.4. Contributing Translations .............................................................................................13 1.5.5. Some final words to Contributors.................................................................................13 2. Installation............................................................................................................................................15 2.1. Obtaining TaskJuggler ..............................................................................................................15 2.2. The TaskJuggler Components ...................................................................................................15 2.2.1. The Graphical User Interfaces......................................................................................15 2.2.2. The command line tool taskjuggler ..............................................................................16 2.2.3. The TaskJuggler Documentation..................................................................................16 2.2.4. tjx2gantt - Transforms XML files to Postscript Gantt charts .......................................16 2.2.5. Contributed Stuff ..........................................................................................................17 2.3. Compilation and Installation.....................................................................................................17 3. Usage .....................................................................................................................................................19 3.1. Basics ........................................................................................................................................19 3.2. General Usage ...........................................................................................................................19 3.3. The Command Line Options.....................................................................................................20 3.4. Reporting Bugs and Sending Feedback ....................................................................................20 iii 4. Tutorial: Your First Project ................................................................................................................21 4.1. Starting the project ....................................................................................................................21 4.2. Global Attributes.......................................................................................................................22 4.3. Declaring Resources .................................................................................................................22 4.4. Declaring Accounts...................................................................................................................24 4.5. Specifying the Tasks .................................................................................................................24 4.6. Specifying Milestones...............................................................................................................29 4.7. Generating Reports of the scheduled Project............................................................................30 4.7.1. Generating Interactive Reports.....................................................................................30 4.7.2. Generating HTML Reports...........................................................................................31 4.7.3. Generating HTML Task Reports ..................................................................................32 4.7.4. Generating HTML Resource Reports...........................................................................33 4.7.5. Generating HTML Account Reports............................................................................34 4.7.6. Generating XML Reports.............................................................................................35 5. Usage Guide..........................................................................................................................................36 5.1. Tracking the Project ..................................................................................................................36 5.1.1. Recording Progress.......................................................................................................36 5.1.2. Recording Resource Usage...........................................................................................37 5.2. Freezing your project as it progresses.......................................................................................39 6. Language Reference ............................................................................................................................41 6.1. Comments .................................................................................................................................41 6.2. Attribute Classes .......................................................................................................................41 6.2.1. DATE ............................................................................................................................41 6.2.2. DATEINTERVAL.........................................................................................................41 6.2.3. GLOBAL_ID................................................................................................................41 6.2.4. ID..................................................................................................................................41 6.2.5. INTEGER.....................................................................................................................41 6.2.6. LOGICALEXPRESSION ............................................................................................41 6.2.7. REAL............................................................................................................................43