--- schema_version: "1" id: b74a504e015599b542a3eb8b87b1017b0c1918ef079f6283029cd18e2f46c66d title: 将可视化项扩展程序添加到您的工作表 collection: tableau version: current locale: zh-cn portal_url: https://docs.salesforce.com/tableau/current/zh-cn/pro/desktop/viz_extensions.md canonical_url: https://help.tableau.com/current/pro/desktop/zh-cn/viz_extensions.htm source_site: help.tableau.com content_type: documentation content_hash: 4ddcfeabb45bc0c34e65dbb8a374b3aef2cd9b1b2134aef766bd2572e34ce6ee description: Add Viz Extensions to a worksheet to extend visual capabilities. --- [跳转到主要内容](#main-content) # 将可视化项扩展程序添加到您的工作表 可视化项扩展程序是可以扩展 Tableau 原生可视化功能的 Web 应用程序。可视化项扩展程序使用户能够与工作表上的自定义可视化项类型进行交互。 在 Tableau、Tableau 合作伙伴和社区中的第三方开发人员创建的 Web 应用程序的帮助下，Tableau 扩展程序扩展了工作表功能。如果您是开发者，并且想要创建自己的扩展程序，请参见 GitHub 上的 [Tableau Extensions API](https://tableau.github.io/extensions-api/) 文档。 可视化项扩展程序与[仪表板扩展程序](https://help.tableau.com/current/pro/desktop/zh-cn/dashboard_extensions.htm?_gl=1*uu9rzu*_ga*MTY0NjQ4Mjc3NS4xNzA3NzcyMzUx*_ga_8YLN0SNXVS*MTcxMjE2NjcxNC41NC4xLjE3MTIxNzA1MzUuMC4wLjA.)类似，因为它是托管在 [Tableau Exchange](https://exchange.tableau.com/zh-cn/) 上的 Web 应用程序。它与仪表板扩展程序的不同之处在于，您在构建可视化项时将其添加到工作表中，而不是将其作为对象添加到仪表板。 ## 将可视化项扩展程序添加到工作表 有两种方法可以通过“标记”卡将可视化项扩展程序添加到工作表。如果您已经通过 Tableau Exchange 下载了该扩展程序，则可以将其添加为本地文件。或者您可以在制作可视化项的流程中从 Tableau Exchange 下载它。 ### 以本地文件形式添加可视化项扩展程序 如果您已经从 Tableau Exchange 选择并下载了可视化项扩展程序，它将以 .trex 文件形式保存在您的计算机上。 1. 打开 Tableau 工作簿并连接到数据源。 2. 在工作表中的“标记”卡上，展开“标记类型”下拉菜单。 3. 在“可视化项扩展程序”下，选择“添加扩展程序”。 ![包含“可视化项扩展程序”选项的“标记”卡下拉菜单。](/tableau/current/zh-cn/pro/desktop/zh-cn/Img/viz_ext_marks_AddExt.png) 4. 在出现的“添加扩展程序”对话框中，选择“访问本地可视化项扩展程序”。 ![“添加扩展程序”对话框，其中用于包含访问本地可视化项扩展程序的选项。](/tableau/current/zh-cn/pro/desktop/zh-cn/Img/viz_ext_addlocal.png) 5. 导航到并打开已保存的 .trex 文件。 6. 如果出现提示，请允许或拒绝可视化项扩展程序访问工作簿中的数据。 可视化项扩展程序在视图中加载，并且标记类型更改为可视化项扩展程序的名称。 ### 在制作可视化项时添加可视化项扩展程序 如果您尚未选择并下载可视化项扩展程序，则可以在制作可视化项的流程中进行选择和下载。 1. 打开 Tableau 工作簿并连接到数据源。 2. 在工作表中的“标记”卡上，展开“标记类型”下拉菜单。 3. 在“可视化项扩展程序”下，选择“添加扩展程序”。 ![包含“可视化项扩展程序”选项的“标记”卡下拉菜单。](/tableau/current/zh-cn/pro/desktop/zh-cn/Img/viz_ext_marks_AddExt.png) 4. 在出现的“添加扩展程序”对话框中，选择您想要加载到工作表上的可视化项扩展程序。在此示例中，我们正在加载由 Tableau 构建的桑基图。 ![“添加扩展程序”对话框，用于从 Tableau Exchange 中搜索并添加扩展程序。](/tableau/current/zh-cn/pro/desktop/zh-cn/Img/viz_ext_addext.png) 5. 如果出现提示，请允许或拒绝可视化项扩展程序访问工作簿中的数据。有关详细信息，请参见“数据安全扩展程序、支持网络的扩展程序以及沙盒化扩展程序”。 6. 选择“打开”。 ![Tableau Exchange 中由 Tableau 开发的桑基图的描述页面。\]](Img/viz_ext_exchange.png) 可视化项扩展程序在视图中加载，并且标记类型更改为可视化项扩展程序的名称。 ![“标记”卡下拉菜单，在“可视化项扩展程序”部分放大了“桑基图扩展程序”。](/tableau/current/zh-cn/pro/desktop/zh-cn/Img/viz_ext_add_sankey.png) ## 使用“标记”卡对标记进行编码 将字段拖到“标记”卡上的编码框上以构建可视化项。标记编码框和格式选项由开发人员决定。检查 Tableau Exchange 上的扩展程序描述，以获取有关您正在加载的可视化项扩展程序的信息。 若要使用桑基图扩展程序，请遵循以下编码说明： 构建桑基图扩展程序是为对**级别**和**链接**使用特定于扩展程序的编码。这些可以与内置的标记编码框工具提示和详细信息一起使用，在工作表上构建桑基图。 - **级别** - 桑基图级别表示与桑基图相关的分类维度。在此扩展程序中，您最多可以将 5 个离散维度作为级别。 - **链接**\- 桑基图链接将桑基图中的类别连接起来。此编码将根据数值度量来调整每个链接的宽度。 ## 管理工作簿扩展程序 从 Tableau 2026.2 开始，您可以从一个位置查看、删除或替换工作簿中使用的所有扩展程序。 若要管理扩展程序，请执行以下操作： 1. 从工具栏中，选择“分析”，然后选择“管理工作簿扩展程序”。 ![显示各种设置和突出显示的“管理工作簿扩展程序”选项的“分析”下拉菜单。](/tableau/current/zh-cn/pro/desktop/zh-cn/Img/vizext_manageextensions.png) 2. 在“管理工作簿扩展程序”对话框中，选择要管理的扩展程序。 ![“管理工作簿扩展程序”对话框窗口，显示选定的桑基图扩展程序详细信息。](/tableau/current/zh-cn/pro/desktop/zh-cn/Img/vizext_manageextension_dialog.png) 3. 选择以下操作之一： **删除扩展程序**：选择“删除”以从工作簿中移除扩展程序。您可以在“工作簿扩展程序”对话框中查看扩展程序当前在何处使用。删除扩展程序会将其从所有工作表、仪表板和故事中移除。使用扩展程序的可视化项将更改为“标记”卡上的“自动”标记类型。 **替换扩展程序：**选择“替换”以切换到其他扩展程序。选择要切换到的扩展程序，并选择“确认”。替换扩展程序将替换整个工作簿中扩展程序的每个实例。Tableau 会尝试尽可能保留您的设置，但设置可能因扩展程序或版本而异。 4. 完成更新后，选择“确定”。 注意：如果您的工作簿不包含任何扩展程序，则对话框将显示“此工作簿中没有扩展程序”消息。 ## 确保 Tableau Cloud 上允许使用扩展程序 如果您无法添加可视化项扩展程序，请检查您的站点上是否允许使用扩展程序。Tableau 管理员必须允许扩展程序在站点上运行，并将支持网络的扩展程序添加到允许列表。管理员只应允许您测试过并信任的扩展程序。 若要了解有关将支持网络的扩展程序添加到允许列表的详细信息，请参见 [Tableau 帮助：更改站点的默认设置](https://help.tableau.com/current/server/zh-cn/dashboard_extensions_server.htm#change-the-default-settings-for-a-site)。 ### 数据安全扩展程序、Tableau 可信扩展程序和支持网络的扩展程序 扩展程序是采用两种标准的 Web 应用程序： - _Tableau 可信扩展程序_已由 Tableau 管理的主机专门审查并部署在其中。其中包括由 Tableau 开发和管理的扩展程序、由 Tableau Exchange 合作伙伴构建并使用 Tableau 的扩展程序审查和主机服务部署的扩展程序，以及我们旧版沙盒化扩展程序主机内的扩展程序。 - _支持网络的扩展程序_由第三方主机托管。这些扩展程序允许开发人员管理其扩展程序的交付，而无需 Tableau 的中介。其中包括合作伙伴直接管理以提供更好的生产支持的扩展程序、在您的本地网络中托管和部署的扩展程序，以及需要与 Tableau 外部的第三方服务通信的扩展程序。 在您允许支持网络的扩展程序之前，请确保您信任开发人员和托管扩展程序的网站。您可以在“管理工作簿扩展程序”对话框中找到有关托管扩展程序的 URL 以及开发人员请求的数据访问权限类型的信息。 ![“管理工作簿扩展程序”对话框窗口，显示突出显示的扩展程序详细信息部分。](/tableau/current/zh-cn/pro/desktop/zh-cn/Img/vizext_manageextension_dialog_magnified.png) 默认情况下，扩展程序使用 HTTPS 协议，该协议可保障一条用于发送和接收数据的加密通道，并确保一定的隐私性和安全性。有关使用扩展程序时的数据安全性的详细信息，请参见[扩展程序安全性 - 部署最佳做法](https://help.tableau.com/current/server/zh-cn/security_extensions.htm)。 ### 允许或拒绝支持网络的扩展程序 默认情况下，支持网络的扩展程序必须请求运行权限。此权限对话框将提供有关从中托管它的第三方服务器的信息，以及扩展程序所需的数据访问级别。我们建议您在允许运行扩展程序之前查看此信息。 扩展程序通常访问视图中的可见数据。当扩展程序请求“完整数据访问权限”时，它可能会请求工作簿中的更深层次的数据访问权限。这可能包括访问完整的基础数据、数据源中的表和字段名称，以及有关数据源连接的信息。在允许扩展程序在工作簿中运行之前，您应查看扩展程序权限对话框中声明的信息，并决定是要允许还是拒绝扩展程序运行和访问此数据。 ### 重置支持网络的扩展程序的数据访问权限 如果在扩展程序权限对话框中选择“拒绝”而不是“允许”，扩展程序将不会加载到您的工作表上。如果您信任扩展程序并希望允许访问，您可以通过将相同的可视化项扩展程序再次添加到工作簿中来重置权限，这将重新加载权限提示对话框。 ### 确保扩展程序具有访问工作簿或视图的权限 如果发布包含扩展程序的工作簿，请确保扩展程序能够访问视图中的可见数据。可见数据也称为摘要数据。若要在 Tableau Server 或 Tableau Cloud 上授予此访问权限，请确保工作簿或视图允许“下载摘要数据”的权限。扩展程序不会下载您的数据。扩展程序只需要权限，就可以与视图中的数据交互。 根据您在发布工作簿时是否选择了将工作表显示为标签，您可以在工作簿或视图级别设置“下载摘要数据”权限。如果工作表未显示为标签，则可以在视图级别设置权限。 如果将工作簿或视图发布到 Tableau Public，扩展程序还需要访问可见数据。若要授予权限，请打开“设置”并选择“允许访问”。 ## 确保在 Tableau Desktop 中启用了 JavaScript 可视化项扩展程序使用 Tableau Extensions API 库（一个 JavaScript 库）与数据交互。如果要使用扩展程序，请确保在安全设置中启用了 JavaScript： 选择“帮助”\>“设置和性能”\>“设置仪表板 Web 视图安全性”\>“启用 JavaScript”。 ## 获取对第三方和 Tableau 合作伙伴构建的可视化项扩展程序的支持 Tableau 不直接支持第三方和 Tableau 合作伙伴构建的扩展程序。但是，如果您需要帮助，一些扩展开发人员会提供指向开发人员网站的链接，您可以在其中寻求支持。 获取帮助： 1. 在“管理工作簿扩展程序”对话框上或 Tableau Exchange 的扩展程序描述页面上查找“开发人员网站”链接。 2. 在“管理工作簿扩展程序”对话框中找到扩展程序的 ID 和版本。向开发人员提供这些详细信息对于故障排除至关重要，因为它可以确认是否使用了过时的版本，并有助于查明问题的根源。 3. 请通过开发人员网站直接与扩展程序的开发人员联系。 对于有关 Extensions API 的问题，我们鼓励开发人员通过 [DataDev Slack 频道](https://tableau-datadev.slack.com/archives/CHJ9BHKG9)分享问题并寻求帮助，或[在 GitHub 上提交](https://github.com/tableau/extensions-api/issues) Extension API 的问题。