ข้อใดคือประโยชน์ของการกำหนด data labels

Charts have labels that show the values of specific data points. You can specify a format for them (for example, number, currency, or percentage), change where they appear or how they look, and more.

สารบัญ Show

Values in the certification category
Values in the warning category
Active attribute
Elevated attribute
Permissions

Click the chart, then in the Format
sidebar, do one of the following:
- For pie or donut charts: Click the Wedges or Segments tab.
- For other chart types: Click the Series tab.
To add value labels and choose the format for the value (for example, Number, Currency, or Percentage), do one of the following:
- For pie or donut charts: Select the Values checkbox, then click the disclosure arrow next to the Value Data Format pop-up menu and choose an option.
  You can also display data labels in pie charts and donut charts by selecting the Data Point Names checkbox.
- For bubble charts: Click the disclosure arrow next to Bubble Labels, select the checkbox next to Values, then click the Value Data Format pop-up menu and choose an option.
- For scatter charts: Click the disclosure arrow next to Value Labels, select the checkbox next to Values, then click the Value Data Format pop-up menu and choose an option.
- For other types of charts: Click the disclosure arrow next to Value Labels, then click the pop-up menu below and choose an option.
If you want the value labels to match the format of the original data in the table, choose Same as Source Data.
Tip: To add a value label to just one item in a chart—for example, one wedge in a pie chart—first select the item, then add the value label.
Fine-tune the value labels (these controls are available only for some chart types):
- Set the number of decimal places: Click the up or down arrow.
- Choose how to display negative numbers: Choose “-100” or “(100).”
- Show the thousands separator: Select the Thousands Separator checkbox.
- Add a prefix or suffix: Enter text. It’s added to the beginning or end of the label.
- Specify where labels appear: Click the Location pop-up menu and choose an option, such as Top, Middle, Above, or Inside (the options depend on your chart type).
  
  When you create a chart, Auto-Fit is automatically turned on to prevent value labels from overlapping. To see all value labels, deselect the Auto-Fit checkbox. (Not all charts have an Auto-Fit checkbox.)
To change the font, color, and style of the labels, click any value or data label on the chart, then use the controls in the Font section of the sidebar to make changes.
To change the look of labels for just one data series, first select the series, then make changes. To select multiple series, click a value label, then Command-click a value label in another series. To select all series, click a value label, then press Command-A.
Note: The font for labels changes when you change the font for the entire chart in the Chart tab of the Format sidebar.
To position value and data labels in a pie or donut chart, and add leader lines to them, click the disclosure arrow next to Label Options, then do any of the following:
- Change the position of the labels: Drag the Distance from Center slider to set where the labels appear. Moving the labels farther from the center of the chart can help separate overlapping labels.
- Add leader lines: Select the Leader Lines checkbox. You can change the line type, color, and width of the leader lines and add endpoints to them.
- Choose leader line form: Click the pop-up menu and choose Straight or Angled. With angled leader lines, the callouts align into columns, as shown below.

Data labels, introduced in the REST API with Tableau Server 2022.3 and Tableau Cloud June 2022, are metadata that you attach to assets. Using the data label methods, you can manage both data quality warnings and certifications in a unified way.

All label operations except those related to the certification of data sources require Catalog to be enabled. Catalog requires a Data Management license.

You can attach labels to the following Tableau content or external assets:

Databases
Tables
Columns - Available in API 3.16 and later (Tableau Cloud October 2022, Server 2022.3)
Data sources
Flows
Virtual connections
Virtual connection tables

Each data label has a category, a value, and a message. It can be active or inactive, elevated or not, and it has an owner (the last person to create or update the label).

Value

A data label has a value, the range of which depends on the category. The corresponding categories and their possible values are as follows:

Label category	Valid label values
certification	certified
warning	warning deprecated stale maintenance sensitive_data extract_refresh_failure flow_run_failure

Values in the certification category

The certification category has one valid value: certified. It corresponds to certification as described at "Use Certification to Help Users Find Trusted Data" in the Tableau Server(Link opens in a new window) and Tableau Cloud(Link opens in a new window) Help, and in the certification methods listed in Metadata Methods.

Values in the warning category

The warning category values correspond to the warnings mentioned in "Set a Data Quality Warning" in the Tableau Server(Link opens in a new window) and Tableau Cloud(Link opens in a new window) Help, and in the data quality warnings methods listed in Metadata Methods.

Five of the warning category values correspond to data quality warnings:

warning : Warning
deprecated : Deprecated
stale : Stale data
maintenance : Under maintenance
sensitive_data : Sensitive data

Two of the warning category values correspond with monitoring quality warnings:

extract_refresh_failure : Extract Refresh Monitoring
flow_run_failure : Flow Run Monitoring

Once a monitoring quality warning has been triggered and the warning is attached to an asset, the warning can be seen using the data labels methods. However, you can’t create, update, or delete the monitoring quality warnings using the data labels methods. (You can’t create, update, or delete monitoring quality warnings using other methods either.) See also "How to set a monitoring quality warning" in the Tableau Server(Link opens in a new window) and Tableau Cloud(Link opens in a new window) Help and the quality warning trigger methods in Metadata Methods.

Active attribute

Data labels can be active or inactive.

An active data label can affect the treatment or display of the asset it’s attached to. For example, in the web interface, a database might show a certified icon, or a datasource might show a data quality warning indicating the data is stale.

An inactive data label does not affect the treatment or display of the asset it’s attached to. No special icons or indicators will be attached to the asset. The attributes of an inactive label are not removed, but they also do not affect the asset while the data label is inactive.

Elevated attribute

Data labels can be elevated. An elevated data label may be displayed differently in the Tableau Server or Tableau Cloud web interface. For example, in the web interface, an elevated warning will be seen as a high visibility data quality warning.

Certifications can also be elevated, but this has no effect on the treatment or display of the certification, and there is no method to change the elevated status of certifications in the web interface.

Owner

The user who created or last updated the data label is its owner.

Permissions

Permissions required to view, change, and delete labels are as listed below:

To view a data label, you must have read permissions on the associated asset.
To create, edit, or delete a warning label, you must have write permission on the associated asset.
To create, edit, or delete a certification label for an asset in a project, you must be a Tableau Server site or server admin, a Tableau Cloud site admin, a project leader for the project the asset is in, or the project owner for the project the asset is in.
To create, edit, or delete a certification label for an asset not in a project, you must have the change permissions permission on the associated asset.

Webhooks

You can create webhooks that trigger when a data label is created, updated, or deleted. For information, see "Label Events" in Webhook Events and Payloads(Link opens in a new window).