---
schema_version: "1"
id: 43173570e31f812269daf6eadff6c0ea39e3c7729e2322cbcd98e5e781c519fb
title: AnalyticsVisualization
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_analyticsvisualization.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_analyticsvisualization.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 165e51de50c3ba023b82ebb9b255422ac83fcc93b5d6da40ba3384b7ff400e11
description: Represents a Tableau Next visualization.
---
# AnalyticsVisualization

Represents a Tableau Next visualization.

## Parent Type

This type extends the [Metadata](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/metadata.htm "The base class for all metadata types. You can’t edit this object. A component is an instance of a metadata type.") metadata type and inherits its fullName field.

## File Suffix and Directory Location

AnalyticsVisualization components have the suffix .uaviz and are stored in the analyticsVisualizations folder.

## Version

AnalyticsVisualization components are available in API version 64.0 and later.

## Limits

| Definition | Limit |
| --- | --- |
| The maximum number of AnalyticsVisualization components in a single deploy operation. | 50 |
| The maximum number of AnalyticsVisualization components in a single retrieve operation. | 100 |
| The maximum number of AnalyticsVisualization components across all deploy operations in a 24-hour window. | 100 |
| The maximum number of AnalyticsVisualization components across all retrieve operations in a 24-hour window. | 200 |

## Fields

| Field Name | Description |
| --- | --- |
| actions | 
Field Type

