Lenses List Resource

Returns a list of Analytics Cloud lenses (GET), or creates a lens (POST).

Resource URL

1/wave/lenses

Formats

JSON

Available Version

34.0

HTTP Methods

GET and POST

GET Request Parameters

Parameter Name	Type	Description	Required or Optional	Available Version
`folderId`	ID	Filters the results to include only the contents of a specific folder. Can be the requesting user’s ID for items in the user’s private folder.	Optional	34.0
`page`	String	A generated token that indicates the view of the lenses to be returned.	Optional	34.0
`pageSize`	Int	Number of items to be returned in a single page. Minimum is 1, maximum is 200, and default is 25.	Optional	34.0
`q`	String	Search terms. Individual terms are separated by spaces. Wild cards aren’t supported. For example, if you have lenses with the following names: Opportunities_Created_2010 Opportunities_Created_2011 Setting q = “Opportunities 2010” returns only Opportunities_Created_2010.	Optional	34.0
`sort`	String	Sort order of the results. Values are: `LastModified` `Mru`: Most recently used (last viewed date) `Name` The default is `Mru`.	Optional	34.0

GET Response Body

Property Name	Type	Description	Filter Group and Version	Available Version
`lenses`	Lens[]	List of lenses available to the current user.	Small, 34.0	34.0
`nextPageUrl`	String	The URL to retrieve the next page of contents in the collection.	Small, 34.0	34.0
`totalSize`	Integer	The total count of the elements in the collection, including all pages.	Medium, 34.0	34.0
`url`	String	The URL to retrieve the collection.	Small, 34.0	34.0

Example Response Body

1{
2  "lenses" : [ "/* Lenses detail omitted for brevity. */" ],
3  "nextPageUrl" : "/services/data/v34.0/wave/lenses?page=eyJwYWdlU2l6ZSI6MjUsInNv",
4  "totalSize" : 14,
5  "url" : "/services/data/v34.0/wave/lenses"
6}

Request Body (for POST and /wave/lenses/<lens ID> PATCH)

Property Name	Type	Description	Required or Optional	Available Version
`datasetId`	ID	The 18-character ID of the dataset to be used to create this lens.	Required for POST, optional for PATCH	34.0
`description`	String	The description of the lens.	Required for POST, optional for PATCH	34.0
`folderId`	ID	Filters the results to include only the contents of a specific folder. Can be the requesting user’s ID for items in the user’s private folder.	Required for POST, optional for PATCH	34.0
`label`	String	The label of the lens.	Required for POST, optional for PATCH	34.0
`name`	String	The name of the lens.	Required for POST, optional for PATCH	34.0
`state`	Lens State Input	The state of the lens.	Required for POST, optional for PATCH	34.0
`visualizationType`	String	The visualization type to be used for this lens. 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	Required for POST, optional for PATCH	34.0

Lens State Input

Property Name	Type	Description	Required or Optional	Available Version
`columns`	Column[]	A list of the columns for a comparison table lens.	Must be specified for comparison tables only.	34.0
`options`	Lens Visualization Options Input	The configuration options for different lens visualizations.	Optional	34.0
`query`	String	The SAQL query to be used to create this lens.	If using any visualization type other than comparison table, you are required to specify this property.	34.0

Lens Visualization Options Input

Property Name	Type	Description	Required or Optional	Available Version
`fit`	Boolean	Indicates whether to scale the position and size of data shape so that it is proportional to the percentage of its category. [DENISE: THIS ONE WAS A LITTLE AWKWARD, AND NOT SURE EXACTLY WHAT’S BEING SAID. HAVE A CLOSE LOOK]	Optional	34.0
`hideHeaderColumn`	Boolean	Indicates whether to display a header column.	Optional	34.0
`legend`	Boolean	Indicates whether to show a legend.	Optional	34.0
`legendHideHeader`	Boolean	Indicates whether to hide the legend header.	Optional	34.0
`legendWidth`	Integer	The width of the legend	Optional	34.0
`maxColumnWidth`	Integer	The maximum width of the header column.	Optional	34.0
`minColumnWidth`	Integer	The minimum width of the header column.	Optional	34.0
`miniBars`	Integer	The width of the mini-bars, if used.	Optional	34.0
`multiMetrics`	Boolean	When true, indicates that multiple measures are displayed on the same chart, side-by-side. When `false`, each measure is displayed on a separate chart. The default is `false`.	Optional	34.0
`normalize`	Boolean	Scale the position and size of the data shape so that it’s proportional to the percentage of its category.[AGAIN, HAVE A CLOSE LOOK]	Optional	34.0
`splitAxis`	Boolean	When `true`, each measure is projected onto one axis. When `false`, all measures use the same axis.	Optional	34.0
`sqrt`	Boolean	Indicates that the horizontal and vertical axes use a square root scale.	Optional	34.0
`totals`	Boolean	Indicates whether to display totals in the table.	Optional	34.0
`trellis`	Boolean	When `true`, the last group is treated as a trellis dimension. Every distinct value of the dimension is a chart.	Optional	34.0

POST Response Body

Lens

Wave REST API Developer's Guide (Pilot)

Lenses List Resource