A Dashboard is a grid of tiles ranging from a One-By-One layout up to a Three-By-Three. Each tile can be an Image, a Chart from an App or a Action Button.
A Dashboard can be displayed at App level containing information from multiple Reports in that App or it can contain data from across the Site as a Homepage.
First locate the Homepages folder in App Studio. To do this click on the COGs menu and select App Studio which will open App Studio in a new browser tab. Once in App Studio, click on the launchpad icon at the top left of the screen and select the Home icon to see all globally stored features. Lastly click on Homepages folder in the Site configuration to see a list of the Homepages on the Site.
Create a New Dashboard
To add a new Dashboard select the Dashboards folder in the left pane menu and then click on the '+' icon on the right of that row. This will open a new property sheet where we can define how the Dashboard will look and what information it will contain.
Dashboard Title: The title is the reference to the Dashboard that will appear in the UI for the Users. It will appear at the top of the Dashboard as a title to the page. It will also be the label that appears when selecting the Dashboard for a Report or Homepage.
Dashboard Identifier: The identifier is a system ID for referencing a Dashboard. By default the identifier will take it's value from the Label with any white space and special characters removed. The identifier must be a minimum of three characters, only contain letters and numbers and start with a letter. The identifier will be visible to Users in the URL for the Homepage.
Layout Type: This option allows you to select the number of tiles in columns and rows that you would like to appear in the Dashboard grid. a Dashboard layout of Three-By-Two would give six tiles in three columns and two rows
Is Global?: If the 'Is Global?' property is set to true then tiles can contain information across multiple Apps and the Dashboard will be available for selection as a Homepage. If the 'Is Global?' property is false then the Dashboard will be available for selection for a Report at App Level. In this scenario the tile data must come from only one App and this will be the App that the Dashboard is displayed in.
Selecting Images, Reports and Action Buttons
Toggle between the icons at the top of each tile to choose whether the tile will display an image, an icon or a Action Button.
Image: To add an image, enter a URL as the source for the image, choose from the existing list of image assets or click on 'Upload New Asset’ which this will pop out an image upload pane from the right of the screen where you can add the image.
App Report: First select the App that the Report appears in and then the Report from that App to display. A Default Global Filter can be selected to be the default view that a user sees when accessing the Dashboard and the filter selection can be shown or hidden on load.
Action Button: The Button must first be added as an Image Action Button to an App. This is where you will configure what action the button will perform such as navigating to a Record Add screen or to a Report in an App. Then in the tile configuration select the App that the Button was created in and the Button Field that was created in it.
Note: If the 'Is Global?' property is false then all tile data must come from the same App.
Alignment within a Tile
Once you have selected the image, report or button to display in the Tile you can then configure the alignment of the element within the Tile.
Alignment: This will determine if the element is left, right or centrally aligned in the tile.
Transparent Background?: If this property is checked then the area around the element will take the Background Colour for the Report or Homepage. If it is not ticked then the area around the element will be white.
Hide Title?: Hiding the Title will not display the header information at the top of the tile
Once you are happy with the Dashboard configuration, save your view by clicking the tick icon at the top right of the screen. The Dashboard will then be available to add as an App Report or Homepage as appropriate.