Wave REST API Developer Guide

Working with the Wave REST API
Wave REST API Reference
Wave REST API Resources Overview
Wave Resource
Query Resource
Charts Geodata List Resource
Charts Geodata Resource
Charts Geodata File List Resource
Charts Maps List Resource
Charts Maps Resource
Datasets List Resource
Dataset Resource
Versions List Resource
Version Resource
File Resource
XMD List Resource
XMD Resource
Lenses List Resource
Lens Resource
Lens File Resource
Lens File Metadata Resource
Dashboards List Resource
Dashboard Resource
Dependencies Resource
Features Configuration Resource
Folders List Resource
Folder Resource
Replicated Datasets Resource
Replicated Datasets List Resource
Replicated Dataset Fields Resource
Templates List Resource
Templates Resource
Templates Configuration Resource
Template Release Notes Resource
Trended Reports List Resource
Trended Reports Resource
Annotations List Resource
Annotation Resource
PDF

Newer Version Available

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

XMD Resource

Returns the extended metadata (XMD) for a version of a dataset (GET) and replaces the user XMD file (PUT).
Resource URL
1/wave/datasets/<dataset ID>/versions/<version ID>/xmds/main
1/wave/datasets/<dataset ID>/versions/<version ID>/xmds/system
1/wave/datasets/<dataset ID>/versions/<version ID>/xmds/user
Formats
JSON
Available Version
36.0
HTTP Methods
GET and PUT (on /wave/datasets/<dataset ID>/versions/<version ID>/xmds/user only)
GET Response Body
Property Name Type Description Filter Group and Version Available Version
createdBy Wave User The creator of the XMD. Small, 36.0 36.0
createdDate Date The time at which the XMD was created, in ISO8601 date format. Small, 36.0 36.0
dates XMD Date[] A list of dates with formatting information. Small, 36.0 36.0
derived​Dimensions XMD Dimension[] A list of derived dimensions with formatting information. Small, 36.0 36.0
derived​Measures XMD Measure[] List of derived measures with formatting information. Small, 36.0 36.0
dimensions XMD Dimension[] List of dimensions with formatting information. Small, 36.0 36.0
error​Message String Message if there was error copying forward the current version's user XMD to the newly created version. Small, 37.0 37.0
language String The language in which this XMD is localized. Values are:
  • bg: Bulgarian
  • zh_CN: Chinese ​Simplified
  • zh_TW: Chinese ​Traditional
  • hr: Croatian
  • cs: Czech
  • da: Danish
  • nl_NL: Dutch
  • en: English
  • en_GB: English ​(United Kingdom)
  • fi: Finnish
  • fr: French
  • de: German
  • el: Greek
  • hu: Hungarian
  • in: Indonesian
  • it: Italian
  • ja: Japanese
  • ko: Korean
  • no: Norwegian
  • pl: Polish
  • pt_PT: Portuguese ​(Portugal)
  • pt_BR: Portuguese ​(Brazil)
  • ro: Romanian
  • ru: Russian
  • sk: Slovak
  • sl: Slovenian
  • es: Spanish
  • es_MX: Spanish ​(Mexico)
  • sv: Swedish
  • th: Thai
  • tr: Turkish
  • uk: Ukrainian
  • vi: Vietnamese
 Small, 36.0 36.0
last​Modified​By Wave User The user who last updated the XMD. Small, 36.0 36.0
last​Modified​Date Date The last time the XMD was modified, in ISO8601 date format. Small, 36.0 36.0
measures XMD Measure[] List of measures with formatting information. Small, 36.0 36.0
organizations XMD Organization[] List of organizations for multi-organization support. Small, 36.0 36.0
show​Details​Default​Fields String[] Ordered list of dimensions and measures. The list defines the default order in which to show the dimensions and measures in the user interface. Small, 36.0 36.0
type String The type of XMD. Values are:
  • main
  • system
  • user
 Small, 36.0 36.0
