Workflow custom tasks that adjust dates in Gantt system

Some of the features employed by the Gantt scheduling system also can be accessed via workflow. For example, there are places in the IBM® TRIRIGA® applications (tasks, for example) where the ability to adjust dates based on calendar availability is desired. The same logic employed by the Gantt scheduling system can be made available to workflows via Custom tasks.

The following section describes the available classes used by the Gantt scheduling system that also can be called using Custom tasks in a workflow to adjust dates, hours, and durations based on calendar availability for virtually any type of object. In order for these classes to work, a calendar needs to be appropriately associated to the record(s) that will be processed by the workflow that uses these classes. For more information on using calendars see "Calendar and time-based events". For more information on using Custom tasks, see "Custom task". For examples of how these classes have been used by the IBM TRIRIGA applications you may refer to many of the Synchronous On Change workflows in the triTask module that are used to adjust task dates, hours, and durations using the Gantt classes defined below.

The names of the Custom task workflow calls for Gantt sections all start with com.tririga.architecture.web.process.gantt.workflow. The following table lists each Custom workflow call, gives a description of the call, and shows each field and whether it is input or output. A value of Input in a cell means that for that particular custom task, that particular field is used to calculate other fields, labeled Output.

It is important to note that the field names listed below need to be named exactly as listed in the business object that you are using the classes for or the classes will not work correctly. Ignore any hyphens you see in a class name or a field name; the class names and field names in the system do not contain hyphens. Also, remember that a field that is used as an input for one class may be used as an output for another.
CalcActualDuration
Calculates actual duration, working days and hours, total working hours based on actual start and actual end date.
  • triActualStartDT = Input
  • triActualEndDT = Input
  • triActualDU = Output
  • triActualWorkingHoursNU = Output
  • triActualWorkingInputHrsNU = Output
  • triActualWorkingInputDaysNU = Output
CalcActualEndDateFromDuration
Calculates actual end date, working hours and days, total working hours based on actual start date and actual duration.
  • triActualStartDT = Input
  • triActualEndDT = Output
  • triActualDU = Input
  • triActualWorkingHoursNU = Output
  • triActualWorkingInputHrsNU = Output
  • triActualWorkingInputDaysNU = Output
CalcActualEndDateFromWkgdays
Calculates actual end date, actual duration, actual total working hours based on actual start date and actual working days and hours.
  • triActualStartDT = Input
  • triActualEndDT = Output
  • triActualDU = Output
  • triActualWorkingHoursNU = Output
  • triActualWorkingInputHrsNU = Input
  • triActualWorkingInputDaysNU = Input
CalcActualEndDateFromWkghrs
Calculates actual duration, actual end date, actual working days and hours based on actual start date and actual total working hours.
  • triActualStartDT = Input
  • triActualEndDT = Output
  • triActualDU = Output
  • triActualWorkingHoursNU = Input
  • triActualWorkingInputHrsNU = Output
  • triActualWorkingInputDaysNU = Output
CalcActualStartDateFromDuration
Calculates actual start date, actual working days and hours, actual total working hours based on actual end date and actual duration.
  • triActualStartDT = Output
  • triActualEndDT = Input
  • triActualDU = Input
  • triActualWorkingHoursNU = Output
  • triActualWorkingInputHrsNU = Output
  • triActualWorkingInputDaysNU = Output
CalcActualStartDateFromWkgdays
Calculates actual total working hours, actual start date, actual duration based on actual working days and hours and actual end date.
  • triActualStartDT = Output
  • triActualEndDT = Input
  • triActualDU = Output
  • triActualWorkingHoursNU = Output
  • triActualWorkingInputHrsNU = Input
  • triActualWorkingInputDaysNU = Input
CalcActualStartDateFromWkghrs
Calculates actual start date, actual working days and hours based on actual end date and actual total working hours.
  • triActualStartDT = Output
  • triActualEndDT = Input
  • triActualDU = Output
  • triActualWorkingHoursNU = Input
  • triActualWorkingInputHrsNU = Output
  • triActualWorkingInputDaysNU = Output
CalcBaselineDuration
Calculates baseline duration, baseline working days and hours, baseline total working hours based on baseline start and baseline end date.
  • triBaselineStartDT = Input
  • triBaselineEndDT = Input
  • triBaselineDU = Output
  • triBaselineWorkingHoursNU = Output
  • triBaselineWorkingInputHrsNU = Output
  • triBaselineWorkingInputDaysNU = Output
CalcBaselineEndDateFromDuration
Calculates baseline end date, baseline working hours and days, baseline total working hours based on baseline start date and baseline duration.
  • triBaselineStartDT = Input
  • triBaselineEndDT = Output
  • triBaselineDU = Input
  • triBaselineWorkingHoursNU = Output
  • triBaselineWorkingInputHrsNU = Output
  • triBaselineWorkingInputDaysNU = Output
CalcBaselineEndDateFromWkgdays
Calculates baseline duration, baseline working days and hours, baseline total working hours based on baseline start and baseline end date.
  • triBaselineStartDT = Input
  • triBaselineEndDT = Output
  • triBaselineDU = Output
  • triBaselineWorkingHoursNU = Output
  • triBaselineWorkingInputHrsNU = Input
  • triBaselineWorkingInputDaysNU = Input
