Wave REST API Developer Guide (Pilot)

Working with the Wave REST API
Wave REST API Reference
Wave REST API Resources Overview (Pilot)
Wave Resource
Query 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
Dashboards List Resource
Dashboard Resource
Dependencies Resource
Folders List Resource
Folder Resource
Templates List Resource
Templates Resource
Templates Configuration 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
34.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, 34.0 34.0
createdDate Date The time at which the XMD was created, in ISO8601 date format. Small, 34.0 34.0
dataset XMD Dataset Locale-specific information about the dataset represented by this XMD. Small, 34.0 34.0
dates XMD Date[] A list of dates with formatting information. Small, 34.0 34.0
dimensions XMD Dimension[] A list of dimensions with formatting information. Small, 34.0 34.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, 34.0 34.0
lastModifiedBy Wave User The user who last updated the XMD. Small, 34.0 34.0
lastModifiedDate Date The last time the XMD was modified, in ISO8601 date format. Small, 34.0 34.0
measures XMD Measure[] List of measures with formatting information. Small, 34.0 34.0
organizations XMD Organization[] List of organizations for multi-organization support. Small, 34.0 34.0
showDetailsDefaultFields 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, 34.0 34.0
type String The type of XMD. Values are:
  • main
  • system
  • user
 Small, 34.0 34.0
