The TaskJuggler User Manual

Project Management beyond Gantt Chart Drawing

<< Intro << Table Of Contents >> Reporting_Bugs >>

1.5 TaskJuggler 2.x Migration

This section will cover changes between TaskJuggler 2.x and 3.x.

1.6 Using TaskJuggler 2.x and TaskJuggler 3.x in parallel

While TaskJuggler 3.x has many new features over TaskJuggler 2.x like the much improved HTML reports, many 2.x users will miss the graphical user interface.

To ease the migration, you can continue to use the TaskJuggler 2.x front-end while using TaskJuggler 3.x for report generation. This is possible because TaskJuggler 3.x can read-in the TaskJuggler 2.x export files. Export files are fully scheduled projects that include start and end dates for all tasks and bookings for resource allocations.

To export all tasks and resources into a TJP file that can be read by TaskJuggler 3.x include the following export report definition in your TaskJuggler 2.x project plan. The necessary patches to support this only made it into TaskJuggler 2.x after the 2.4.3 release. So be sure to use a recent version from the Git repository to try this.

export "FullProject.tjp" {
  taskattributes all
  resourceattributes all
  hideresource 0

The resulting FullProject.tjp file is a valid self-contained project file that can be read with TaskJuggler 2.x or TaskJuggler 3.x. The file does not contain any report definitions. To generate reports with TaskJuggler 3.x you need to create an additional file that contains the TaskJuggler 3.x report definitions.

Let's assume the file is called tj3reports.tji. Start TaskJuggler 3.x with the following command:

tj3 FullProject.tjp tj3reports.tji

Now you have generated TaskJuggler 3.x reports from you TaskJuggler 2.x project.

<< Intro << Table Of Contents >> Reporting_Bugs >>

Copyright (c) 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 by Chris Schlaeger <>.TaskJuggler is a trademark of Chris Schlaeger.