--- schema_version: "1" id: 4843ac4576340302557b5090919c0c07aee8c14da0971ddecdb5f2993835dfdf title: WaveLens collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_wavelens.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_wavelens.htm source_site: developer.salesforce.com content_type: documentation content_hash: 71802bccf1f7c247651f8a84c090643eda03008bb94858c2a5c3de958e7bbe5d description: Represents the WaveLens object in the Analytics application. --- # WaveLens Represents the WaveLens object in the Analytics application. This type extends to [MetadataWithContent](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_metadatawithcontent.htm "MetadataWithContent is the base type for all metadata types that contain content, such as documents or email templates. It extends Metadata. You can’t edit this object.") metadata type and inherits its content and fullName fields. When using Metadata API to work with Analytics lenses, consider that: - If a lens is archived (moved to the Recycle Bin), retrieving it doesn't return its metadata. Deploying changes to an archived lens fails with an error stating that the lens is in the Recycle Bin. ![Important](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/images/icon_note_important.png) #### Important 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. ## 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. dev\_\_app dev\_\_abc lens1 lens in shared app hbar ## 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](https://developer.salesforce.com/docs/atlas.en-us.264.0.api_meta.meta/api_meta/file_based_zip_file.htm).