Tableau 嵌入式分析手册

嵌入的常见用例是：

• Tableau 仪表板作为业务线或垂直应用程序的组件

• 嵌入内部知识库和 CRM 系统

• 向博客文章添加交互式可视化

• 嵌入自定义移动应用程序

将单个仪表板或可视化嵌入到单个网页中的操作非常简单，但精心设计的集成需要处理其他事情，例如身份验证、授权、内容管理和性能。根据您的集成目标，您可能需要使用各种功能和技术。

以下列表提供了嵌入式部署中使用的关键 API 和功能的摘要。然后，剧本的其余部分将深入探讨关键嵌入要求，解释如何满足这些要求，并为您提供启动和运行所需的资源。

主要功能和 API

Embedding API v3 - Embedding API v3 在 JavaScript API v2 的基础上提供了更新的开发人员体验和增强功能。Embedding API v3 提供了用于嵌入 Tableau 可视化的Web 组件，并且从 Tableau 版本 2021.4 开始提供。在今年晚些时候全面实施后，Embedding API v3 将支持 JavaScript API v2 的所有功能，同时为嵌入场景提供未来增强功能。

JavaScript API v2 - 一种用于嵌入应用程序前端的 API，它在 JavaScript 中初始化 Tableau 可视化，并提供丰富的类和方法来推动 Tableau 和您的应用程序之间的交互。

如果您要开始一个新项目，我们建议您使用 Embedding API v3，因为它会在未来获得功能增强。

REST API - 允许嵌入应用程序与 Tableau Server 或 Tableau Online 之间通过 RESTful 端点进行集成，这些端点管理用户、内容和权限以及 Tableau 平台提供的许多其他功能。常见用例包括将 Tableau 中的用户管理与嵌入应用程序中的用户管理集成，根据嵌入应用程序的状态管理内容和权限，查询 Tableau 元数据以便向最终用户显示正确的信息，以及自动管理表服务器。

连接的应用程序- 通过促进 Tableau Online 或 Tableau Server 与嵌入了 Tableau 内容的外部应用程序之间的明确信任关系，实现无缝且安全的身份验证体验。信任关系是通过JSON Web 令牌 (JWT) 标准中的身份验证令牌建立和验证的，该使用由 Tableau 连接的应用程序提供并由您的外部应用程序签名的共享密钥。

注意：使用嵌入 API v3的 Tableau Server 和 Tableau Online 都可以使用 Connected Apps 。

外部授权服务器 (EAS) - 在 Tableau Server 和 EAS 之间建立信任关系。通过建立信任关系，您可以通过您已经为 Tableau Server 配置的身份提供程序 (IdP) 为用户提供对嵌入在外部应用程序中的 Tableau 内容的单点登录 (SSO) 体验。在自定义应用程序中加载嵌入的 Tableau 内容时，将使用标准 OAuth 流程。用户成功登录到 IdP 后，他们会自动登录到 Tableau Server。若要向 Tableau Server 注册 EAS，您必须已配置 EAS。此外，EAS 必须发送有效的JSON Web 令牌 (JWT)。

注意： EAS 仅适用于 Tableau Server 和Embedding API v3。

受信任的身份验证- 在 Tableau Server 和外部应用程序之间建立受信任的关系，以提供安全和无缝的身份验证体验。与连接的应用程序或外部授权服务器不同，可信身份验证不遵循JWT 标准。

如果您要开始一个新项目，我们建议使用连接的应用程序或外部授权服务器。

注意：可信身份验证仅适用于 Tableau Server 和JavaScript API v2。

SAML、OpenID、Active Directory、Kerberos - 对于已经使用这些系统之一的环境，可以利用它们来实现单点登录（并在 Kerberos 的情况下利用数据库安全性）。

Tableau Viz Lightning Web 组件- 可以轻松地将 Tableau 视图嵌入 Salesforce Lightning 页面。Tableau Viz Lightning Web 组件可从 Salesforce AppExchange 获得。要嵌入视图，您只需将 Tableau Viz Lightning Web 组件拖放到页面上，然后提供 Tableau 视图的 URL。您可以从 Tableau Server、Tableau Online 或 Tableau Public 嵌入 Tableau 视图。

Mobile App Bootstrap - 用于嵌入移动应用程序的示例/模板。如果您有移动应用程序并想要包含 Tableau 内容，或者如果您想要为 Tableau 定制移动体验，这是一个很好的启动和运行方式。

Document API - 用于更新数据源连接信息的 API。允许您在具有许多结构相似的多租户或开发/测试/生产场景的数据库的场景中构建一次内容（即模板）。

用户筛选- 基于 Tableau Server 或 Online 登录信息安全筛选工作簿的功能。在多租户场景中，如果您有多个用户或客户端的单个数据库，您可以使用用户过滤器将相同的内容应用于不同的客户端，确保每个用户只能看到他或她有权访问的行。