Allows you to add action buttons to your dashboard that trigger internal or external events, push and pull data (to and from enterprise apps), or perform custom workflows when clicked on. For example, you can add a button to move to the next sub tab on a dashboard using out-of-the-box KPI Studio actions.
This widget offers multiple designs of action buttons to be used, but you can further customize or edit the look-and-feel using the properties panel for action buttons.
Note: To see these in action, you will need to preview the dashboard.
Action Button events
KPI Studio offers a range of out-of-the-box actions that can be assigned to a button. These are:
- Go to Report
- Go to URL
- Go to Sub Tab
- Next Sub Tab
- Previous Sub Tab
- Reset Filters
- Reset Dashboard
Scroll down to the Action Button properties table for more information on these.
How to use Action Buttons
Note that this functionality only works on a canvas layout.
- Log in to the LSAC application as an authorized user.
- Open KPI Studio from My Apps tab in the platform left navigation bar.
- Click on the plus sign that appears at the top right corner of the window and select Dashboard.
- Select Widgets in the left navigation pane to open its panel.
- Expand the Buttons section. A selection of pre-designed buttons will appear.
- Drag any design you prefer (you can further customize it) onto your canvas.
- Then in the button’s property panel, expand the Actions section, and select a click event for this button. There are multiple types of events a button could trigger upon click event.
- Provide any additional information if your selected event requires it. For example, enter the UUID of the report to navigate to, if the Go To Report action is selected.
- To change the text that appears on the button, expand the Button Text section, and update the text. Ensure this reflects the action you want your users to perform.
- You may also further customize the button, including rendering a different style for when a user hovers over the button. See the section on button properties for a description on all customization properties.
- To test your button’s functionality, click Preview Mode and use the action button on it.
Action Button properties
This allows you to update the name of this button widget. Note that this is not the text that appears on the button itself.
|Size & Location|
Specify the x coordinates of the top left corner of the button widget, in order to position it exactly on your dashboard canvas.
Specify the y coordinates of the top left corner of the button widget, in order to position it exactly on your dashboard canvas.
Specify the width of the button widget, in pixels, in order to resize it exactly.
Note that the button size will expand if the text on it exceeds the size specified here.
Specify the height of the button widget, in pixels, in order to resize it exactly.
Note that the size of circular buttons will expand if the text on it exceeds the size specified here.
This option allows you to define the roundness of the selected button corners. Tip: For maximum circular edges, enter half the value of the button height. For example, if the height is 130 pixels, then set the edge value to 65 pixels. Moreover, an edge value greater than 65, will have no further effect in this example.
Specify the amount to rotate the selected button widget, in degrees. Positive degrees rotate the widget in a clockwise motion, and negative values in anti-clockwise motion.
Enable this toggle to maintain the aspect ratio. This means when increasing or decreasing the button’s size, it maintains its shape (i.e. the relationship between its width and height).
If this is disabled, the button can be stretched out of shape either vertically or horizontally.
Enable this toggle to lock the button at its location. This stops you from moving or resizing it. This holds true even when selecting multiple widgets on the canvas. Note that a locked button can still be customized.
Select an event that will trigger when the selected widget is clicked. Event options include:
|Report ID||If navigating to a report using the ‘Go to report’ click event, provide the UUID of the report.|
|Sub Tab #||If navigating to a sub tab using the ‘Go to sub tab’ click event, enter the order number of the sub tab.|
|URL||If navigating to an external page using the ‘Go to URL’ click event, provide the full URL of the page.|
If navigating to an external page using the ‘Go to URL’ click event, specify the page target. Options include:
Allows you to provide text that will be displayed on the button. This ideally references what function the button performs.
Allows you to align the button text within the button. You can opt to align it to the left, or right, or centrally.
Active - Hover toggle
This toggle allows you to specify the state of the button. Toggling it to Active refers to the general state that the button will be in (i.e. when not being hovered or clicked on); whereas Hover species the button’s state when the cursor hovers it.
The chosen state affects some of the remaining button properties, so you can style the button differently for the different states.
Allows you to specify the transparency of the button in the currently selected state.
Allows you to specify the font type and size of the button. (Consistent for both the states).
Allows you to select a color for the button text in the currently selected state.
Allows you to apply a formatting style, such as bold, italic or underline, to the button text. (Consistent for both the states.)
Allows you to specify the color to fill the button for the currently selected state.
Allows you to specify a width for the button’s border. If you do not prefer a border, set the slider to 0. (consistent for both the states).
Allows you to specify a color for the button border for the currently selected state.
Allows you to specify a border style to be applied to the button for the selected state.
Allows you to cast a horizontal shadow on the button by defining its size in pixels.
Allows you to cast a vertical shadow on the button by defining its size in pixels.
Allows you to define the sharpness of the button shadow. The smaller the value, the sharper and more defined the shadow will be. For a blurry or softer shadow, provide a bigger value.
Allows you to set a color for the shadow. This must be specified to make the shadow visible.