Define and Format Widget Text

Use the Dashboard Editor to define and format Widget text. A Widget has different kinds of text:

• Label: Text to display in the Widget header to identify the Widget. By default, the Widget label comes from the Widget title.
• Data: Data to display inside the Widget (ex: Numbers, charts, etc.).

You can manually change any label and apply different fonts, if needed.

Good to know:

• Label text can be conditional (Expression-driven). For example, define an Expression to change a label when a threshold is surpassed ("Too Many Open Incidents!").
• Text wrapping in labels can be turned On or Off.
• Text formatting options include:
  • Font: Theme or explicit font family.
  • Font size: Point size for an explicit font, or relative size (small/medium/large) for a Theme font.
  • Font style: Bold, underline, or italics (explicit fonts only).
  • Font alignment: Horizontal (left, center, right) and vertical (top, middle, bottom) alignment of text ONLY on a Text, Button, or Link Shape Widget.
    Note: Text color is defined as a foreground color.
• See Dashboard Editor Behaviors for tips on working with Widgets on Dashboards.

To define and format Widget text:

1. Open a Dashboard in the Dashboard Editor
2. Click a Widget.
3. Define a label, either static or conditional text:
   • Static: In the Label text box, provide the label to display in the Widget.
   • Expression-driven text (conditional): Click the Expression button , and then define the Expression (condition) to determine the label, using either:
     • Custom Expression: Select this option to open the Custom Expression Builder, and then create a custom Expression specifically for this scenario.
     • Expression Manager: Select this option to open the Expression Manager, and then select an existing stored Expression or create a new stored Expression. Stored Expressions can be re-used in numerous places in CSM.
4. Define text formatting:
   1. Font: In the Font drop-down on the Dashboard Editor toolbar, select a font family, either:
      • Theme font: Font comes from your default system font (ex: Segoe UI).
      • Explicit font: Font is selected by you.
   2. Font style (explicit fonts only; Theme font defines this): On the Dashboard Editor toolbar, click the Bold, Underline, and/or Italics buttons .
   3. Font size, either:
      • Exact (explicit font): In the Font Size drop-down , select a point size (ex: 10).
      • Relative (Theme font): On the Dashboard Editor toolbar, click the Small/Medium/Large button .
   4. Horizontal alignment (Text, Button, or Link Shape Widgets only): On the Dashboard Editor toolbar, click one of the Horizontal Alignment buttons (Left, Center, or Right) to align the text on a horizontal axis within the control box (ex: Left, Center, or Right).
   5. Vertical alignment: On the Dashboard Editor toolbar, click one of the Vertical Alignment buttons (Top, Middle, or Bottom) to align the text on a vertical axis within the control box (ex: Top, Middle, or Bottom).

5. Continue making changes, or click OK to save and close the editor.