Metadata Type: AnalyticsWorkspace
AnalyticsWorkspace is a metadata type in Salesforce (API v64.0+), representing a **Tableau Next analytics workspace**. It allows administrators to manage collections of Tableau Next assets—such as dashboards and visualizations—within a single namespace for deployment and version control.
Overview
The AnalyticsWorkspace metadata type supports the declaration, retrieval, deployment, and deletion of Tableau Next workspaces via the Metadata API. It acts as a container for related analytics assets, aligning with Salesforce’s integration of Tableau capabilities ()
Key Features
- Organizes multiple Tableau Next assets under one workspace
- Supports dashboards, visualizations, and other Tableau objects
- Facilitates Metadata API deployments and CI/CD workflows
- Enables consistent management of Tableau Next content across orgs ()
Structure and Components
An AnalyticsWorkspace metadata instance typically comprises:
- Workspace Name: Unique identifier for the workspace
- Assets: List of Tableau Next assets associated with this workspace
- Asset References: Metadata references to dashboards, visualizations, etc. (AnalyticsWorkspaceAsset)
Deployment Considerations
When deploying AnalyticsWorkspace metadata, note the following:
1. Asset Inclusion
Ensure all referenced Tableau Next assets are included in the deployment package—missing assets lead to errors ().
2. API Version
Use Metadata API v64.0 or higher to support Tableau Next workspace features and asset types ()
3. Permissions
User must have access to Tableau Next asset types and Metadata API operations.
4. Dependency Management
Deploy workspace and its associated assets together to ensure reference integrity.
Best Practices for Salesforce Administrators
1. Version Control Integration
Store workspace definitions and asset metadata in Git for auditability and rollback.
2. Modular Asset Bundles
Group related dashboards and assets within a workspace to simplify packaging and deployment.
3. Sandbox Validation
Test complete workspaces in sandbox to verify asset linkage and interactive behavior before rolling to production.
4. Document Asset Composition
Maintain documentation listing workspace assets, purpose, and usage context.
5. Stakeholder Collaboration
Coordinate with Tableau developers to ensure workspaces include all required visualizations and filters.
6. Regular Audits
Review workspaces periodically to remove stale assets and maintain relevance.
7. Monitor Deployment Status
Track deployment results and logs to ensure all workspace assets are successfully processed.
8. Access and Sharing Policies
Define and deploy appropriate sharing settings to ensure correct access to assets post-deployment.
9. Naming Standards
Use clear naming patterns for workspaces and grouped assets to improve manageability.
10. Provide Team Training
Ensure team members understand the concept of Tableau Next workspaces and how to maintain them effectively.
Conclusion
The AnalyticsWorkspace metadata type now supports Tableau Next assets, enabling robust, version‑controlled deployment of workspaces and their associated dashboards/visualizations. By following structured asset grouping, documentation, and testing practices, administrators can ensure a smooth and maintainable Tableau Next rollout within Salesforce.