Tableau CRM Extended Metadata (XMD) Developer Guide

Extended Metadata (XMD) Overview
Basic Structure of the XMD JSON File
Packaging Considerations for XMD
Configure the XMD for a Dataset
Format Dataset Fields and Field Values with XMD
Extended Metadata (XMD) Reference
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Configure the XMD for a Dataset

You can configure the XMD file to override the default appearance of dataset fields and field values and to add actions to dimensions in charts and tables. Each dataset has a separate XMD file.
Available in Salesforce Classic and Lightning Experience.
Available with Tableau CRM, which is available for an extra cost in Enterprise, Performance, and Unlimited Editions. Also available in Developer Edition.

User Permissions Needed
To edit the XMD: Edit Tableau CRM Dataflows OR Upload External Data to Tableau CRM

You can also use the XMD API endpoints to edit an XMD file. For more information, see the Tableau CRM REST API Developer Guide.

Note

  1. Edit the corresponding dataset.
  2. Download the XMD file from the Edit page. If you download an old XMD version, Tableau CRM converts it to the current version.

    Tableau CRM ignores settings that it’s unable to convert.

    Note

  3. Edit the file with a text editor.

    To ensure that the JSON format is correct, validate it with a JSON editor.

    Tip

  4. Save the file in UTF-8 format to ensure that Tableau CRM visualizations display international characters.
  5. Upload the updated file to the Edit page.
    Tableau CRM validates the XMD file. If the XMD isn’t valid, an error occurs and the updated XMD settings aren’t applied. All formatting reverts to the defaults.

    Each time you upload the XMD file, Tableau CRM overwrites the current dataset customizations. Changes in the XMD aren’t appended to previous customizations. Therefore, ensure that your XMD file contains all required customizations.

    Note

    The validation rules and related errors are in the Extended Metadata (XMD) 2.0 Validation Rules and Errors knowledge article.

If the dataset metadata changes after you configure the XMD, such as a field is deleted or renamed as a result of changes to the dataflow, you must update the associated XMD. For example, if the XMD refers to the old field names, errors occur when you try to configure actions using the UI. The error also appears in the errorMessage field in the XMD file.