AnalyticsVisualization

Represents a Tableau Next visualization.

Parent Type

This type extends the Metadata 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[]
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[]
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[]
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[]
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
adHoCalc
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.
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.

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

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.