Packaging Considerations for XMD

You can upload the Standard User XMD file through the UI or Xmd REST Resource.

1/wave/datasets/<datasetID>/versions/<versionID>/xmds/main

1/wave/datasets/<datasetID>/versions/<versionID>/xmds/system

1/wave/datasets/<datasetID>/versions/<versionID>/xmds/user

The Standard User XMD file can’t be used in a Salesforce package because it’s tied to a dataset version that isn’t packageable. To support packaging, an alternative Master XMD file is available. The Master XMD file can be included in packages because it’s tied to a dataset container instead of a dataset version.

The following properties apply to the Master User XMD file:

• You can update the Master User XMD by deploying the WaveXmd metadata through MDAPI or by setting the userXmd property through the Dataset REST Resource:
  1/wave/datasets/<datasetIdOrApiName>

• The Master User XMD is applied to a dataset only after a dataflow that updates the dataset runs (because the dataflow sets the Standard User XMD for the new dataset version).
• Changes to the Master User XMD don’t affect the Standard User XMD.
• If you update the Standard User XMD, the Master User XMD is updated automatically.
• An MDAPI retrieve operation returns the Master User XMD file only if the file was deployed using MDAPI.
• If you do either of the following, the MDAPI retrieve operation returns an empty XMD file:
  • Update the Master User XMD file using the REST API.
  • Update the Standard User XMD file through the UI or REST API.
  This result occurs even if the files were originally deployed using MDAPI.