The TaskJuggler User Manual

Project Management beyond Gantt Chart Drawing

<< newtask << Table Of Contents >> note (task) >>

Keyword nikureport

This report generates an XML file to be imported into the enterprise resource management software Clarity(R) from Computer Associates(R). The files contains allocation curves for the specified resources. All tasks with identical user defined attributes ClarityPID and ClarityPNAME are bundled into a Clarity project. The resulting XML file can be imported into Clarity with the xog-in tool.
Syntax nikureport <file name> <STRING> { <attributes> }
Arguments file name
The name of the time sheet report file to generate. It must end with a .tji extension, or use . to use the standard output channel.
Context properties

Attributes Name Scen. spec. Inh. fm. Global Inh. fm. Parent
end (report) x x
formats x
headline x
period (report)
start (report) x x
timeoff (nikureport)
title x

project "Niku Test" 2010-02-01 +3m {
  timezone "America/Denver"
  extend task {
    text ClarityPID "Clarity PID"
    text ClarityPName "Clarity Project Name"
  extend resource {
    text ClarityRID "Clarity Resource ID"

# The ClarityPID and ClarityPName must be always kept in sync. The
# easiest way to achieve this, is by using such macros.
macro PID_p1 [ ClarityPID "p1" ClarityPName "Project 1" ]
macro PID_p2 [ ClarityPID "p2" ClarityPName "Project 2" ]
macro PID_p3 [ ClarityPID "p3" ClarityPName "Project 3" ]

macro Resource [
  resource ${1} "${1}" {
    ClarityRID "${1}"

${Resource "r1"}
${Resource "r2"}
${Resource "r3"}

supplement resource r2 {
  vacation 2010-02-15 +1w

task "T1" {
  allocate r1
  effort 5w

task t2 "T2" {
  allocate r2
  effort 10d

task "T3" {
  depends !t2
  allocate r2
  effort 10d

task "T4" {
  allocate r3
  effort 3w

nikureport "niku" {
  formats niku, html, csv
  headline "This is a test report"
  period 2010-02-01-8:00 - %{2010-03-01 -6h}
  timeoff "vacations" "Vacation time"
  # Depending on your Clarity configuration, you may need to add this
  # CustomInformation section in the report. It's raw XML code and
  # will be embedded into each <Project> section of the resulting
  # report. This is just an example and it must be customized to work!
  title -8<-
    <ColumnValue name="foo_state">foo_active</ColumnValue>
    <ColumnValue name="partition_code">foo_eng</ColumnValue>

<< newtask << Table Of Contents >> note (task) >>

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.