Adding a data label
A data label is a data-driven text label which you can add to your dashboard, report, or scorecard in order to display a measure or hierarchy value. A data label is also the default data visualization type that is used when you drag a column to a report or scorecard region.
2. Displaying a measure value
As an example, create a new dashboard based on the Blank template.
Go to the toolbar, click Data Visualization, and then click Data Label.
From the Explore window, drag a measure column from a data connector or data cube and drop it onto the empty data label.
To show a dollar sign in front of the measure value, right click on the data label and select Data Analysis Panel.
Edit the LineTotal measure and type '$' in the Symbol field.
Click Submit and switch to View mode to see the data label. Hover over the text to see its tooltip.
Text that does not fit in the data label is truncated using an ellipsis (...) by default. This can be changed using the Overflow property.
3. Displaying a hierarchy value
While designing a report or scorecard, drag a hierarchy or dimension column from the Explore window to the report or scorecard body region. By default, the column will appear as a data label.
4.1. Text and tooltip
Customize the text appearing in a data label and its tooltip by using the Text and Tooltip properties. You can insert regular text or use keywords in square brackets which act as placeholders (e.g., the name of a measure column).
Click Layout and expand the Padding property. This property is useful for lining up data labels and static labels (which also have this property) in the repeating body of a scorecard or report.
When a measure displayed by a data label changes value (e.g., at the data source), the data label can be animated with a highlight color for a brief duration. This can help bring the data change to the attention of the user.
To use this feature, open the Data Analysis Panel for the data label and click Edit. Make sure the Bypass Data Cache option is checked so that the latest data is used.
Go to Properties for the data label and set a value for the Data Auto Refresh Interval (seconds) property, such as 10 seconds.
Then go to the Look section and scroll down to find the Highlight Measure Value Changes property. Enable it and optionally change the highlight color or duration of the animation (i.e., duration for the highlight color to appear and then fade away in milliseconds).
Switch to View mode and effect a change in the data to see the animation. The data label will be highlighted in color which then fades away after the specified duration.
Go to Look Properties to edit or add a state style for a data label.
Use these properties to set the background or border appearance for the data label under this state.
By default, if your data contains HTML tags such as <b> or <i>, these will be displayed as just tags in the data label and not interpreted as HTML elements.
If you want the HTML tags to be rendered as HTML by the browser, or if you want to enter your own HTML formatting into the Text property, go to Properties for your data label and enable the Allow HTML Formatting option.
Go to Look Properties to edit or add background and font color. These properties will be applied when a user hovers over the data label during view mode.
5. See also
- Report basics and concepts
- Designing an inventory report
- Building a scorecard
- Formatting text
- Using the HTML Label component