2. Availability chart

Bar charts defined by a list of date ranges and count

• Definition

  • The Availability chart is defined by attribute

    GanttAvailability

    .
    The Availability format is: repeater1#date1a~date1b#count1;repeater2#date2a~date2b#count2;.....
    The date range is range where the count of resources is available. If set repeater, it repeats the date range every given time unit, e.g. "w" as week, "d" as day or "10" as 10 units in number chart.
    
  • There are two possible Availability chart types, work and material. It is set by

    GanttAvailabilityType

    .
    (1) work is not consumed resource. Work resource is available only in defined range.
    (2) material, consumed resource. Material resource arrives on defined date and is available forever.
    
  • One cell can contain more charts defined by more GanttAvailability values, set GanttAvailability attribute to list of cells containing the Availability formats.
  • The Availability chart sources can be simply summed up by formula function sumrange. Or by simple add formula plus semicolon like: "A+';'+B+";'+C".
    The chart sources can be also subtracted by summing them with negate sign add by negav Formula function.
  • The Availability chart source can be created also as resource usage (of GanttResource value) by method GetResourceUsage.
  • The GanttAvailability attribute can have also special format to show various resource usage charts. See previous tutorial Resources.
  • It is possible to define more sets (groups) of availability charts by using GanttAvailabilityGroups. It changes all the GanttAvailability attribute names and defines them for every the group.

• Bar position and size

  • The size and position of all or individual availability charts can be controlled by GanttAvailabilityShift and GanttAvailabilityHeight.
  • The more availability charts in one cell can be stacked vertically or horizontally by GanttAvailabilityStack
  • By default the upper and lower bound is the highest and smallest value in the one chart. It is possible to preset the bounds by GanttAvailabilityMax and GanttAvailabilityMin.
  • The Availability bars can be rounded or split to GanttExclude parts, set the option by GanttAvailabilityExclude. It can be done only for Work resources.
  • The Availability bars can be split to selected date units by GanttAvalilabilitySplit and GanttAvailabilityUnits.
  • The adjacent ranges with the same value are automatically joined. To not do it, set GanttAvailabilityJoin="0".

• Display and look

  • Every chart can have different color set by

    GanttAvailabilityClass

    .
    It is possible also have different colors for every bar or group of bars in one chart, depending on the bar height, it can be controlled dynamically in OnGetAvailabilityClass API event.
    The labels have the same color as the bars, or they can have one color defined by GanttAvailabilityTextClass.
  • It is possible to show only texts, only bars or both, by GanttAvailabilityShow
  • The label position regarding to the bars can be controlled for every availability chart by GanttAvailabilityVPos and GanttAvailabilityHPos
  • To not overlay the labels hide some of them by setting higher value to GanttAvailabilityTextWidth

• Other

  • The availability values can show summary in selected date ranges set by GanttAvailabilitySum.
  • It is possible to show also zero value boxes as a little height boxes by GanttAvailabilityZero.