url String The location where this XMD is stored. Small, 36.0 36.0
XMD Date
Property Name Type Description Filter Group and Version Available Version
alias String Alias of the Date column. Small, 36.0 36.0
fields XMD Date Field Formatting information for the date fields. Small, 36.0 36.0
firstDayOfWeek Integer What the first day of the week is. Small, 36.0 36.0
fiscalMonthOffset Integer Offset number of months for the fiscal year in relation to the calendar year. Small, 36.0 36.0
fullyQualifiedName String Fully qualified name of the date. Small, 39.0 39.0
label String Label of the Date column. Small, 36.0 36.0
XMD Date Field
Property Name Type Description Filter Group and Version Available Version
day String The day field. Small, 36.0 36.0
epoch​Day String The epoch day field. Small, 36.0 36.0
epoch​Second String The epoch second field. Small, 36.0 36.0
fiscal​Month String The fiscal month field. Small, 36.0 36.0
fiscal​Quarter String The fiscal quarter field. Small, 36.0 36.0
fiscal​Week String The fiscal week field. Small, 36.0 36.0
fiscal​Year String The fiscal year field. Small, 36.0 36.0
full​Field String The full-field field. Small, 36.0 36.0
hour String The hour field. Small, 36.0 36.0
minute String The minute field. Small, 36.0 36.0
month String The month field. Small, 36.0 36.0
quarter String The quarter field. Small, 36.0 36.0
second String The second field Small, 36.0 36.0
week String The week field. Small, 36.0 36.0
year String The year field. Small, 36.0 36.0
XMD Dimension
Property Name Type Description Filter Group and Version Available Version
field String The field name of the dimension (used in queries). Small, 36.0 36.0
label String The label for the dimension. Small, 36.0 36.0
link​Template String The template for formatting a link. Small, 36.0 36.0
link​Template​Enabled Boolean Indicates whether the dimension has link templates enabled. Small, 36.0 36.0
link​Tool​tip String The tooltip to be displayed for links. Small, 36.0 36.0
members XMD Dimension Member[] The member overrides for a dimension. Small, 36.0 36.0
record​Display​Fields String[] Ordered list of dimensions and measures. The list defines the default order to in which to display the dimensions and measures in the user interface. Small, 36.0 36.0
record​Id​Field String The record ID for this dimension. Small, 36.0 36.0
record​Organization​Id​Field String The record organization ID for this dimension. Small, 36.0 36.0
salesforce​Actions XMD Dimension Salesforce Action[] Salesforce actions linked to this dimension. Small, 36.0 36.0
salesforce​Actions​Enabled Boolean Indicates whether the dimension has Salesforce actions enabled. Small, 36.0 36.0
show​In​Explorer Boolean Indicates whether the dimension is displayed in the explorer. Small, 36.0 36.0
XMD Dimension Member
Property Name Type Description Filter Group and Version Available Version
color String The color for the member. Small, 36.0 36.0
label String The label for the member. Small, 36.0 36.0
member String The member value. Small, 36.0 36.0
XMD Dimension Salesforce Action
Property Name Type Description Filter Group and Version Available Version
enabled Boolean Indicates whether the action is enabled for a specific dimension. Small, 36.0 36.0
name String The name of the action. Small, 36.0 36.0
XMD Measure
Property Name Type Description Filter Group and Version Available Version
field String The field name of the measure (used in queries). Small, 36.0 36.0
format XMD Measure Format The format details for the measure. Small, 36.0 36.0
label String The label for the measure. Small, 36.0 36.0
show​In​Explorer Boolean Indicates whether the measure is displayed in the explorer. Small, 36.0 36.0
XMD Measure Format
Property Name Type Description Filter Group and Version Available Version
custom​Format String The original (XMD 1.1) format array as a single string. Small, 36.0 36.0
unit​Multiplier Double The multiplier for the unit. Small, 36.0 36.0
XMD Organization
Property Name Type Description Filter Group and Version Available Version
id String The ID of the organization. Small, 36.0 36.0
instance​Url String The instance URL for the organization. Small, 36.0 36.0
label String The label for the organization. Small, 36.0 36.0
PUT Request Body
Property Name Type Description Required or Optional Available Version
dataset Xmd​Dataset​Input​Representation Locale-specific information about the Dataset represented by this XMD. 36.0
dates Xmd​Date​Input​Representation[] List of dates with formatting information. 36.0
derived​Dimensions Xmd​Derived​Dimension​Input​Representation[] List of derived dimensions with formatting information. 36.0
derived​Measures Xmd​Derived​Measure​Input​Representation[] List of derived measures with formatting information. 36.0
dimensions Xmd​Dimension​Input​Representation[] List of dimensions with formatting information. 36.0
measures Xmd​Measure​Input​Representation[] List of measures with formatting information. 36.0
organizations Xmd​Organization​Input​Representation[] List of organizations for multi-organization support. 36.0
show​Details​Default​Fields String[] Ordered list of Dimensions and Measures. Represents the default order to show them in the UI. 36.0
XmdDatasetInputRepresentation
Property Name Type Description Required or Optional Available Version
connector String Connector source for the dataset. 36.0
description String Description of the dataset. 36.0
fully​Qualified​Name String Fully qualified name of the dataset version. 36.0
origin String Origin representing where this dataset version comes from. 36.0
XmdDateInputRepresentation
Property Name Type Description Required or Optional Available Version
alias String Alias of the Date column. 36.0
fields Xmd​Date​Fields​Input​Representation Formatting information for the date fields. 36.0
first​Day​Of​Week Integer What the first day of the week is. 36.0
fiscal​Month​Offset Integer Offset number of months for the fiscal year in relation to the calendar year. 36.0
fullyQualifiedName String Fully qualified name of the date. 39.0
label String Label of the Date column. 36.0
XmdDateFieldsInputRepresentation
Property Name Type Description Required or Optional Available Version
day String day field. 36.0
epochDay String epochDay field. 36.0
epochSecond String epochSecond field. 36.0
fiscalMonth String fiscalMonth field. 36.0
fiscalQuarter String fiscalQuarter field. 36.0
fiscalWeek String fiscalWeek field. 36.0
fiscalYear String fiscalYear field. 36.0
fullField String fullField field. 36.0
hour String hour field. 36.0
minute String minute field. 36.0
month String month field. 36.0
quarter String quarter field. 36.0
second String second field. 36.0
week String week field. 36.0
year String year field. 36.0
XmdDerivedDimensionInputRepresentation
Property Name Type Description Required or Optional Available Version
members Xmd​Derived​Dimension​Member​Input​Representation[] Member overrides for a Derived Dimension. 36.0
salesforce​Actions Xmd​Derived​Dimension​Salesforce​Action​Input​Representation[] Salesforce Actions linked to this Derived Dimension. 36.0
XmdDerivedDimensionMemberInputRepresentation
Property Name Type Description Required or Optional Available Version
color String Color for the member. 36.0
label String Label for the member. 36.0
member String Member value. 36.0
XmdDerivedDimensionSalesforceActionInputRepresentation
Property Name Type Description Required or Optional Available Version
enabled Boolean Whether the Action is enabled. 36.0
name String Name of the action. 36.0
XmdDerivedMeasureInputRepresentation
Property Name Type Description Required or Optional Available Version
format Xmd​Derived​Measure​Format​Input​Representation Format details for the Derived Measure. 36.0
field String Field name of the Measure (used in queries). 36.0
label String Label for the Measure. 36.0
show​In​Explorer Boolean Whether the Measure should be shown in the Explorer. 36.0
XmdDerivedMeasureFormatInputRepresentation
Property Name Type Description Required or Optional Available Version
custom​Format String Displays the original XMD 1.1 format array as a String. 38.0
unit​Multiplier Double Multiplier for the unit. 36.0
XmdDimensionInputRepresentation
Property Name Type Description Required or Optional Available Version
field String Field name of the Dimension (used in queries). 36.0
label String Label for the Dimension. 36.0
linkTemplate String Template for formatting a Link. 36.0
linkTemplateEnabled Boolean Whether the Dimension has link templates enabled. 36.0
linkTooltip String Tooltip to be displayed for links. 36.0
members Xmd​Dimension​Member​Input​Representation[] Member overrides for a Dimension. 36.0
recordDisplayFields String[] Ordered list of Dimensions and Measures. Represents the default order to show them in the UI. 36.0
recordIdField String Record Id for this dimension. 36.0
recordOrganizationIdField String Record Organization Id for this dimension. 36.0
salesforce​Actions Xmd​Dimension​Salesforce​Action​Input​Representation[] Salesforce Actions linked to this Dimension. 36.0
salesforceActionsEnabled Boolean Whether the Dimension has salesforce actions enabled. 36.0
showInExplorer Boolean Whether the Dimension should be shown in the Explorer. 36.0
XmdDimensionMemberInputRepresentation
Property Name Type Description Required or Optional Available Version
color String Color for the member. 36.0
label String Label for the member. 36.0
member String Member value. 36.0
XmdDimensionSalesforceActionInputRepresentation
Property Name Type Description Required or Optional Available Version
enabled Boolean Whether the Action is enabled. 36.0
name String Name of the action. 36.0
XmdDimensionInputRepresentation
Property Name Type Description Required or Optional Available Version
field String Field name of the Dimension (used in queries). 36.0
label String Label for the Dimension. 36.0
link​Template String Template for formatting a Link. 36.0
link​Template​Enabled Boolean Whether the Dimension has link templates enabled. 36.0
link​Tooltip String Tooltip to be displayed for links. 36.0
members Xmd​Dimension​Member​Input​Representation[] Member overrides for a Dimension. 36.0
record​Display​Fields String[] Ordered list of Dimensions and Measures. Represents the default order to show them in the UI. 36.0
record​Id​Field String Record Id for this dimension. 36.0
record​Organization​Id​Field String Record Organization Id for this dimension. 36.0
salesforce​Actions Xmd​Dimension​Salesforce​Action​Input​Representation[] Salesforce Actions linked to this Dimension. 36.0
salesforce​Actions​Enabled Boolean Whether the Dimension has Salesforce actions enabled. 36.0
show​In​Explorer Boolean Whether the Dimension should be shown in the Explorer. 36.0
XmdMeasureInputRepresentation
Property Name Type Description Required or Optional Available Version
format Xmd​Measure​Format​Input​Representation Format details for the Measure. 36.0
field String Field name of the Measure (used in queries). 36.0
label String Label for the Measure. 36.0
show​In​Explorer Boolean Whether the Measure should be shown in the Explorer. 36.0
XmdMeasureFormatInputRepresentation
Property Name Type Description Required or Optional Available Version
custom​Format String Displays the original XMD 1.1 format array as a String. 38.0
unit​Multiplier Double Multiplier for the unit. 36.0
XmdOrganizationInputRepresentation
Property Name Type Description Required or Optional Available Version
id ID ID of the organization. 36.0
instance​Url String Instance Url for the organization. 36.0
label String Label for the organization. 36.0