为 Microsoft Teams 设置 Tableau 应用
适用于 Microsoft Teams 的 Tableau 应用可让您的用户在不离开工作流程的情况下与 Tableau 视图（可视化项）和指标进行交互。作为 Tableau 管理员，您可以安装并配置应用以将现有 Tableau 站点与 Microsoft Teams 部署连接。您可以直接从 Microsoft 应用市场安装适用于 Tableau Cloud 的应用。若要安装适用于 Tableau Server 的应用，请下载并侧载该应用。
有关使用适用于 Microsoft Teams 的 Tableau 应用的信息，请参见在 Microsoft Teams 中访问 Tableau 内容。本文介绍如何设置 Tableau 应用。
另请参见
先决条件
若要为 Microsoft Teams 设置 Tableau 应用，您需要以下应用和帐户。
- Tableau Cloud 或 Tableau Server 版本 2023.1 或更高版本
- Tableau Cloud 的站点管理员帐户或 Tableau Server 的服务器管理员帐户
- 适用于 Enterprise 订阅的 Microsoft 365
- Microsoft Teams
- Microsoft 365 管理员帐户（如果您组织的策略需要管理员帐户来安装应用）
- Tableau 和 Microsoft Teams 的用户许可证，这些许可证基于用户映射属性之一相互映射
用户映射属性
若要允许使用 Tableau 进行单点登录，请将 Microsoft Teams 中的用户帐户映射到 Tableau 中的用户帐户。您可以使用 Microsoft Teams SDK 或用户的 Microsoft Entra 配置文件中的属性设置此映射。
Microsoft Teams SDK 属性
| 属性 | 描述 |
|---|---|
| Preferred_Username(链接在新窗口中打开) | Microsoft Teams 用户的电子邮件地址。在某些情况下，此值与 Microsoft Entra 中定义的电子邮件不同。 |
| User Principal Name(链接在新窗口中打开) | 用户登录 Microsoft Entra 的主要方式。 |
Microsoft Entra 配置文件属性
| 属性 | 描述 |
|---|---|
| Primary Email(链接在新窗口中打开) | 与 user.mail 属性相对应，并表示用户的电子邮件地址。 |
| Mail Nickname(链接在新窗口中打开) | 与 user.mailNickname 属性相对应，并表示用户的别名。 |
| Employee ID(链接在新窗口中打开) | 与 user.employeeId 属性相对应，并表示组织分配的员工标识符。 |
| On-Premise Distinguished Name(链接在新窗口中打开) | 与 user.onPremiseDistinguishedName 属性相对应，并表示从本地 Active Directory 同步的可分辨名称 (DN)。 |
| On-Premise User Principal Name(链接在新窗口中打开) | 与 user.onPremiseUserPrincipalName 属性相对应，并表示从本地 Active Directory 同步的 userPrincipalName。 |
| On-premise SAM Account Name(链接在新窗口中打开) | 与 user.onPremiseSamAccountName 属性相对应，并表示从本地 Active Directory 同步的 samAccountName。 |
| Extension Attribute X(链接在新窗口中打开) | Microsoft Entra 允许您向用户的 Entra 配置文件添加最多 15 个额外属性。如果 Microsoft Entra 中不存在 Tableau 用户名，请使用扩展程序属性存储每个 Entra 用户的 Tableau 用户名。 |
安装适用于 Tableau Cloud 的 Tableau 应用
直接从 Microsoft 应用市场安装 Tableau Cloud 应用。您组织的策略确定用户是否可以自行安装应用，或者管理员是否必须为他们安装应用。
- 有关如何以管理员身份安装应用的信息，请参见 Microsoft Teams 文档中的为您的用户预安装应用(链接在新窗口中打开)。
- 有关如何以用户身份安装应用的信息，请参见 Microsoft Teams 文档中的将应用添加到 Microsoft Teams(链接在新窗口中打开)。
若要安装适用于 Tableau Server 的 Tableau 应用，请参见 Tableau Server 设置指南。
配置 Tableau 应用
安装 Tableau 应用后，Microsoft Teams 会提示您设置应用。您可以配置站点信息以将应用连接到 Tableau 站点。
1.创建已连接应用
适用于 Microsoft Teams 的 Tableau 应用使用已连接应用通过单点登录对用户进行身份验证。在 Tableau Cloud 和 Tableau Server 中创建此已连接应用。
在 Tableau Cloud 或 Tableau Server 中，创建直接信任的已连接应用。有关详细信息，请参见使用 Tableau Cloud 的直接信任配置已连接应用或使用 Tableau Server 的直接信任配置已连接应用(链接在新窗口中打开)。
- 如果您将已连接应用的域允许列表限制为仅指定域，请将以下域添加到允许列表。
tableau-ms-teams-prod-gycea7csh5hsbfh5.a02.azurefd.netteams.microsoft.com*.teams.microsoft.com
- 如果用户将从其他 Microsoft 平台访问应用，请从 Microsoft 365 URL(链接在新窗口中打开) 列表中添加其他域。
- 如果您将已连接应用的域允许列表限制为仅指定域，请将以下域添加到允许列表。
启用已连接应用。
生成已连接应用密文。
复制已连接应用客户端 ID、密文 ID 和密文值。保存这些值。在 Microsoft Teams 中配置 Tableau 站点时，您将需要它们。
2.将您的站点配置添加到 Tableau 应用
当您打开 Tableau 应用时，如果您尚未配置该应用，您将看到一个设置屏幕。
对于“Label”（标签），为站点指定一个名称。此名称向 Microsoft Teams 应用的用户显示。如果您不输入标签，应用将显示站点名称。此字段为可选。
对于“Tableau Site Name”（Tableau 站点名称），输入出现在您站点 URL 中的名称。例如，对于 URL
https://us-west-2b.online.tableau.com/#/site/mysitename/home，您将输入mysitename。如果要将应用连接到 Tableau Server 并希望使用默认站点，请将此字段留空。对于“Base URL”（基本 URL），输入站点 URL 中以
tableau.com结尾的部分，例如https://us-west-2b.online.tableau.com。对于“User Mapping Attribute”（用户映射属性），选择用于通过单点登录对用户进行身份验证的 Microsoft Entra 属性。
对于“Connected App ID”（已连接应用 ID）、“Connected App Secret ID”（已连接应用密文 ID）和“Connected App Secret Value”（已连接应用密文值），粘贴您在创建已连接应用时复制的值。
选择“Add Site Config”（添加站点配置）。
Tableau 应用会在保存配置详细信息之前测试连接。如果应用无法连接到 Tableau，则不会添加站点配置。失败原因可能包括：已连接应用无法进行身份验证、未启用已连接应用、站点信息错误，或者您使用的帐户不是 Tableau 管理员帐户。这也可能意味着应用无法访问 Tableau Server，因为它位于防火墙后面。
添加或删除站点配置：
添加站点配置后，您可以添加其他站点或删除现有站点配置。
在适用于 Microsoft Teams 的 Tableau 应用中，选择“Configuration”（配置）选项卡。
在“Configuration”（配置）下，选择“Tableau Site Config”（Tableau 站点配置）选项卡。只有 Tableau 管理员才能访问此选项卡上的设置。
若要添加站点，请选择“Add Site Details”（添加站点详细信息）。或者，若要移除站点，请选择该站点的删除图标。