Wave REST API Developer Guide

Working with the Wave REST API
Wave REST API Reference
Wave REST API Resources Overview
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
Lens File Metadata Resource
Dashboards List Resource
Dashboard Resource
Dependencies Resource
Features Configuration Resource
Folders List Resource
Folder Resource
Templates List Resource
Templates Resource
Templates Configuration Resource
Annotations List Resource
Annotation Resource
Template Release Notes 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).
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
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
dataset XMD Dataset Locale-specific information about the dataset represented by this XMD. 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 Dataset
Property Name Type Description Filter Group and Version Available Version
connector String The connector source for the dataset. Small, 36.0 36.0
description String The description of the dataset. Small, 36.0 36.0
fully​Qualified​Name String The fully qualified name of the dataset version. Small, 36.0 36.0
origin String The origin of the dataset version. Small, 36.0 36.0
XMD Date
Property Name Type Description Filter Group and Version Available Version
alias String The alias of the date column. Small, 36.0 36.0
compact Boolean Indicates whether the date is displayed as compact. Small, 36.0 36.0
description String The description of the date column. Small, 36.0 36.0
fields XMD Date Field Formatting information for the date fields. Small, 36.0 36.0
first​Day​Of​Week 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, 36.0 36.0
fiscal​Month​Offset 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, 36.0 36.0
is​Year​End​Fiscal​Year Boolean Indicates whether the year end is based on the fiscal year. Small, 36.0 36.0
label String The label of the date column. Small, 36.0 36.0
show​In​Explorer Boolean Indicates whether the date is displayed in the explorer. 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
custom​Actions XMD Dimension Custom Action[] Custom actions linked to this dimension. Small, 36.0 36.0
custom​Actions​Enabled Boolean Indicates whether the dimension has custom actions enabled. Small, 36.0 36.0
date​Format String The format used for a date that is a dimension. Small, 36.0 36.0
description String The description of the dimension. Small, 36.0 36.0
field String The field name of the dimension (used in queries). Small, 36.0 36.0
fully​Qualified​Name String The fully qualified name of the dimension. Small, 36.0 36.0
image​Template String The image template. Small, 36.0 36.0
is​Multi​Value Boolean Indicates whether the dimension is multi-value. 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
origin String The origin of this 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 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, 36.0 36.0
icon String The icon for the action. Small, 36.0 36.0
method String The method for the action. Small, 36.0 36.0
name String The name of the action. Small, 36.0 36.0
target String The target for the action. Small, 36.0 36.0
tooltip String The tooltip for the action. Small, 36.0 36.0
url String The URL for the action. 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
date​Format String The format used for a date that is a measure. Small, 36.0 36.0
description String The description of the measure. Small, 36.0 36.0
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
fully​Qualified​Name String The fully qualified name of the measure. Small, 36.0 36.0
label String The label for the measure. Small, 36.0 36.0
origin String The origin of 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
decimal​Digits Integer The number of digits displayed after the decimal place. Small, 36.0 36.0
negative​Parentheses Boolean Indicates whether to display negative numbers with parentheses, rather than a minus sign. Small, 36.0 36.0
prefix String The prefix placed before the field value. Small, 36.0 36.0
suffix String The suffix placed after the field value. Small, 36.0 36.0
unit String The unit string for the measure. For example, 'cm'. 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