Like the Custom Chart, the Custom Gantt Chart allows you to display several forms of data in the dashboard as a gantt chart. Nodes or global variables may be added to the Custom Chart. Code is then executed to specify what data will appear in the chart..
Associations
Custom Gantt Charts are tied to associations, rather than restricted to only objects as with other Dashboard Widgets. An association can be a node in the tree, an object, global table, label table, etc. Associations can be added to the custom chart any number of times.
Displaying Data
There are 9 picklists that allow you to specify how many resources and how many entries are displayed in the chart. Resources will be the rows on the left and entries will be blocks on that row. All picklists are fired each time the graph is drawn. This allows the number of series and categories to be dynamically changed, ie a global table that has columns or rows added to it. A list of presets is available for displaying table and bundle values.
# Resources
The number of resources for each association. This will be evaluated once per association. The value returned should be an integer.
Access Variables
- current: the association object/node.
Resource Title
This picklist is fired for each resource. These titles will display as the row titles. The value returned should be a string.
Access Variables
- current: the association object/node.
- resourcenum: the index of the resource.
Resource Span
This picklist is fired for each resource. The value returned should be a 1 or 0. Normally you should return 0. Returning a 1 will make that resoure display its entries as blocks that are drawn taller and lighter and on the same row as the next resource behind its entries. This allows you to display two types of information in the same row.
Access Variables
- current: the association object/node.
- resourcenum: the index of the resource.
# Entries
The number of entries is calculated for each resource. The value returned should be an integer.
Access Variables
- current: the association object/node.
- resourcenum: the index of the resource.
Start Time
The start time is calculated for every entry of every resource. The value returned should be a number.
Access Variables
- current: the association object/node.
- resourcenum: the index of the resource.
- entrynum: the index of the entry.
End Time
The end time is calculated for every entry of every resource. The value returned should be a number.
Access Variables
- current: the association object/node.
- resourcenum: the index of the resource.
- entrynum: the index of the entry.
Block ID
The block ID is calculated for every entry of every resource. Each unique block ID will be turned into a title in the legend and will be represented with a different color. The value returned should be an integer.
Access Variables
- current: the association object/node.
- resourcenum: the index of the resource.
- entrynum: the index of the entry.
Block ID Title
The block ID title is evaluated for every block ID. These titles will display in the charts legend. The value returned should be a string.
Access Variables
- current: the association object/node.
- blockid: the index of the block ID.
Show Block ID
This is evaluated for every block ID to determine if the block ID should be shown The value returned should be a boolean.
Access Variables
- current: the association object/node.
- blockid: the index of the block ID.
Example
The example Custom Gantt Chart at the beginning of this section was made by pointing at this global table and one other and using the settings shown in the Data Tab image above.
This chart was made using the same settings as above except the Resource Span was set to resourcenum == 1.
Collect Data from Ordered Lists
Unchecking this box allows you to display data from a table that has unordered data.
The chart above was made by pointing at the table below using the default preset settings for table values.
The main difference here is that the resource and block titles will be determined by the data the chart is associated with. In the above example the resource titles come from the first column and the block titles come from the second. Each unique name will be its own resource or block and values with the same resource and block names will be grouped together.
