Stencil widgets offer more customization than standard widgets and custom widgets and are straightforward to configure. The look and organization of the widget is predefined. The data, text, and icons are easily customizable using one or two User Reports. These user reports must use specific column captions (names) for the widget to function correctly.
The Double Counter Widget is a custom stencil widget and displays two counts each with an icon and some text.
Adding a Double Counter Widget
After selecting template widget type, select Data Table from the Add Widget Templates side panel and click the
From here you can modify the following fields:
Name: This is a mandatory field. Users should give the widget a specific name to differentiate it from other instances of the widget.
Description: Description of the widget which is only viewable by users editing the dashboard. Descriptions are limited to 500 characters.
Theme: Select a color using the color picker. This will be the background color of the widget title. If no color is selected, white will be the defaulted color used.
Configuration User Report (First Row Only): Specify a user report from the list. This is a mandatory field. An option to open the report via
which will happen on a new tab and run the report is available via
which will happen on a new tab. The selected user report must use the specific column names (in bold) for the widget to function correctly and they can appear in any sequence in the report. Note, please check the Things to Note section for more details about User Reports including a screenshot of the user report for this example:
Icon 1 - Custom Calc field. Use the following HTML format between single quote marks e.g. '<i class="fal fa-ad"></i>' . For a list of support icons see: https://fontawesome.com/icons?d=gallery&s=light
Title 1 - Custom Calc field with text between single quote marks
Number 1 - any field type used to return a count number
Icon 2 - same format as Icon 1
Title 2 - same format as Title 1
Number 2 - same format as Number 1
Refresh Time Override (Hours): The number of hours to refresh the report data can be set to override the default dashboard refresh setting. A higher value improves general system performance by running reports less often. A lower value refreshes data more frequently. Certain widgets can override this setting. A user can always force a refresh in a widget to see the latest data and update their cache.
Click
to finish configuration.
The newly added widget will be added. Widgets can be moved around and resized whilst in editing mode. You can change configuration with the
icon and delete it with
Things to note
User Role security still limits report data however User Report filters must be used to further filter report data
No filters on the User Report are required for the widget to display data
User Report prompts are supported for context filters
After selecting a user report the user can run or edit the report for easy setup
The Refresh Time Override (Hours) can be set to override the default dashboard refresh time
The configuration report can have more rows when it is run but only the first row will be used to populate the widget
The text appearance is not editable and will appear in upper case