CalcBaselineEndDateFromWkghrs
Calculates baseline duration, baseline end date, baseline working days and hours based on baseline start date and baseline total working hours.
  • triBaselineStartDT = Input
  • triBaselineEndDT = Output
  • triBaselineDU = Output
  • triBaselineWorkingHoursNU = Input
  • triBaselineWorkingInputHrsNU = Output
  • triBaselineWorkingInputDaysNU = Output
CalcBaselineStartDateFromDuration
Calculates baseline start date, baseline working days and hours, baseline total working hours based on baseline end date and baseline duration.
  • triBaselineStartDT = Output
  • triBaselineEndDT = Input
  • triBaselineDU = Input
  • triBaselineWorkingHoursNU = Output
  • triBaselineWorkingInputHrsNU = Output
  • triBaselineWorkingInputDaysNU = Output
CalcBaselineStartDateFromWkgdays
Calculates baseline total working hours, baseline start date, baseline duration based on baseline working days and hours and baseline end date.
  • triBaselineStartDT = Output
  • triBaselineEndDT = Input
  • triBaselineDU = Output
  • triBaselineWorkingHoursNU = Output
  • triBaselineWorkingInputHrsNU = Input
  • triBaselineWorkingInputDaysNU = Input
CalcBaselineStartDateFromWkghrs
Calculates baseline start date, baseline working days and hours based on baseline end date and baseline total working hours.
  • triBaselineStartDT = Output
  • triBaselineEndDT = Input
  • triBaselineDU = Output
  • triBaselineWorkingHoursNU = Input
  • triBaselineWorkingInputHrsNU = Output
  • triBaselineWorkingInputDaysNU = Output
CalcLagInputDaysHoursFromWorkingHours
Calculates the lag working input hours and lag working input days based on the total lag working hours.
  • triLagWorkingHoursNU = Input
  • triLagInputDaysNU = Output
  • triLagInputHoursNU = Output
CalcLagWorkingHoursFromInputDaysHours
Calculates the total lag working hours based on the lag working input hours and lag working input days.
  • triLagWorkingHoursNU = Output
  • triLagInputDaysNU = Input
  • triLagInputHoursNU = Input
CalcPlannedDuration
Calculates planned duration, planned working days and hours, planned total working hours based on planned start and planned end date.
  • triPlannedStartDT = Input
  • triPlannedEndDT = Input
  • triPlannedDU = Output
  • triPlannedWorkingHoursNU = Output
  • triPlannedWorkingInputHrsNU = Output
  • triPlannedWorkingInputDaysNU = Output
CalcPlannedEndDateFromDuration
Calculates planned end date, planned working hours and days, planned total working hours based on planned start date and planned duration.
  • triPlannedStartDT = Input
  • triPlannedEndDT = Output
  • triPlannedDU = Input
  • triPlannedWorkingHoursNU = Output
  • triPlannedWorkingInputHrsNU = Output
  • triPlannedWorkingInputDaysNU = Output
CalcPlannedEndDateFromWkgdays
Calculates planned duration, planned working days and hours, planned total working hours based on planned start and planned end date.
  • triPlannedStartDT = Input
  • triPlannedEndDT = Output
  • triPlannedDU = Output
  • triPlannedWorkingHoursNU = Output
  • triPlannedWorkingInputHrsNU = Input
  • triPlannedWorkingInputDaysNU = Input
CalcPlannedEndDateFromWkghrs
Calculates planned duration, planned end date, planned working days and hours based on planned start date and planned total working hours.
  • triPlannedStartDT = Input
  • triPlannedEndDT = Output
  • triPlannedDU = Output
  • triPlannedWorkingHoursNU = Input
  • triPlannedWorkingInputHrsNU = Output
  • triPlannedWorkingInputDaysNU = Output
CalcPlannedStartDateFromDuration
Calculates planned start date, planned working days and hours, planned total working hours based on planned end date and planned duration.
  • triPlannedStartDT = Output
  • triPlannedEndDT = Input
  • triPlannedDU = Input
  • triPlannedWorkingHoursNU = Output
  • triPlannedWorkingInputHrsNU = Output
  • triPlannedWorkingInputDaysNU = Output
CalcPlannedStartDateFromWkgdays
Calculates planned total working hours, planned start date, planned duration based on planned working days and hours and planned end date.
  • triPlannedStartDT = Output
  • triPlannedEndDT = Input
  • triPlannedDU = Output
  • triPlannedWorkingHoursNU = Output
  • triPlannedWorkingInputHrsNU = Input
  • triPlannedWorkingInputDaysNU = Input
CalcPlannedStartDateFromWkghrs
Calculates planned start date, planned working days and hours based on planned end date and planned total working hours.
  • triPlannedStartDT = Output
  • triPlannedEndDT = Input
  • triPlannedDU = Output
  • triPlannedWorkingHoursNU = Input
  • triPlannedWorkingInputHrsNU = Output
  • triPlannedWorkingInputDaysNU = Output
Tip: If you are using the Gantt scheduling Custom workflow tasks on a server with no graphics card, start the Application Server with the following arguments to avoid java.awt.HeadlessExceptions when calling the tasks: -Djava.awt.headless=true