---
schema_version: "1"
id: 1e52ca69ae18f3df3064e4179906ce142d851e039e6a514aab188bf993b87d0b
title: 使用仪表板扩展程序
collection: tableau
version: next
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/next/zh-cn/server/dashboard_extensions.md
canonical_url: https://help.tableau.com/v0.0/server/zh-cn/dashboard_extensions.htm
source_site: help.tableau.com
content_type: documentation
content_hash: b3eb115585270eeb03df2284e4fb12196eb8feff6489599ca5a0032ad60db5b3
description: Add and configure dashboard extensions to expand dashboards with third-party web applications.
---
[跳转到主要内容](#main-content)

# 使用仪表板扩展程序

扩展程序使您能向仪表板中添加独特的功能，或直接将它们与 Tableau 外部的应用程序集成。添加扩展程序很容易；只需像加入其他仪表板对象一样将它们加入仪表板布局即可。

借助第三方开发者创建的 Web 应用程序的帮助，扩展程序可以扩展仪表板的功能。如果您是开发者，并且想要创建自己的扩展程序，请参见 GitHub 上的 [Tableau Extensions API 文档](https://tableau.github.io/extensions-api/)。

**注意**：Tableau 管理员可为 [Tableau Desktop](https://help.tableau.com/current/desktopdeploy/zh-cn/desktop_deploy_setting_changes.htm#dashboard_extensions)、[Tableau Server](https://help.tableau.com/current/server/zh-cn/dashboard_extensions_server.htm) 和 [Tableau Cloud](https://help.tableau.com/current/online/zh-cn/dashboard_extensions_server.htm) 关闭仪表板扩展程序。

## 向仪表板中添加扩展程序

1. 在 Tableau 工作簿中，打开一个仪表板工作表。
2. 从“对象”部分将“扩展程序”拖到仪表板中。
    
    ![显示如何向仪表板添加扩展程序的箭头。](/tableau/next/zh-cn/server/zh-cn/Img/dashboard_extension_add.png)
3. 在“添加扩展程序”对话框中，执行以下任一操作：
    
    - 搜索和选择应用程序。
    - 单击“访问本地扩展程序”，并导航到之前下载的 .trex 文件。
4. 如果出现提示，请允许或拒绝仪表板扩展程序访问工作簿中的数据。有关详细信息，请参见[数据安全扩展程序、Tableau 可信扩展程序和支持网络的扩展程序](#Data)。
    
    如果您允许访问，请按照屏幕上任何说明进行操作来配置扩展程序。
    
    **注意：**如果您使用的是 Tableau Server 或 Tableau Cloud，在打印件、PDF 和仪表板的图像（包括订阅电子邮件中的图像）中，扩展程序对象将显示为空白。

### 配置仪表板扩展程序

某些仪表板扩展程序提供配置选项，使您能自定义功能。

1. 在仪表板中选择扩展程序，并从右上角的下拉菜单中选择“配置”。
2. 按照屏幕上的说明进行操作来配置扩展程序。
    
    ![用于在仪表板上配置扩展程序的上下文菜单。](/tableau/next/zh-cn/server/zh-cn/Img/dashboard_extension_configure.png)

### 重新加载仪表板扩展程序

如果仪表板扩展程序失去响应，您可能需要重新加载扩展程序，这类似于在浏览器中刷新网页。

1. 在仪表板中选择扩展程序，并从右上角的下拉菜单中选择“重新加载”。
    
    仪表板扩展程序将刷新，并会设置为其原始状态。
2. 如果重新加载扩展程序未能将其恢复到可用状态，请尝试从仪表板中将其移除，并再次添加。

## 数据安全扩展程序、Tableau 可信扩展程序和支持网络的扩展程序

扩展程序是采用两种标准的 Web 应用程序：

- _Tableau 可信扩展程序_已由 Tableau 管理的主机专门审查并部署在其中。其中包括由 Tableau 开发和管理的扩展程序、由 Tableau Exchange 合作伙伴构建并使用 Tableau 的扩展程序审查和主机服务部署的扩展程序，以及我们旧版沙盒化扩展程序主机内的扩展程序。
- _支持网络的扩展程序_由第三方主机托管。这些扩展程序允许开发人员管理其扩展程序的交付，而无需 Tableau 的中介。其中包括合作伙伴直接管理以提供更好的生产支持的扩展程序、在您的本地网络中托管和部署的扩展程序，以及需要与 Tableau 外部的第三方服务通信的扩展程序。

在您允许支持网络的扩展程序之前，请确保您信任开发人员和托管扩展程序的网站。

默认情况下，扩展程序使用 HTTPS 协议，该协议可保障一条用于发送和接收数据的加密通道，并确保一定的隐私性和安全性。有关使用仪表板扩展程序时的数据安全性的详细信息，请参见[扩展程序安全性 - 部署最佳做法](https://help.tableau.com/current/server/zh-cn/security_extensions.htm)。

### 允许或拒绝支持网络的扩展程序

默认情况下，支持网络的扩展程序必须请求运行权限。此权限对话框将提供有关从中托管它的第三方服务器的信息，以及扩展程序所需的数据访问级别。我们建议您在允许运行扩展程序之前查看此信息。

扩展程序通常访问视图中的可见数据。当扩展程序请求“完整数据访问权限”时，它可能会请求工作簿中的更深层次的数据访问权限。这可能包括访问完整的基础数据、数据源中的表和字段名称，以及有关数据源连接的信息。在允许扩展程序在工作簿中运行之前，您应查看扩展程序权限对话框中声明的信息，并决定是要允许还是拒绝扩展程序运行和访问此数据。

如果您要查看的仪表板包含需要完整数据访问权限的扩展程序，而该访问权限被拒绝，则会出现一条消息，而不是扩展程序。如果您信任扩展程序并且想要使用它，您可以重置权限并允许扩展程序运行。

![用于重置仪表板上的扩展程序的上下文菜单。](/tableau/next/zh-cn/server/zh-cn/Img/dashboard_extension_reset_perms.png)

1. 在仪表板中选择扩展程序，并从右上角的下拉菜单中选择“重置权限”。
2. 单击“允许”以允许扩展程序运行和访问数据，或单击“拒绝”阻止扩展程序运行。

### 确保在 Tableau Desktop 中启用了 JavaScript

仪表板扩展程序使用 Tableau Extensions API 库（一个 JavaScript 库）与数据交互。如果要使用扩展程序，请确保在仪表板安全设置中启用了 JavaScript：

选择“帮助”\>“设置和性能”\>“设置仪表板 Web 视图安全性”\>“启用 JavaScript”。

## 确保扩展程序在 Tableau Cloud 或 Tableau Server 上运行

您可以将扩展程序添加到从 Tableau Desktop 中发布的工作簿，或直接在 Tableau Cloud 和 Tableau Server 的 Web 制作模式下添加。Tableau 管理员必须允许扩展程序在站点上运行，并将支持网络的扩展程序添加到安全列表。管理员只应允许您测试过并信任的扩展程序。

如果要在 Tableau Cloud 或 Tableau Server 中使用仪表板扩展程序，请指引您的管理员阅读[在 Tableau Cloud 中管理仪表板扩展程序](https://help.tableau.com/current/online/zh-cn/dashboard_extensions_server.htm)或[在 Tableau Server 中管理仪表板扩展程序](https://help.tableau.com/current/server/zh-cn/dashboard_extensions_server.htm)。

### 确保扩展程序具有访问工作簿或视图的权限

如果发布包含扩展程序的工作簿，请确保扩展程序能够访问视图中的可见数据。可见数据也称为摘要数据。若要在 Tableau Server 或 Tableau Cloud 上授予此访问权限，请确保工作簿或视图允许“下载摘要数据”的权限。扩展程序不会下载您的数据。扩展程序只需要权限，就可以与视图中的数据交互。

根据您在发布工作簿时是否选择了将工作表显示为标签，您可以在工作簿或视图级别设置“下载摘要数据”权限。如果工作表未显示为标签，则可以在视图级别设置权限。

如果将工作簿或视图发布到 Tableau Public，扩展程序还需要访问可见数据。若要授予权限，请打开“设置”并选择“允许访问”。

### 沙盒化扩展程序支持的 Web 浏览器

沙盒化扩展程序可在支持 [Tableau Server](https://www.tableau.com/zh-cn/products/techspecs#server) 和 [Tableau Cloud](https://www.tableau.com/zh-cn/products/techspecs) 的所有浏览器（除 Internet Explorer 11 外）中运行。

### 沙盒化扩展程序支持的 Tableau Server 版本

您可以在 Tableau Server 2019.4 及更高版本中使用沙盒化扩展程序。

## 获取对第三方和 Tableau 合作伙伴构建的仪表板扩展程序的支持

Tableau 不直接支持 Tableau 合作伙伴构建的扩展程序和第三方扩展程序。但是，如果您需要帮助，您可以在一些地方寻找更多信息。

- Tableau Exchange 上的一些合作伙伴页面提供了直接的**“支持”**链接来为您提供帮助。
- 通过 Tableau Exchange 中的**“开发人员网站链接”**联系扩展程序的创建者。

对于有关 Extensions API 的问题，我们鼓励开发人员通过 [DataDev Slack 频道](https://tableau-datadev.slack.com/archives/CHJ9BHKG9)分享问题并寻求帮助，或[在 GitHub 上提交](https://github.com/tableau/extensions-api/issues) Extension API 的问题。