Labels

A Label is used to display text strings, which appear exactly the way you type it, on a Dashboard. Labels are versatile in that you can use literal value parameters in the text field and have the parameter value displayed. This allows the Label text to be dynamic. This Component can be used with Mobile and Application Dashboards.

When to use

Use a Label component when you need descriptive text for any dashboard or dashboard component, such as a Text Box, Check Box, or Combo Box. This is especially important for accessibility, as it helps users understand the context of the dashboard and embedded components. Labels also improve the user experience by providing clarity.

When not to use

Avoid using a Label component when having text displayed on a dashboard is not essential for user interaction.

Properties

Formatting

• Text: Text that appears in the label

• Tool Tip: Explanatory text that appears when the user hovers over the label

• Display Format: Allows user to configure formatting items like LabelTextColor, LabelFontFamily, and LabelPosition

Create a Label

1. Click Application > Presentation > Workspaces

2. Expand the Workspace and Maintenance Unit where the Grid View will be created, then click Components.

3. Click Create Dashboard Component in the dashboard toolbar.

4. Select Label from the dialog then click OK.

5. In Name and Description, enter a name and description for the Label component. Do not use special characters, dashes (-) or underscores (_) in names.

6. Configure the Text field. This will be the text to display in the Label. If using a literal value parameter, be sure to enclose the name in pipes and exclamation points. For example, |!EntityParam!|.

7. Click Save.

8. Add the Label component to a Dashboard.

9. Click Save.

10. Test the Dashboard by clicking View Dashboard. The Dashboard with the Label will be displayed in OneStream.