Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

WaveLens

Represents the WaveLens object in the Analytics application.

This type extends to MetadataWithContent metadata type and inherits its content and fullName fields.

Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.

Important

File Suffix and Directory Location

WaveLens components have the suffix .wlens and are stored in the wave folder.

Version

WaveLens components are available in API version 37.0 and later.

Fields

Field Name	Field Type	Description
application	string	Required. The internal name of the application.
datasets	string	A reference to the dataset used to create this lens.
dateVersion	int	The date version used for this lens.
description	string	The dashboard description that appears in the user interface.
masterLabel	string	Required. The user interface label name of the dashboard.
templateAssetSourceName	string	Links the lens to the template used to create it. Null for assets not created from a template.
visualizationType	string	Required. The visualization type to be used for this lens. Valid values are: `calheatmap`—Calendar heat map `comparisontable`—Comparison table `heatmap`—Heat map `hbar`—Horizontal bar `hbarhdot`—Horizontal dot plot `matrix`—Matrix `parallelcoords`—Parallel coordinates `pie`—Donut `pivottable`—Pivot table `scatter`—Scatter plot `stackhbar`—Stacked horizontal bar `stackvbar`—Stacked vertical bar `time`—Time line `valuestable`—Values table `vbar`—Vertical bar `vdot`—Vertical dot plot

Declarative Metadata Sample Definition

The following is an example of a WaveLens component.

1<?xml version="1.0" encoding="UTF-8"?>
2<WaveLens xmlns="http://soap.sforce.com/2006/04/metadata" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
3  <content xsi:nil="true"/>
4  <application>dev__app</application>
5  <datasets>dev__abc</datasets>
6  <masterLabel>lens1</masterLabel>
7  <description>lens in shared app</description>
8  <visualizationType>hbar</visualizationType>
9</WaveLens>

Wildcard Support in the Manifest File

This metadata type supports the wildcard character * (asterisk) in the package.xml manifest file. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.

Metadata API Developer Guide