url String The location where this XMD is stored. Small, 34.0 34.0
XMD Dataset
Property Name Type Description Filter Group and Version Available Version
connector String The connector source for the dataset. Small, 34.0 34.0
description String The description of the dataset. Small, 34.0 34.0
fullyQualifiedName String The fully qualified name of the dataset version. Small, 34.0 34.0
origin String The origin of the dataset version. Small, 34.0 34.0
XMD Date
Property Name Type Description Filter Group and Version Available Version
alias String The alias of the date column. Small, 34.0 34.0
compact Boolean Indicates whether the date is displayed as compact. Small, 34.0 34.0
description String The description of the date column. Small, 34.0 34.0
fields XMD Date Field Formatting information for the date fields. Small, 34.0 34.0
firstDayOfWeek Integer The first day of the week. Use 0 to set the first day to be Sunday, 1 to set the first day to be Monday, and so on. Small, 34.0 34.0
fiscalMonthOffset Integer The offset, in months, that the fiscal year differs from the calendar year. Represented as the month number - 1. For example, if the fiscal year starts in January, the offset is 0 (1 - 1). If the fiscal year starts in October, the offset is 9 (10 - 1). Small, 34.0 34.0
isYearEndFiscalYear Boolean Indicates whether the year end is based on the fiscal year. Small, 34.0 34.0
label String The label of the date column. Small, 34.0 34.0
showInExplorer Boolean Indicates whether the date is displayed in the explorer. Small, 34.0 34.0
XMD Date Field
Property Name Type Description Filter Group and Version Available Version
day String The day field. Small, 34.0 34.0
epochDay String The epoch day field. Small, 34.0 34.0
epochSecond String The epoch second field. Small, 34.0 34.0
fiscalMonth String The fiscal month field. Small, 34.0 34.0
fiscalQuarter String The fiscal quarter field. Small, 34.0 34.0
fiscalWeek String The fiscal week field. Small, 34.0 34.0
fiscalYear String The fiscal year field. Small, 34.0 34.0
fullField String The full-field field. Small, 34.0 34.0
hour String The hour field. Small, 34.0 34.0
minute String The minute field. Small, 34.0 34.0
month String The month field. Small, 34.0 34.0
quarter String The quarter field. Small, 34.0 34.0
second String The second field Small, 34.0 34.0
week String The week field. Small, 34.0 34.0
year String The year field. Small, 34.0 34.0
XMD Dimension
Property Name Type Description Filter Group and Version Available Version
customActions XMD Dimension Custom Action[] Custom actions linked to this dimension. Small, 34.0 34.0
customActionsEnabled Boolean Indicates whether the dimension has custom actions enabled. Small, 34.0 34.0
dateFormat String The format used for a date that is a dimension. Small, 34.0 34.0
description String The description of the dimension. Small, 34.0 34.0
field String The field name of the dimension (used in queries). Small, 34.0 34.0
fullyQualifiedName String The fully qualified name of the dimension. Small, 34.0 34.0
imageTemplate String The image template. Small, 34.0 34.0
isMultiValue Boolean Indicates whether the dimension is multi-value. Small, 34.0 34.0
label String The label for the dimension. Small, 34.0 34.0
linkTemplate String The template for formatting a link. Small, 34.0 34.0
linkTemplateEnabled Boolean Indicats whether the dimension has link templates enabled. Small, 34.0 34.0
linkTooltip String The tooltip to be displayed for links. Small, 34.0 34.0
members XMD Dimension Member[] The member overrides for a dimension. Small, 34.0 34.0
origin String The origin of this dimension. Small, 34.0 34.0
recordDisplayFields 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, 34.0 34.0
recordIdField String The record ID for this dimension. Small, 34.0 34.0
recordOrganizationIdField String The record organization ID for this dimension. Small, 34.0 34.0
salesforceActions XMD Dimension Salesforce Action[] Salesforce actions linked to this dimension. Small, 34.0 34.0
salesforceActionsEnabled Boolean Indicates whether the dimension has Salesforce actions enabled. Small, 34.0 34.0
showInExplorer Boolean Indicates whether the dimension is displayed in the explorer. Small, 34.0 34.0
XMD Dimension Custom Action
Property Name Type Description Filter Group and Version Available Version
enabled Boolean Indicates whether the action is enabled for a specific dimension. Small, 34.0 34.0
icon String The icon for the action. Small, 34.0 34.0
method String The method for the action. Small, 34.0 34.0
name String The name of the action. Small, 34.0 34.0
target String The target for the action. Small, 34.0 34.0
tooltip String The tooltip for the action. Small, 34.0 34.0
url String The URL for the action. Small, 34.0 34.0
XMD Dimension Member
Property Name Type Description Filter Group and Version Available Version
color String The color for the member. Small, 34.0 34.0
label String The label for the member. Small, 34.0 34.0
member String The member value. Small, 34.0 34.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, 34.0 34.0
name String The name of the action. Small, 34.0 34.0
XMD Measure
Property Name Type Description Filter Group and Version Available Version
dateFormat String The format used for a date that is a measure. Small, 34.0 34.0
description String The description of the measure. Small, 34.0 34.0
field String The field name of the measure (used in queries). Small, 34.0 34.0
format XMD Measure Format The format details for the measure. Small, 34.0 34.0
fullyQualifiedName String The fully qualified name of the measure. Small, 34.0 34.0
label String The label for the measure. Small, 34.0 34.0
origin String The origin of the measure. Small, 34.0 34.0
showInExplorer Boolean Indicates whether the measure is displayed in the explorer. Small, 34.0 34.0
XMD Measure Format
Property Name Type Description Filter Group and Version Available Version
decimalDigits Integer The number of digits displayed after the decimal place. Small, 34.0 34.0
negativeParentheses Boolean Indicates whether to display negative numbers with parentheses, rather than a minus sign. Small, 34.0 34.0
prefix String The prefix placed before the field value. Small, 34.0 34.0
suffix String The suffix placed after the field value. Small, 34.0 34.0
unit String The unit string for the measure. For example, 'cm'. Small, 34.0 34.0
unitMultiplier Double The multiplier for the unit. Small, 34.0 34.0
XMD Organization
Property Name Type Description Filter Group and Version Available Version
id String The ID of the organization. Small, 34.0 34.0
instanceUrl String The instance URL for the organization. Small, 34.0 34.0
label String The label for the organization. Small, 34.0 34.0
PUT Request Body
Property Name Type Description Required or Optional Available Version
dataset XMD Dataset Locale-specific information about the dataset represented by this XMD. 35.0
dates XMD Date[] A list of dates with formatting information. 35.0
derivedDimensions XMD Dimension[] A list of derived dimensions with formatting information. 35.0
derivedMeasures XMD Measure[] A list of derived measures with formatting information. 35.0
dimensions XMD Dimension[] A list of dimensions with formatting information. 35.0
measures XMD Measure[] A list of measures with formatting information. 35.0
organizations XMD Organization[] A list of organizations for multi-organization support. 35.0
showDetailsDefaultFields String[] An ordered list of dimensions and measures. The list defines the default order in which to show the dimensions and measures in the user interface. 35.0