From ef48a44eb26c4f123f68aa93fa635a95ca839331 Mon Sep 17 00:00:00 2001 From: Dan Zucker Date: Mon, 19 Oct 2026 15:19:05 -0700 Subject: [PATCH] docs: correct Data Apps beta review feedback Italicize the Cloud-only notice, fix overview wording, and point getting started at Tableau MCP instead of per-endpoint admin setup. --- ...t-this-trex_dataapp_getstarted_extension_packaging.md | 2 +- website/docs/dataapps/index.md | 2 +- website/docs/dataapps/trex_dataapp_admin_security.md | 2 +- website/docs/dataapps/trex_dataapp_details.md | 2 +- website/docs/dataapps/trex_dataapp_examples.md | 4 +++- website/docs/dataapps/trex_dataapp_getstarted.md | 6 +++--- website/docs/dataapps/trex_dataapp_manage.md | 2 +- website/docs/dataapps/trex_dataapp_overview.md | 9 ++++----- website/docs/dataapps/trex_dataapp_security.md | 2 +- 9 files changed, 16 insertions(+), 15 deletions(-) diff --git a/website/docs/dataapps/delet-this-trex_dataapp_getstarted_extension_packaging.md b/website/docs/dataapps/delet-this-trex_dataapp_getstarted_extension_packaging.md index 09a68521..7bf86b51 100644 --- a/website/docs/dataapps/delet-this-trex_dataapp_getstarted_extension_packaging.md +++ b/website/docs/dataapps/delet-this-trex_dataapp_getstarted_extension_packaging.md @@ -4,7 +4,7 @@ description: Package and publish a working Viz or Dashboard Extension as a Table tags: [Getting started] --- -The data apps beta is available only on Tableau Cloud. +_The data apps beta is available only on Tableau Cloud._ Start with a working Viz or Dashboard Extension. To create one, follow [Get Started with Viz Extensions](../vizext/trex_viz_getstarted.md) or [Get Started with Dashboard Extensions](../dashext/trex_getstarted.md). diff --git a/website/docs/dataapps/index.md b/website/docs/dataapps/index.md index 7ee1b70f..fda6afbd 100644 --- a/website/docs/dataapps/index.md +++ b/website/docs/dataapps/index.md @@ -1,6 +1,6 @@ # (Cloud-only Beta) Data Apps -The data apps beta is available only on Tableau Cloud. +_The data apps beta is available only on Tableau Cloud._ Build custom analytical applications on governed Tableau data and share them through Tableau. A data app combines a custom web interface with Tableau data access and hosting. Its front-end resources are embedded in a packaged workbook and served by Tableau. Start with the overview to understand the concepts, then follow the getting started and creation guides. diff --git a/website/docs/dataapps/trex_dataapp_admin_security.md b/website/docs/dataapps/trex_dataapp_admin_security.md index e3598aeb..c3a4e5a0 100644 --- a/website/docs/dataapps/trex_dataapp_admin_security.md +++ b/website/docs/dataapps/trex_dataapp_admin_security.md @@ -4,7 +4,7 @@ description: Find administration and security guidance for Tableau data apps. sidebar_label: Administration and Security --- -The data apps beta is available only on Tableau Cloud. +_The data apps beta is available only on Tableau Cloud._ Administration and security guidance is available on two pages: diff --git a/website/docs/dataapps/trex_dataapp_details.md b/website/docs/dataapps/trex_dataapp_details.md index 1c7049b1..a7a56def 100644 --- a/website/docs/dataapps/trex_dataapp_details.md +++ b/website/docs/dataapps/trex_dataapp_details.md @@ -3,7 +3,7 @@ title: Data App Details description: The workbook, manifests, web resources, data connections, and runtime access that make up a Tableau data app. --- -The data apps beta is available only on Tableau Cloud. +_The data apps beta is available only on Tableau Cloud._ A data app is a Dashboard or Viz Extension whose web resources are packaged with a Tableau workbook. The workbook places the interface and connects its data sources; the package supplies its manifests and front-end code. Tableau serves the bundled resources when a viewer opens the published workbook. Application code runs in the viewer's browser and queries Tableau at runtime. diff --git a/website/docs/dataapps/trex_dataapp_examples.md b/website/docs/dataapps/trex_dataapp_examples.md index fd72b204..e7267007 100644 --- a/website/docs/dataapps/trex_dataapp_examples.md +++ b/website/docs/dataapps/trex_dataapp_examples.md @@ -3,7 +3,7 @@ title: Data App Samples description: Explore application ideas and extension samples to learn patterns for Tableau data apps. --- -The data apps beta is available only on Tableau Cloud. +_The data apps beta is available only on Tableau Cloud._ Start with a small application and inspect how it loads resources, initializes the Extensions API, and gets data. Then add the interactions needed for your users' workflow. @@ -21,6 +21,8 @@ These scenarios illustrate design patterns; they are not downloadable data app s ## Learn from Dashboard and Viz Extension samples + + The existing Extensions API samples demonstrate useful patterns for data access, filtering, parameters, and event handling: - [Dashboard Extension Samples](../dashext/trex_examples.md) show applications that interact with dashboard content. diff --git a/website/docs/dataapps/trex_dataapp_getstarted.md b/website/docs/dataapps/trex_dataapp_getstarted.md index a5a920b1..6126b0d5 100644 --- a/website/docs/dataapps/trex_dataapp_getstarted.md +++ b/website/docs/dataapps/trex_dataapp_getstarted.md @@ -6,7 +6,7 @@ tags: [Getting started] _The data apps beta is available only on Tableau Cloud._ -Create a data app by describing what you want to an AI coding assistant. You provide details like the audience, questions, data source, interactions, and visual style. The assistant uses Tableau MCP and the Tableau plugin to connect your data, write the application, and package and publish it to Tableau Cloud. You review the app in Tableau and refine it through conversation. +You can create a data app by describing what you want to an AI coding assistant. You provide details like the audience, questions, data source, interactions, and visual style. The assistant uses [Tableau MCP](https://tableau.github.io/tableau-mcp/docs/getting-started) and the [Tableau plugin](https://github.com/tableau/tableau-plugin) to connect your data, write the application, and package and publish it to Tableau Cloud. You review the app in Tableau and refine it through conversation. A data app combines a custom web interface with Tableau data access and hosting. For more about how it works, see [What are Tableau data apps?](./trex_dataapp_overview.md). @@ -17,11 +17,11 @@ You need: - Access to a Tableau Cloud site that supports the data apps beta. - A **Creator** or **Explorer (can publish)** site role and permission to publish to your intended destination. - A published Tableau data source that you can access. Have its name or link ready. -- An AI client that supports MCP connections, the Tableau plugin, and code execution. The assistant needs to work with local files and run the plugin's scripts. +- An AI client that supports [Tableau MCP](https://tableau.github.io/tableau-mcp/docs/getting-started) connections, the [Tableau plugin](https://github.com/tableau/tableau-plugin), and code execution. The assistant needs to work with local files and run the plugin's scripts. :::note -Your data app will often make Tableau service API calls to read and modify data and metadata. Your site administrator needs to enable access to each endpoint called for the data app. You may need to prompt your AI coding assistant to list the methods and paths used by the data app and make a request to your administrator. +If you're using Tableau's hosted MCP server, make sure your agent has network egress access to the blob storage that Tableau MCP uses to temporarily store workbook files. For more information, see [Hosted Tableau MCP](https://tableau.github.io/tableau-mcp/docs/hosted-tableau-mcp). ::: diff --git a/website/docs/dataapps/trex_dataapp_manage.md b/website/docs/dataapps/trex_dataapp_manage.md index 4b74339d..084de6de 100644 --- a/website/docs/dataapps/trex_dataapp_manage.md +++ b/website/docs/dataapps/trex_dataapp_manage.md @@ -3,7 +3,7 @@ title: Manage Data Apps description: Configure data apps for a Tableau Cloud site and manage individual packages in site Settings. --- -The data apps beta is available only on Tableau Cloud. +_The data apps beta is available only on Tableau Cloud._ As a site administrator, you manage data apps through the **Packages** tab on the site's **Settings** page. Data app enablement is configured **per site**. Review and configure these controls for each site where you want users to run data apps. diff --git a/website/docs/dataapps/trex_dataapp_overview.md b/website/docs/dataapps/trex_dataapp_overview.md index d34f4506..b7313945 100644 --- a/website/docs/dataapps/trex_dataapp_overview.md +++ b/website/docs/dataapps/trex_dataapp_overview.md @@ -3,11 +3,11 @@ title: What are Tableau Data Apps? description: Learn how Data Apps combine custom web applications with Tableau hosting and governed data. --- -The data Apps beta is available only on Tableau Cloud. +_The data Apps beta is available only on Tableau Cloud._ -A **data app** is a purpose-built interactive application built with code to help users explore data, make a decision, or complete a workflow. A data App gives your custom viz or dashboard extension runtime access to governed Tableau data sources through Extensions API and Tableau REST API methods. +A **data app** is a purpose-built, interactive application built with code to help users explore data, make a decision, or complete a workflow. A data App gives your custom viz or dashboard extension runtime access to governed Tableau data sources through Extensions API and Tableau REST API methods. -Data apps also host your extension's web resources on Tableau service. You build the interface using the Tableau Extensions API and bundle its HTML, JavaScript, CSS, and images inside a packaged workbook (`.twbx`). These resources are embedded in the workbook and published with it. Tableau hosts and serves them when users open the published content, so you do not need a separate web server for the app's front end. +Data apps also host your extension's web resources on Tableau. You build the interface using the Tableau Extensions API and bundle its HTML, JavaScript, CSS, and images inside a packaged workbook (`.twbx`). These resources are embedded in the workbook and published with it. Tableau hosts and serves them when users open the published content, so you do not need a separate web server for the app's front end. Your data app appears as a workbook in the Tableau Interface. A workbook can contain more than one data app. @@ -26,7 +26,7 @@ A data app includes: - The Tableau Extensions API JavaScript library, which connects the application to Tableau. - A package that contains the extension and its resources, bundled with the workbook. -A Tableau Package (`.tpkg`) is a container for application resources and metadata. The package supplies the resources; the data dpp combines them with Tableau data to provide the user experience. +A Tableau Package (`.tpkg`) is a container for application resources and metadata. The package supplies the resources; the data app combines them with Tableau data to provide the user experience. ## What can you do with a Data App? @@ -60,7 +60,6 @@ To create a data app, you need: - At least Creator or Explorer (can publish) role for the site containing the data app - Publish and Overwrite (to republish) access to the project for the data app - View, Connect and API access to each published data source the data app uses -- Administrator site configuration allowing any Tableau REST API paths/methods the data app calls ## How do Data Apps differ from Dashboard and Viz Extensions? diff --git a/website/docs/dataapps/trex_dataapp_security.md b/website/docs/dataapps/trex_dataapp_security.md index 421c2ca2..91254f74 100644 --- a/website/docs/dataapps/trex_dataapp_security.md +++ b/website/docs/dataapps/trex_dataapp_security.md @@ -3,7 +3,7 @@ title: Data App security description: Understand data app data permissions, hosted resources, external origins, and Tableau API access. --- -The data apps beta is available only on Tableau Cloud. +_The data apps beta is available only on Tableau Cloud._ Data apps execute custom code in the viewer's browser and query Tableau data at runtime. Review both the code and the access it requires before publishing. Tableau hosting and data permissions provide controls for the app, but app owners still need to review dependencies and how data is used.