6. Run bar as task

Complex and extended Gantt task from individual parts

• There are five tutorials for Gantt task types and features:
  • 1. Simple Main bar and Milestone - Continuous bar or one milestone
  • 2. Main bar parts - Discrete main bar with more milestones
  • 3. Main bar plans - More independent main bars or milestones in one row
  • 6. Run bar as task - Complex and extended Gantt task from individual parts
  • 7. Run box as task - Every Run box as independent Gantt task
• There are five tutorials for Gantt Run to show the run definition and all its features:
  • 1. Run array definition - Defining Gantt Run by Array string in GanttRun attribute
  • 2. Run JSON definition - Defining Gantt Run by JSON string in GanttRun attribute
  • 3. Run summary definition - Defining Gantt Run by child main bars
  • 4. Run drag - Run box resizing and moving by mouse dragging
  • 5. Run groups and API - Identification of Run boxes and API to manipulate individual boxes and their groups
• See documentation for Run bar
• To use Run bar as task set "

  run

  " flag to

  GanttTask

  .
  In this case all the boxes together will compose one Gantt task. So there can be only one Run bar as task per Gantt cell.
  To have every Run box as Gantt task set "box" to GanttTask, see the tutorial 7. Run box as task.
• The Run bar as task works similarly to discrete main bar (GanttParts), but it provides more settings to individual boxes and also extended moving and resizing possibilities, including moving the boxes between rows or grids.
• The Run is defined by

  GanttRun

  attribute. This attribute lists all the Run boxes and their individual settings.
  There are two formats of the GanttRun, Array definition and JSON definition. See the GanttRun documentation for more information.
  This example uses Array definition, the next example for Run boxes uses the JSON definition.
• The Run bar supports also Start, End and Duration cells to show and change the whole task dates.
  They are set by

  GanttRunStart

  ,

  GanttRunEnd

  ,

  GanttRunDuration

  .
  In data these cells are expected to be empty, the data are read (calculated) from and saved to GanttRun and optionally GanttRunStart.
  
• The Run bar

  percentage completion

  is set by

  GanttRunComplete

  attribute in range 0 - 100. The completion is computed for whole task.
  If used calendar / excluded dates, the percentage completion can be shown preciselly for the excluded dates if set GanttExcludeComplete.
  To round the percentage completion to some units (GanttUnits or GanttDataUnits) when is set by click to bar use GanttRoundComplete. It restricts also incomplete bars for very small completion.
• The Run bar can be

  disabled

  or

  locked

  . The state is set by

  GanttRunDisabled

  attribute or column.
  Disabled task cannot be changed and is also ignore in all calculations. Locked tasks cannot be changed.
  It is possible to permit changing the disabled/locked tasks manually by a user by GanttEditDisabled='1'.
  To have not editable task, remove the run... flags from GanttEdit and also set CanEdit='0' to all the source cells.
  

• Dependencies

  are attached for the whole Run. Normally by

  GanttDescendants

  or by

  GanttAncestors

  .
  To the first box are attached start dependencies, to the last box are attached finish dependencies.
  If the GanttTask contains only the "run", the Run need not be identified for dependency and the row id is enough, e.g. GanttDescendants = "R1" or "R2#11;R3"
  If the are more flags in GanttTask, the run is identified by '-' (minus), e.g. GanttDescendants="-@R1" or "-,-@R2#11;-,1@R3"
  See documentation for Defining dependencies.

• Manual start

  for correcting dependencies is set for the whole Run by

  GanttRunManual

  .
  It is permitted / controlled by attributes GanttRunManualChange and GanttManualSide.
  

• Resources

  are attached for the whole Run by GanttRunResources.
  See documentation for Resources assign.
• The Run bar as Gantt task still supports different settings for

  individual boxes

  like text, tooltip, class, color and so on.
  It does not support only these attributes for individual boxes: Disabled and Locked state,Complete, Resources and Manual. All these setting can be set only by cell attributes for the whole run.