---
schema_version: "1"
id: 258f3f393d8ac9d21e760c7ab7c02555123a0e65a5be552ceaa1236cf7af045c
title: 为 Microsoft 365 设置 Tableau 应用
collection: tableau
version: current
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/current/zh-cn/online/teams_set_up.md
canonical_url: https://help.tableau.com/current/online/zh-cn/teams_set_up.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 2dca632dfe9560f3c761b2b58943ec5e672438c6c64b78a3e719a2a4c0328772
description: Set up and deploy the Tableau app for Microsoft 365, including the Teams app and the Word and PowerPoint add-in.
---
[跳转到主要内容](#main-content)

# 为 Microsoft 365 设置 Tableau 应用

适用于 Microsoft 365 的 Tableau 应用使用户无需离开工作流程即可查看和理解其数据。借助 Teams 应用程序，您的用户可以与 Tableau 视图（可视化项）和指标进行交互，并接收其关注指标的 Tableau Pulse 摘要和通知。使用 Word 和 PowerPoint 加载项，用户可以将视图和指标的图像快照添加到其文档和幻灯片中，并刷新这些快照以使其保持最新。

作为 Tableau 管理员，您安装并配置应用以将现有 Tableau 站点与 Microsoft 365 部署连接起来。您可以直接从 Microsoft 应用市场安装适用于 Tableau Cloud 的应用。若要安装适用于 Tableau Server 的应用，请下载并侧载该应用。

有关使用适用于 Microsoft 365 的 Tableau 应用的信息，请参见[在 Microsoft 365 中访问 Tableau 内容](https://help.tableau.com/current/online/zh-cn/teams_explore.htm)。本文介绍如何设置应用。

注意：如果已将 Tableau 或 Microsoft 365 中的语言设置为 Tableau 支持的语言，而不是英语（美国），则您可能会看到未本地化的英语文本。

## 另请参见

- [GitHub 上的 Tableau 应用常见问题解答](https://github.com/tableau/tableau-app-msft-teams)
- [GitHub 上的发行说明](https://github.com/tableau/tableau-app-msft-teams/blob/main/ReleaseNotes.md)
- [YouTube 上的入门教程](https://www.youtube.com/watch?v=nsa123RgCO0)

## 先决条件

若要为 Microsoft 365 设置 Tableau 应用，您需要这些应用、帐户和配置。

- Tableau Cloud 或 Tableau Server 版本 2023.1 或更高版本
- Tableau Cloud 的站点管理员帐户或 Tableau Server 的服务器管理员帐户
- 适用于 Enterprise 订阅的 Microsoft 365
- Microsoft Teams、Word 和 PowerPoint
- Microsoft 365 管理员帐户
- Tableau 和 Microsoft 365 的用户许可证，这些许可证基于用户映射属性之一相互映射
- 已将 IP 地址范围 `4.152.0.0/15` 并 `20.2.0.0/16` 添加到允许列表（仅当在 Tableau Cloud 站点上启用了 IP 筛选时）

### 用户映射属性

若要允许使用 Tableau 进行单点登录，请将 Microsoft 365 中的用户帐户映射到 Tableau 中的用户帐户。您可以使用 Microsoft Teams SDK 或用户的 Microsoft Entra 配置文件中的属性设置此映射。

#### Microsoft Teams SDK 属性

| 属性 | 描述 |
| --- | --- |
| [Preferred\_Username](https://learn.microsoft.com/en-us/microsoftteams/platform/tabs/how-to/authentication/tab-sso-code#:~:text=user%27s%20display%20name.-,preferred_username,-%3A%20The%20app%20user%27s) | Microsoft Teams 用户的电子邮件地址。在某些情况下，此值与 Microsoft Entra 中定义的电子邮件不同。 |
| [User Principal Name](https://learn.microsoft.com/en-us/entra/identity/hybrid/connect/plan-connect-userprincipalname#what-is-userprincipalname) | 用户登录 Microsoft Entra 的主要方式。 |

#### Microsoft Entra 配置文件属性

| 属性 | 描述 |
| --- | --- |
| [Primary Email](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=%24select.-,mail,-String) | 与 `user.mail` 属性相对应，并表示用户的电子邮件地址。 |
| [Mail Nickname](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=%24select.-,mailNickname,-String) | 与 `user.mailNickname` 属性相对应，并表示用户的别名。 |
| [Employee ID](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=a%20user.-,employeeId,-String) | 与 `user.employeeId` 属性相对应，并表示组织分配的员工标识符。 |
| [On-Premise Distinguished Name](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=on%20null%20values\).-,onPremisesDistinguishedName,-String) | 与 `user.onPremiseDistinguishedName` 属性相对应，并表示从本地 Active Directory 同步的可分辨名称 (DN)。 |
| [On-Premise User Principal Name](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=on%20null%20values\).-,onPremisesUserPrincipalName,-String) | 与 `user.onPremiseUserPrincipalName` 属性相对应，并表示从本地 Active Directory 同步的 userPrincipalName。 |
| [On-premise SAM Account Name](https://learn.microsoft.com/en-us/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=%2C%20le\).-,onPremisesSamAccountName,-String) | 与 `user.onPremiseSamAccountName` 属性相对应，并表示从本地 Active Directory 同步的 samAccountName。 |
| [Extension Attribute X](https://learn.microsoft.com/en-us/graph/extensibility-overview?tabs=http) | Microsoft Entra 允许您向用户的 Entra 配置文件添加最多 15 个额外属性。如果 Microsoft Entra 中不存在 Tableau 用户名，请使用扩展程序属性存储每个 Entra 用户的 Tableau 用户名。 |

## 部署适用于 Tableau Cloud 的应用

直接从 Microsoft 应用市场安装 Tableau Cloud 应用。若要安装适用于 Tableau Server 的 Tableau 应用，请参见 [Tableau Server 设置指南](https://help.tableau.com/current/server/zh-cn/teams_set_up.htm)。

### 安装 Teams 应用

您组织的策略确定用户是否可以自行安装应用，或者管理员是否必须为他们安装应用。

1. 打开 [Microsoft Teams 管理中心](https://admin.teams.microsoft.com)。
2. 从导航面板中，选择“Teams apps”（Teams 应用）\>“Manage apps”（管理应用）。
3. 搜索 Tableau 应用，然后选择该应用。
4. 选择是向所有用户还是特定用户提供应用。
5. 若要为用户预安装应用，请为应用添加设置策略。

### 安装 Word 和 PowerPoint 加载项

在 Teams 管理中心安装适用于 Microsoft 365 的 Tableau 应用时，也会为 Word 和 PowerPoint 安装该应用。但是，若要使 Word 和 PowerPoint 加载项可供用户使用，您必须接受其他权限。

1. 打开 [Microsoft 365 管理中心](https://admin.cloud.microsoft.com)。
2. 从导航面板中，选择“Settings”（设置）\>“Integrated apps”（已集成应用）。
3. 搜索 Tableau 应用，然后选择该应用。
4. 选择“Deploy app”（部署应用）。
5. 使应用可供所有用户或特定用户使用。
6. 接受权限。
7. 查看并完成部署。

## 配置 Tableau 应用

安装 Tableau 应用后，Microsoft Teams 会提示您设置应用。您可以配置站点信息以将应用连接到 Tableau 站点。

### 1.创建已连接应用

适用于 Microsoft 365 的 Tableau 应用使用已连接应用通过单点登录对用户进行身份验证。在 Tableau Cloud 和 Tableau Server 中创建此已连接应用。

1. 在 Tableau Cloud 或 Tableau Server 中，创建直接信任的已连接应用。有关详细信息，请参见[使用 Tableau Cloud 的直接信任配置已连接应用](https://help.tableau.com/current/online/zh-cn/connected_apps_direct.htm)或[使用 Tableau Server 的直接信任配置已连接应用](https://help.tableau.com/current/server/zh-cn/connected_apps_direct.htm#create-a-connected-app)。
    
    - 如果您将已连接应用的域允许列表限制为仅指定域，请将以下域添加到允许列表。
        - `tableau-ms-teams-prod-gycea7csh5hsbfh5.a02.azurefd.net`
        - `teams.microsoft.com`
        - `*.teams.microsoft.com`
    - 如果用户将从其他 Microsoft 平台访问应用，请从 [Microsoft 365 URL](https://learn.microsoft.com/en-us/microsoft-365/enterprise/urls-and-ip-address-ranges?view=o365-worldwide) 列表中添加其他域。
2. 启用已连接应用。
3. 生成已连接应用密文。
4. 复制已连接应用客户端 ID、密文 ID 和密文值。保存这些值。您需要它们才能在 Microsoft 365 中配置 Tableau 站点。

### 2.将您的站点配置添加到 Tableau 应用

当您在 Microsoft Teams 中打开 Tableau 应用时，如果您尚未配置该应用，您将看到一个设置屏幕。若要访问 Word 和 PowerPoint 中的站点配置选项，请选择加载项面板底部的“Settings”（设置）按钮。

1. 对于“Label”（标签），为站点指定一个名称。此名称将向 Microsoft 365 应用的用户显示。如果您不输入标签，应用将显示站点名称。此字段为可选。
2. 对于“Tableau Site Name”（Tableau 站点名称），输入出现在您站点 URL 中的名称。例如，对于 URL `https://us-west-2b.online.tableau.com/#/site/mysitename/home`，您将输入 `mysitename`。如果要将应用连接到 Tableau Server 并希望使用默认站点，请将此字段留空。
3. 对于“Base URL”（基本 URL），输入站点 URL 中以 `tableau.com` 结尾的部分，例如 `https://us-west-2b.online.tableau.com`。
4. 对于“User Mapping Attribute”（用户映射属性），选择用于通过单点登录对用户进行身份验证的 Microsoft Entra 属性。
5. 对于“Connected App ID”（已连接应用 ID）、“Connected App Secret ID”（已连接应用密文 ID）和“Connected App Secret Value”（已连接应用密文值），粘贴您在创建已连接应用时复制的值。
6. 选择“Add Site Config”（添加站点配置）。

Tableau 应用会在保存配置详细信息之前测试连接。如果应用无法连接到 Tableau，则不会添加站点配置。失败原因可能包括：已连接应用无法进行身份验证、未启用已连接应用、站点信息错误，或者您使用的帐户不是 Tableau 管理员帐户。这也可能意味着应用无法访问 Tableau Server，因为它位于防火墙后面。

## 添加或删除站点配置：

添加站点配置后，您可以添加其他站点或删除现有站点配置。

1. 在适用于 Microsoft Teams 的 Tableau 应用中，选择“Configuration”（配置）选项卡。或者，在 Word 或 PowerPoint 加载项面板上，选择**“Settings”（设置）**按钮。
2. 在“Configuration”（配置）下，选择“Tableau Site Config”（Tableau 站点配置）选项卡。
3. 若要添加站点，请选择“Add Site Details”（添加站点详细信息）。或者，若要移除站点，请选择该站点的删除图标。若要显示这些选项，您必须是当前连接的 Tableau 站点的站点管理员。

## 在 Tableau Cloud 中开启 Tableau Pulse 摘要

您的用户可以在 Microsoft Teams 中接收有关他们关注的 Tableau Pulse 指标的摘要和通知消息。Tableau Cloud 站点设置控制启用摘要和通知的渠道。如果您安装了 Microsoft 365 应用程序但未开启 Teams 的摘要设置，您的用户将无法在 Teams 中接收摘要。有关摘要的 Tableau 站点设置的详细信息，请参见[配置摘要](https://help.tableau.com/current/online/zh-cn/pulse_set_up.htm#digest-time)。