Servicely Capability
Reports and Dashboards
Dashboards
11 min
introduction a dashboard is a collection of selected reports used to provide a single of pane of glass visibility across processes you manage there can be more than one dashboard created and its visibility can be restricted to different roles and groups as required examples of dashboards include cio showing performance of the itsm processes service desk showing incident/request based statistics agent showing statistics of tickets assigned to them and their groups asset management showing statistics of hardware and software assets create a dashboard to create a new dashboard at the top menu bar of your servicely environment’s webpage, you’ll find a “dashboard” dropdown menu to the left of your logged on user’s first name left click and expand the dropdown menu and you will see a “create dashboard…” menu item ( (new in 1 8) in situations where you want to limit who can see the “create dashboard” option in the dashboard dropdown, you can add/modify the application “dashboard create role required” to only let people with a specific role see it (such as “administrator” or “itsm agent” in the value)) 2\ left click on the “create dashboard…” menu item and you will be taken to a “report dashboard” definition screen where you can set some of the fields name name of the dashboard description description of the dashboard active if set to yes, the dashboard will be available order the order in which the dashboard is displayed in the dropdown selection of dashboard names display name if set to yes, the dashboard’s name will be displayed display description if set to yes, the dashboard’s description will be displayed visibility restrictions a dashboard’s visibility can be restricted by a combination of private private = “no” means the dashboard is visible to other users assuming the other criteria below are met roles servicely system roles that logged on user must have before they are allowed to view the dashboard groups servicely groups that logged on user must be part of before they are allowed to view the dashboard entitlement script allows for more complex restrictions on who can view the dashboard below is a servicely screenshot of the dashboard configuration page where you can update the dashboard’s security/visibility restrictions update a dashboard’s layout and content once a dashboard is created, you can then start setting up its layout and add reports onto it to do this, view the dashboard, e g from the dashboard’s dropdown menu at the top of your screen and left click on the dashboard that you want to view on the bottom left of the dashboard’s view screen, you’ll see “edit” button if you have permission to edit it on the resulting screen, you may start adding a “layout” or a “report” element by left clicking on your selection and then dragging and dropping it onto the desired location on the dashboard please refer to the “user interface elements” section for more details about “layout” and “report” after every drag and drop, you will need to configure it such as for tabs, how many tabs and what are the labels, and for reports, what report to show when you have completed your changes, you can click the “save” button to save your changes to update an existing element on your dashboard go to the edit view of your dashboard, refer to the start of this section hover over your mouse pointer above the element you would like to update what you can do edit (wheel icon) update the parameter of the element e g for a report, change the report to display move (directional icon) move your element somewhere else on the dashboard note that you can also left click anywhere on the element and drag it to another part of the dashboard edit json (wrench icon) you can edit the underlying json object that makes up the element you will need a level of knowledge of json copy (copy icon) create a duplicate of the selected element that you can drop below other existing elements note that after you clicked on the copy icon, as you hover over your mouse pointer above other elements, you’ll see the following icon remove (cross icon) you can remove the element off the dashboard user interface (ui) elements (layout and report) there are various ui elements that are supported on the servicely dashboard the following sample report shows a combination of some of them layout elements columns spreads dashboard real estate evenly across the screen for example shows three different reports in a row panel wraps a report in a html block that you can apply custom title and styling onto it to apply a title, edit its json structure to include a top level attribute called “title”, example below where title is set to be “overview”\ the panel’s title then is displayed like tabs split a dashboard into multiple tabs/pages to group information on a single dashboard well wraps a report in a html block that you can apply custom styling onto report elements public reports reports that have been marked as not private these reports are available to anyone that has met the security criteria applied to them for more information please refer to reports docid\ odwcukhbtc1gidfebip x my reports private reports that logged on user had created filtered list shows a list of records based on the supplied table and filter update a dashboard’s definition to update a dashboard’s name, description or the visibility restrictions, go to the dashboards menu links reporting > reports > my report dashboards shows a list of private reports created by the logged on user reporting > reports > all public report dashboards shows a list of public reports you will then need to select the dashboard you want to update and you can update the relevant fields same way as creating a new dashboard administrative roles the following are the different system roles applicable to dashboards role description administrator can create dashboardscan view and edit all public and private dashboards’s layout and content can read/edit entitlement script on dashboards report editor can create dashboardscan view and edit the layout and content of all public dashboards and also the private ones that they had created can make their own private dashboards to be public platform agent can create dashboardscan view and edit the layout and content of all public dashboards and also the private ones that they had created