[AnalyticsAssetAction\[\]](meta_analyticsdashboard.htm#AnalyticsAssetAction)

Description

The actions for the visualization. A visualization has 0 or more actions.



 |
| analyticsWorkspace | 

Field Type

string

Description

Required.

The Tableau Next workspace the visualization belongs to.



 |
| creationSource | 

Field Type

string

Description

The creation source for the visualization.



 |
| dataSource | 

Field Type

string

Description

Required.

The data source for the visualization.



 |
| description | 

Field Type

string

Description

The description for the visualization.



 |
| fields | 

Field Type

[AnalyticsVizField\[\]](#AnalyticsVizField)

Description

A list of data fields for the visualization. A visualization has 0 or more fields.



 |
| lastDraftModifiedDate | 

Field Type

dateTime

Description

The date and time the workspace draft was last modified.



 |
| lastPublishedDate | 

Field Type

dateTime

Description

The date and time the workspace was last published.



 |
| masterLabel | 

Field Type

string

Description

Required.

The name of the visualization.



 |
| templateAssetSourceName | 

Field Type

string

Description

If the visualization was created from a template, the name of the source visualization in the template.



 |
| templateSource | 

Field Type

string

Description

If the visualization was created from a template, the name of the source template.



 |
| version | 

Field Type

double

Description

The API version of the visualization.



 |
| views | 

Field Type

[AnalyticsVizViewDef\[\]](#AnalyticsVizViewDef)

Description

A list of views for the visualization. A visualization has 0 or more views.



 |
| visualSpecification | 

Field Type

base64Binary

Description

Required.

The visual specification for the visualization.



 |
| workspaceAssetRelationships | 

Field Type

[AnalyticsWorkspaceAsset\[\]](meta_analyticsworkspace.htm#AnalyticsWorkspaceAsset)

Description

A list of analytics assets in the workspace this visualization is associated with. A visualization has 0 or more workspace asset relationships.



 |

## AnalyticsVizField

Represents a data field in a visualization.

| Field Name | Description |
| --- | --- |
| adHocCalc | 
Field Type

string

Description

The expression to do an ad-hoc calculation with.



 |
| analyticsVizVersion | 

Field Type

string

Description

The version of the visualization the field is associated with.



 |
| computeUsing | 

Field Type

string

Description

The expression to compute the field value with.



 |
| displayCategory | 

Field Type

VisualizationFieldDisplayCategoryType (enumeration of type string)

Description

The display category type for the visualization field.

Values are:

- Continuous
- Discrete





 |
| fieldKey | 

Field Type

string

Description

Required.

The key for the field.



 |
| fieldName | 

Field Type

string

Description

The name of the field.



 |
| function | 

Field Type

VisualizationFieldFunctionType (enumeration of type string)

Description

The function type of the visualization field.

Values are:

- Attr
- Avg
- Count
- CountD
- DatePartDay
- DatePartHour
- DatePartMinute
- DatePartMonth
- DatePartQuarter
- DatePartSecond
- DatePartWeek
- DatePartWeekDay
- DatePartYear
- DateTruncDay
- DateTruncHour
- DateTruncMinute
- DateTruncMonth
- DateTruncQuarter
- DateTruncSecond
- DateTruncWeek
- DateTruncYear
- FiscalDatePartMonth
- FiscalDatePartQuarter
- FiscalDatePartWeek
- FiscalDatePartYear
- FiscalDateTruncMonth
- FiscalDateTruncQuarter
- FiscalDateTruncWeek
- FiscalDateTruncYear
- Max
- Mdy
- Median
- Min
- My
- Stdev
- Stdevp
- Sum
- UserAgg
- Var
- Varp





 |
| hierarchyName | 

Field Type

string

Description

The hierarchy name for the field.



 |
| hierarchyLevel | 

Field Type

integer

Description

The hierarchy level for the field.



 |
| label | 

Field Type

string

Description

The label for the field.



 |
| latitudeOrY | 

Field Type

string

Description

The latitude or Y value for the field.



 |
| longitudeOrX | 

Field Type

string

Description

The longitude or X value for the field.



 |
| objectName | 

Field Type

string

Description

The name of the data source object for the field.



 |
| positionName | 

Field Type

string

Description

The position name for the field.



 |
| positional | 

Field Type

base64binary

Description

The positional data for the field.

REMOVED in v68.0.





 |
| quickTableCalc | 

Field Type

string

Description

The expression to do a quick table calculation with.



 |
| role | 

Field Type

VisualizationFieldRoleType (enumeration of type string)

Description

The role type of the visualization field.

Values are:

- Dimension
- Measure





 |
| type | 

Field Type

VisualizationFieldType (enumeration of type string)

Description

The type of the visualization field.

Values are:

- Field
- MapPosition
- MeasureNames
- MeasureValues





 |

## AnalyticsVizViewDef

Represents a view definition for a Tableau Next visualization.

| Field Name | Description |
| --- | --- |
| analyticsVizVersion | 
Field Type

string

Description

The version of the visualization the view is associated with.



 |
| fullName | 

Field Type

string

Description

Required.

The full name of the view definition.



 |
| isOriginal | 

Field Type

boolean

Description

Required.

Indicates whether the view is original (true) or not (false).



 |
| masterLabel | 

Field Type

string

Description

Required.

The name of the view definition.



 |
| version | 

Field Type

double

Description

The API version of the visualization view.



 |
| viewSpecification | 

Field Type

string

Description

The specification for the view definition.



 |

## Declarative Metadata Sample Definition

The following is an example of an AnalyticsVisualization component.

<?xml version="1.0" encoding="UTF-8"?>
<AnalyticsVisualization xmlns="http://soap.sforce.com/2006/04/metadata" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <analyticsWorkspace\>My\_Workspace</analyticsWorkspace\>
  <description\>A visualization</description\>
  <dataSource\>My\_Semantic\_Model</dataSource\>
  <fields\>
    <displayCategory\>Discrete</displayCategory\>
    <fieldKey\>Field1</fieldKey\>
    <fieldName\>Lead\_Source18</fieldName\>
    <objectName\>Opportunity\_Home</objectName\>
    <role\>Dimension</role\>
     <type\>Field</type\>
  </fields\>
  <fields\>
    <fieldKey\>Field2</fieldKey\>
    <displayCategory\>Continuous</displayCategory\>
    <fieldName\>Amount</fieldName\>
    <function\>Sum</function\>
    <objectName\>Opportunity\_Home</objectName\>
    <role\>Measure</role\>
    <type\>Field</type\>
  </fields\>
  <views\>
    <fullName\>default</fullName\>
    <masterLabel\>My\_Visualization\_default</masterLabel\>
    <viewSpecification\>
      {&quot;filters&quot;:\[{&quot;fieldKey&quot;:&quot;Field1&quot;,&quot;filterInfos&quot;:\[{&quot;isCustom&quot;:false,&quot;isExcludes&quot;:false,&quot;type&quot;:&quot;In&quot;,&quot;useAll&quot;:false,&quot;values&quot;:\[&quot;NewBusiness&quot;\]},{&quot;includeAllValuesWhenEmpty&quot;:true,&quot;isExcludes&quot;:false,&quot;operator&quot;:&quot;Contains&quot;,&quot;type&quot;:&quot;WildCard&quot;,&quot;value&quot;:&quot;&quot;}\],&quot;isContext&quot;:false}\],&quot;sorts&quot;:\[{&quot;byField&quot;:&quot;Field2&quot;,&quot;fieldKey&quot;:&quot;Field1&quot;,&quot;order&quot;:&quot;Ascending&quot;,&quot;type&quot;:&quot;Nested&quot;}\]}</viewSpecification\>
    <isOriginal\>true</isOriginal\>
  </views\>
  <masterLabel\>My\_Visualization</masterLabel\>
  <version\>64.0</version\>
  <templateSource\></templateSource\>
  <templateAssetSourceName\></templateAssetSourceName\>
  <workspaceAssetRelationships\>
    <asset xsi:nil="true"/>
    <assetType\>AnalyticVisualization</assetType\>
    <assetUsageType\>Created</assetUsageType\>
    <workspace\>My\_Workspace</workspace\>
  </workspaceAssetRelationships\>
</AnalyticsVisualization\>

The following is an example package.xml that references the metadata definition.

<?xml version="1.0" encoding="UTF-8"?>
	<Package xmlns="http://soap.sforce.com/2006/04/metadata">
	<types\>
	<members\>My\_Visualization</members\>
	<name\>AnalyticsVisualization</name\>
	</types\>
	<version\>64.0</version\>
</Package\>

## 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.api_meta.meta/api_meta/file_based_zip_file.htm "The deploy() and retrieve() calls are used to deploy and retrieve a .zip file. Within the .zip file is a project manifest (package.xml) that lists what to retrieve or deploy, and one or more XML components that are organized into folders.").