The TaskJuggler User Manual

Project Management beyond Gantt Chart Drawing


<< formats (export) << Table Of Contents >> gapduration >>


Keyword functions

Purpose

The following functions are supported in logical expressions. These functions are evaluated in logical conditions such as hidetask or rollupresource. For the evaluation, implicit and explicit parameters are used.

All functions may operate on the current property and the scope property. The scope property is the enclosing property in reports with nested properties. Imagine e. g. a task report with nested resources. When the function is called for a task line, the task is the property and we don't have a scope property. When the function is called for a resource line, the resource is the property and the enclosing task is the scope property.

The number of arguments that are passed in brackets to the function depends on the specific function. See the reference for details on each function.

All functions can be suffixed with an underscore character. In that case, the function is operating on the scope property as if it were the property. The original property is ignored in that case. In our task report example from above, calling a function with an appended underscore would mean that a task line would be evaluated for the enclosing resource.

In the example below you can see how this can be used. To generate a task report that lists all assigned leaf resources for leaf task lines only we use the expression

hideresource ~(isleaf() & isleaf_())

The tilde in front of the bracketed expression means not that expression. In other words: show resources that are leaf resources and show them for leaf tasks only. The regular form isleaf() (without the appended underscore) operates on the resource. The isleaf_() variant operates on the enclosing task.

Context Global scope

Attributes hasalert, isactive, ischildof, isdependencyof, isdutyof, isfeatureof, isleaf, ismilestone, isongoing, isresource, isresponsibilityof, istask, isvalid, treelevel

taskreport "LogicalFunction" {
  formats html
  hideresource ~(isleaf() & isleaf_())
}


<< formats (export) << Table Of Contents >> gapduration >>


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