Demo Example: Gantt Dashboard
The Gantt Dashboard represents events as classic Gantt chart. It allows dashboard user to view a project or events schedule on the timeline, and manage them. Here is how such dashboard can look like:

To make this dashboard administrator should do actions listed below:
Create new dashboard
Go to dashboard creation wizard and create new standard dashboard.
Give it a name and description.
Select default "White" theme.
Save dashboard and go to Kanban builder.
Configure dashboard
Go to Variables Configuration tab. Add these variables:
from =
FORMULA[STARTOFWEEK({$System.Date})]to =
FORMULA[ADDDAYS(STARTOFWEEK({$System.Date}),7,false)]range =
weekcolumnName =
FORMULA[FORMAT(STARTOFWEEK({$System.Date}),'d MMM yyyy') + ' - ' + FORMAT(ADDDAYS(STARTOFWEEK({$System.Date}),6,false),'d MMM yyyy')]dayOfWeek =
FORMULA[{$System.Date} - STARTOFWEEK({$System.Date})]
Go to Statistics Configuration.
Add the cell which will overlay unnecessary views selector. Set these properties to it:
Type = Text
Value = Gantt Dashboard
Set CSS Styles to this cell:
Add another cell with these properties:
Type = Text
Set Value to the following formula:
This formula sets the text at the middle of Kanban header to represent currently selected date range.
Configure column
Add 1 column to the dashboard.
Name it {$Variables.columnName}
Leave column width default ("auto")
Leave column "Is Active" checkbox default (checked)
Set these properties to the column:
Data Source Type = SObject
Data Source = Event
Order = Start Date Time, asc
Page size = 20
Set the following conditions to the column (set type to "Formula" to all):
End Date Time >=
FORMULA[FORMAT({$Variables.from}, 'yyyy-MM-dd{QUOTE}T00:00:00Z{QUOTE}')]Start Date Time <
FORMULA[FORMAT({$Variables.to}, 'yyyy-MM-dd{QUOTE}T00:00:00Z{QUOTE}')]End Date Time <
FORMULA[FORMAT({$Variables.to}, 'yyyy-MM-dd{QUOTE}T00:00:00Z{QUOTE}')]Start Date Time >=
FORMULA[FORMAT({$Variables.from}, 'yyyy-MM-dd{QUOTE}T00:00:00Z{QUOTE}')]Start Date Time <
FORMULA[FORMAT({$Variables.from}, 'yyyy-MM-dd{QUOTE}T00:00:00Z{QUOTE}')]End Date Time >=
FORMULA[FORMAT({$Variables.to}, 'yyyy-MM-dd{QUOTE}T00:00:00Z{QUOTE}')]
Set this logic to column conditions:
Set this CSS style to column header in Header Configuration tab:
Set these CSS styles to column body in Body configuration tab:
Add a background-image property to column body CSS styles. Set its value to this code (don't think about formatting - the code below will lose it after being inserted into CSS Rule Value input field):
This big formula is used to make column background depending on date range selected:
First background gradient draws weekends
Second gradient draws borders between weeks
Third gradient draws days borders (except when date range = year, because only weeks are drawn due too small days widths)
Set these CSS styles to column footer on Footer Configuration tab:
We're moving column footer to the top in order to have a header where we can use Rows
Set the following Rows with Cells on them (all cells should have Type = Text):
Row 1 (for Quarter date range)
1
2
3
Row 2 (for Year date range)
1
Jan
January
2
Feb
February
3
Mar
March
4
Apr
April
5
May
May
6
Jun
June
7
Jul
July
8
Aug
August
9
Sep
September
10
Oct
October
11
Nov
November
12
Dec
December
Row 3 (for Month date range)
Add 31 cells.
Set names from 1 to 31 to them
Set these CSS Styles to them:
1...28
From 1 to 28
29
29
30
30
31
31
Days from 1 to 28 are shown for each month. Days from 29 to 31 are shown depending on specific month length.
Row 4 (for Week date range)
Add 7 cells
Set CSS Styles to all of them to the following:
Set their Values to these:
1
2
3
4
5
6
7
Configure card
This card does not require configuring Junction Settings in the one existing column. Just leave "Visible in this column" checkbox checked.
Add one card to dashboard.
Set Data Source Type to "Event".
Configure Card Layout
Set Card Layout to "Form".
Click "+" button to add new Form. Create new form with these properties:
Name
Event form
Data Source Object
Event
Multi Page Form?
false
Show navigation panel
true
Buttons configuration
Check "Save" button for "Edit" mode only. Uncheck other.
Header configuration
{$Event.Subject} (for all modes)
Add these elements to the form:
Type =
SectionName =sectionTitle =''(leave empty) Properties: Columns =2Show on Edit page =trueShow on View page =trueScrollable =falseType =
ButtonName =buttonTitle =CloseProperties: Show on Edit page =trueShow on View page =true
The following elements all should be added into section configured above. All these elements should be Data Source Fields:
Data Source Field =
SubjectName =SubjectTitle =SubjectData Source Field =
TypeName =TypeTitle =TypeData Source Field =
EventSubtypeName =EventSubtypeTitle =SubtypeData Source Field =
StartDateTimeName =StartDateTimeTitle =Start Date TimeData Source Field =
EndDateTimeName =EndDateTimeTitle =End Date TimeData Source Field =
DescriptionName =DescriptionTitle =Description
Set properties of all Data Source Fields above to:
Required =
falseRead Only =
falseShow on Edit page =
trueShow on View page =
trueInstructions = (not set)
Conditional Styles = (not set)
Events = (not set)
View Type (for picklists) =
Single listHide 'None' (for picklists) =
falseOption groups (for picklists) = (not set)
Add these Form Actions:
Action name and Title =
Close PanelType =Form APIForm Action Type =Fire EventName =e.c.:ApplicationEventParameters = Name:data; Value Type:Object; Value:{"componentType":"c:KanBanPanelComponent","method":"hideCard"}Has Conditions =falseAction name and Title =
Refresh ColumnType =Form APIForm Action Type =Fire EventName =e.c.:ApplicationEventParameters = Name:data; Value Type:Object; Value:{"componentType":"c:KanBanColumnComponent","method":"refresh","params":{"kanbans":"{$FormParameters.kanban}"}}Has Conditions =trueConditions = 1:Form.StartDateTime not equal to {$Event.StartDateTime}; 2:Form.EndDateTime not equal to {$Event.EndDateTime}Conditions logic ={1} OR {2}
Add the following events to the form:
1
Form
Type: onAfterSave Enabled: true
"Refresh Column" action without parameters
2
"Close" button
Type: onClick Enabled: true
"Close Panel" action without parameters
Set these parameters for the Card Layout body:
id = {Event.Id}
mode = edit
Set other Card Layout properties:
Position = Modal
Hide Header = false
Hide Footer = true
Go to "Header Configuration" tab and set Text in Title Settings to "{event.Subject}".
The Layout described above will show the form with basic Event properties that can be edited.
Configure Card Compact Layout
Set the following CSS Styles to the whole Card:
Add a background-color property to Card CSS Styles and set its value to the following formula:
This formula sets the Card background color depending on keywords the subject of Event can contain:
Event with "meeting" word in subject is light green
Event with "send", "letter" or "email" word is red
Event with "call" word is blue
Other events are yellow brown
Add a border-radius CSS property and set its value to the following formula:
This formula sets the border radius of Cards (that are Gantt Chart Lines) corners to represent if the current Gantt line is started or ended in the shown date range or not. If the start (or end) date is out of range, both left (or right) corners will not be rounded, otherwise they will be rounded.
Add a left CSS property and set its value to the following formula:
This formula calculates position of the Card left side that should represent the Start Date of Event. The SCALE(***,8) function truncates the result to 8 digits in order to avoid long decimal fractions.
Add a width CSS property and set its value to the following formula:
This formula calculates the width of the Card. Position of Card right side after applying left and width CSS properties will represent the End Date of Event. Width of the card, thus, represents its duration.
Change the Value of default existing Card Component to {Event.Subject}.
Set its Title to the same value.
Set its CSS Styles to these:
Add one more Card Component of "Icon" type to the left of the previous.
Set its Value to the following formula:
This formula sets the icon depending on keywords the subject of Event can contain:
Event with "meeting" word in subject has utility:groups icon
Event with "send", "letter" or "email" word has utility:email icon
Event with "call" word has utility:call icon
Other events have utility:note icon
Set its Title to {Event.Subject}
Set its CSS Styles to these:
Add one more Card Component of "Text" type below the two previous.
Set its Value to this formula:
Set its Title to this formula:
Set its Handler to this one:
Type = SObject
Value = {$Object.Id}
Parameters: id = {Event.Id}
Set its CSS Styles to these:
Configure dashboard actions and action groups
There are several action groups needed to be created. These groups are listed below with actions they contain. Order of actions in groups is determined by actions indexes: the action with lowest index will be executed first. Refer to proper articles to know how to work with actions and action groups.
"Get Previous Dates" action group
Create Action Group named "Get Previous Dates" and add following actions to it:
1
Get Prev Quarter Dates
Type = Define Variable Execute = With Conditions Conditions type = Formula Formula Expression =
Variable Type = JSON Variables JSON =
2
Get Prev Year Dates
Type = Define Variable Execute = With Conditions Conditions type = Formula Formula Expression =
Variable Type = JSON Variables JSON =
3
Get Prev Month Dates
Type = Define Variable Execute = With Conditions Conditions type = Formula Formula Expression =
Variable Type = JSON Variables JSON =
4
Get Prev Week Dates
Type = Define Variable Execute = With Conditions Conditions type = Formula Formula Expression =
Variable Type = JSON Variables JSON =
5
Define Column Name
Type = Define Variable Execute = Always Variable Type = Text Variable Name = columnName Variable Value =
6
Define Day of Week
Type = Define Variable Execute = Always Variable Type = Text Variable Name = dayOfWeek Variable Value =
"Get Next Dates" action group
Create Action Group named "Get Next Dates" and add following actions to it:
1
Get Next Week Dates
Type = Define Variable Execute = With Conditions Conditions type = Formula Formula Expression =
Variable Type = JSON Variables JSON =
2
Get Next Quarter Dates
Type = Define Variable Execute = With Conditions Conditions type = Formula Formula Expression =
Variable Type = JSON Variables JSON =
3
Get Next Year Dates
Type = Define Variable Execute = With Conditions Conditions type = Formula Formula Expression =
Variable Type = JSON Variables JSON =
4
Get Next Month Dates
Type = Define Variable Execute = With Conditions Conditions type = Formula Formula Expression =
Variable Type = JSON Variables JSON =
5
Define Column Name
(this is the same action that was already created for the "Get Previous Dates" action group)
6
Define Day of Week
(this is the same action that was already created for the "Get Previous Dates" action group)
"Get Date Ranges" action group
Create Action Group named "Get Date Ranges" and add following actions to it:
1
Get Week Dates
Type = Define Variable Execute = With Conditions Conditions type = Formula Formula Expression =
Variable Type = JSON Variables JSON =
2
Get Year Dates
Type = Define Variable Execute = With Conditions Conditions type = Formula Formula Expression =
Variable Type = JSON Variables JSON =
3
Get Month Dates
Type = Define Variable Execute = With Conditions Conditions type = Formula Formula Expression =
Variable Type = JSON Variables JSON =
4
Get Quarter Dates
Type = Define Variable Execute = With Conditions Conditions type = Formula Formula Expression =
Variable Type = JSON Variables JSON =
5
Define Column Name
(this is the same action that was already created for the "Get Previous Dates" action group)
6
Define Day of Week
(this is the same action that was already created for the "Get Previous Dates" action group)
Configure dashboard buttons and menus
Add buttons and menu to the dashboard:
Button Basic configuration: Type =
IconTitle =Previous {$Variables.range}Icon =utility:leftHandler configuration: Type =Action GroupValue =Get Previous DatesParameters =variables = {"button":"prev"}Success Handler =Kanban API -> Refresh KanbansMenu Basic configuration: Type =
ButtonLabel =FORMULA[REPLACE({$Variables.range},SUBSTR(,0,1),UPPER(SUBSTR({$Variables.range},0,1)))]Title ={$Variables.range}Position =Right and TopButton Basic configuration: Type =
IconTitle =Next {$Variables.range}Icon =utility:rightHandler configuration: Type =Action GroupValue =Get Next DatesParameters =variables = {"button":"next"}Success Handler =Kanban API -> Refresh Kanbans
Add Menu Buttons to the Menu created above and set these properties for them:
Basic Configuration: Type =
StandardLabel =QuarterTitle =QuarterConditions =FORMULA[{$Variables.range != 'quarter']Handler configuration: Type =Action GroupValue =Get Date RangesParameters =variables = {"range":"quarter"}Success Handler =Kanban API -> Refresh KanbansBasic Configuration: Type =
StandardLabel =MonthTitle =MonthConditions =FORMULA[{$Variables.range != 'month']Handler configuration: Type =Action GroupValue =Get Date RangesParameters =variables = {"range":"month"}Success Handler =Kanban API -> Refresh KanbansBasic Configuration: Type =
StandardLabel =YearTitle =YearConditions =FORMULA[{$Variables.range != 'year']Handler configuration: Type =Action GroupValue =Get Date RangesParameters =variables = {"range":"year"}Success Handler =Kanban API -> Refresh KanbansBasic Configuration: Type =
StandardLabel =WeekTitle =WeekConditions =FORMULA[{$Variables.range != 'week']Handler configuration: Type =Action GroupValue =Get Date RangesParameters =variables = {"range":"week"}Success Handler =Kanban API -> Refresh Kanbans
Last updated