This extension brings a new type of Dashlet, to display objects in a Gantt diagram. This Dashlet can be added to a Dashboard menu. For example to display Changes and sub-changes in a Gantt diagram. But it can also be used in a Dashboard attribute. For eg. in a tab of a UserRequest details, to display the Work Orders.

Where a Gantt view is the most appropriate of course is when you are doing Project Management, with depending Tasks and you need to quickly see the critical path.

This dashlet allows you to display a set of objects in a Gantt diagram:

• The scope of the displayed objects is configured with an OQL query
• Each object is displayed as a row
  • left part of the row, provided selected fields such as the name, additional information, …
  • right part of the row displays a colored rectangle aligned to a timeline scale, using the start date and end date values of the object.
  • Within the rectangle a partial coloring shows the percentile of progress on that task,
• Between tasks, dependencies are displayed using arrows
  • It highlights on demand the critical path(s)
• The objects (for eg. the WorkOrders) can be grouped under a parent object umbrella (for eg a Change). And for each parent object, you can hide or display its sub-objets.

This dashlet is read-only, you can neither edit the displayed objects, nor navigate to their details.

Requires iTop 2.7

Use the Standard installation process for this extension.

You don't need to set any configuration, for this dashlet to work.

But you may do it, to ease/unify its usage by defining in advanced for each class:

• the fields which should be used by default,
• the colors to use, based on an enumeration field values (usually status)

See advanced_configuration

While editing a Dashboard in iTop, choose the appropriate icon to create a Gantt:

As usual, fill the required properties. The Selected class must have at least 2 dates

As long as the mandatory properties are not fully completed, you may get some error message displayed in the dashlet

If you set a Group by properties, then additional fields are required

In this example, we have customized a little the WorkOrder class, to add a parent relation

Save the Dashboard and this is what you get:

As for most Dashlets, you can use it in a Dashboard Attribute, using :this→code as wildcard parameter in the OQL query.

This configuration is not required, also it's the only way to define colors of your objects based on values of an enum (in general, you will set colors based on the status of the object, but it could be the priority or urgency or whatever). This configuration is also a mean to simplify the work of users designing a new Gantt dashlet in one of their dashboard, by presetting values.

For Combodo's customers, the best is not change this in the Module Parameters in teh ITSM Designer.

Default configuration defined in Module Parameter

Configuration

'combodo-gantt-view' => array (
    'default_colors' => array ('background_color' => '#159119', 'color' => '#fff', ),
    'classes' => array (
	'UserRequest' => array (
	    'name' => 'title',
	    'start_date' => 'start_date',
	    'end_date' => 'close_date',
	    'depends_on' => 'parent_request_id',
	    'default_colors' => array ('background_color' => '#159119','color' => '#fff',),
	    'colored_field' => 'status',
	    'values' => array (
		'new' => array ('background_color' => '#1591FF', 'color' => '#fff',),
		'escalated_tto' => array ('backgroundcolor' => '#FF9F33', 'color' => '#fff',),
		'escalated_ttr' => array ('backgroundcolor' => '#FF9F88', 'color' => '#fff',),
		'assigned' => array ('backgroundcolor' => '#159119', 'color' => '#fff',),
		'waiting_for_approval' => array ('backgroundcolor' => '#4499F9', 'color' => '#fff',),
		'approved' => array ('backgroundcolor' => '#159119', 'color' => '#fff',),
		'rejected' => array ('backgroundcolor' => '#FF9F33', 'color' => '#fff',),
		'pending' => array ('backgroundcolor' => '#FF9F44', 'color' => '#fff',),
		'dispatched' => array ('backgroundcolor' => '#FF9F55', 'color' => '#fff',),
		'redispatched' => array ('backgroundcolor' => '#FF9F66', 'color' => '#fff',),
		'closed' => array ('backgroundcolor' => '#159180', 'color' => '#fff',),
		'resolved' => array ('backgroundcolor' => '#939325', 'color' => '#fff',),
	    ),
	),
    ),
),

Configuration Parameter

'combodo-gantt-view' => array (
    'default_colors' => array ('background_color' => '#159119', 'color' => '#fff', ),
    'classes' => array (
	'UserRequest' => array (
	    'name' => 'title',
	    // ....
	    // Copy the above configuration or define your own
	),
    	'WorkOrder' => array (
		'name' => 'name',
		'start_date' => 'start_date',
		'end_date' => 'end_date',
		'colored_field' => 'status',
		'values' => array (
		    'open' => array ('background_color' => '#1591FF', 'color' => '#fff',),
		    'closed' => array ('backgroundcolor' => '#FF9F33', 'color' => '#fff',),
		),
	),
	'Change' =>  array (
		 'name' => 'title',
		 'start_date' => 'start_date',
		 'end_date' => 'end_date',
		 'depends_on' => 'parent_id',
		 //...
	),
         'Incident' => array (
            //...
        ),
        //...
    ),
),