CSM 10.4 Documentation

Home

Add a Button Widget to a Dashboard

Use the Dashboard Editor to add a button widget to a dashboard.

A button widget is capable of executing a single Action when selected.

Note: This topic describes defining a background color on a form with a universal theme. If you are editing a form with a classic theme, use this link to open the previous version of Add a Button Widget to a Dashboard.

Good to know:

  • A button widget is highly configurable. Add one or many to a dashboard, then define the Action to execute when the button is selected, and how the button looks and behaves on the dashboard (example: text, size, color, background style and gloss, border style, image, alignment, anchoring, layering, and visibility). See Define How a Widget Looks and Behaves on a Dashboard.
  • Text, image, and colors can be conditional (expression-driven).
  • See Dashboard Editor Behaviors for tips on working with widgets on dashboards.

To Add a Button Widget to a Dashboard

  1. Open a dashboard in the Dashboard Editor.
  2. Drag the Button Widget from the Shapes, etc tree onto the dashboard.
  3. Define the Action to execute when the button is selected:
    1. Right-click the Button Widget, and then select Widget Properties > Widget Properties.
    2. Select the ellipsisEllipses Button to open the Action Manager, and then select the Action to execute.
    3. If you selected a One-Step Action™, you can either select or clear the Show Progress check box to control whether the progress dialog for the One-Step Action appears while it runs.
  4. Define the text to display on the button:
    1. In the Label text box on the Dashboard Editor toolbar, provide the text to display on the button.
    2. (Optional) Change the font, font size, font style, font alignment, and text wrap, if needed.
  5. Define the background color for the button widget:
    1. Right-click the Button Widget, and then select Widget Properties.
    2. Select Button color to launch the Color Selector. You can select a theme color, or define a custom color for the button background.
      Note: Color gradients are not available for dashboards using universal themes.
  6. Define how the button widget looks and behaves (example: Size, alignment, etc.).
  7. Continue making changes, or select OK to save and close the editor.


Was this article useful?