---
schema_version: "1"
id: 78c648b617edb0c6f553a256e29b6fe07f9089f1a3f117577832f03197460090
title: 設定適用於 Microsoft 365 的 Tableau 應用程式
collection: tableau
version: current
locale: zh-tw
portal_url: https://docs.salesforce.com/tableau/current/zh-tw/server/teams_set_up.md
canonical_url: https://help.tableau.com/current/server/zh-tw/teams_set_up.htm
source_site: help.tableau.com
content_type: documentation
content_hash: a5ac0f7ae274486407b42ecec2e89bbead5cf50902e2438554ba75e4b015fc93
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/server/zh-tw/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 的伺服器管理員帳戶
- 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/zh-tw/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/zh-tw/entra/identity/hybrid/connect/plan-connect-userprincipalname#what-is-userprincipalname) | 使用者登入 Microsoft Entra 的主要方式。 |

#### Microsoft Entra 設定檔屬性

| 屬性 | 描述 |
| --- | --- |
| [Primary Email](https://learn.microsoft.com/zh-tw/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=%24select.-,mail,-String) | 對應於 `user.mail` 屬性，表示使用者的電子郵件地址。 |
| [Mail Nickname](https://learn.microsoft.com/zh-tw/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=%24select.-,mailNickname,-String) | 對應於 `user.mailNickname` 屬性，表示使用者的別名。 |
| [Employee ID](https://learn.microsoft.com/zh-tw/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/zh-tw/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/zh-tw/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=on%20null%20values\).-,onPremisesUserPrincipalName,-String) | 對應於 `user.onPremiseUserPrincipalName` 屬性，表示從內部部署 Active Directory 同步的使用者主體名稱。 |
| [On-premise SAM Account Name](https://learn.microsoft.com/zh-tw/graph/api/resources/user?view=graph-rest-1.0#properties:~:text=%2C%20le\).-,onPremisesSamAccountName,-String) | 對應於 `user.onPremiseSamAccountName` 屬性，表示從內部部署 Active Directory 同步的 SAM 帳戶名稱。 |
| [Extension Attribute X](https://learn.microsoft.com/zh-tw/graph/extensibility-overview?tabs=http) | Microsoft Entra 可讓您將最多 15 個額外屬性新增到使用者的 Entra 設定檔中。若 Tableau 使用者名稱在 Microsoft Entra 中不存在，請使用擴充功能屬性為每個 Entra 使用者儲存 Tableau 使用者名稱。 |

### Tableau Server 的其他必要條件

Tableau 應用程式使用 API 呼叫與 Tableau Server 通訊並內嵌互動式內容。這些呼叫必須能夠存取 Tableau Server。

- 若 Tableau Server 位於防火牆後，請允許來自 IP 位址範圍 4.152.0.0/15 和 20.2.0.0/16 的傳入 HTTP 請求。
- 確保使用者可以透過與存取 Microsoft 365 相同的方式存取 Tableau Server。
    - 如果使用者必須透過 VPN 才能存取 Microsoft 365，則必須能夠從相同 VPN 存取 Tableau Server。
    - 如果使用者可以從公開網際網路存取 Microsoft 365，則必須能夠從公用網際網路存取 Tableau Server。
    - 如果使用者可以透過行動應用程式存取 Microsoft 365，則必須能夠從行動裝置存取 Tableau Server。

## 為 Tableau Server 安裝應用程式

若要安裝適用於 Tableau Server 的應用程式，請先編輯應用程式資訊清單以自訂主機名稱。然後，可以選擇安裝 Microsoft Teams 應用程式、Word 和 PowerPoint 增益集或兩者。若要安裝適用於 Tableau Cloud 的應用程式，請參閱 [Tableau Cloud 設定指南](https://help.tableau.com/current/online/zh-tw/teams_set_up.htm)。

### 下載並編輯應用程式資訊清單

1. 從 GitHub [下載應用程式資訊清單](https://github.com/tableau/tableau-app-msft-teams/raw/main/appManifest/tableau-app-for-teams-server.zip)。
2. 從資訊清單檔 `tableau-server-app-for-teams.zip` 中擷取檔案。
3. 在文字編輯器中開啟檔案 `manifest.json`。
4. 在 `manifest.json` 中搜尋 `*.online.tableau.com`，並將該網域取代為 Tableau Server 環境的主機名稱。若 Tableau Server URL 為 `https://analytics.company.com`，則主機名稱將為 `analytics.company.com`。
5. 儲存對 `manifest.json` 的變更。
6. 壓縮 `tableau-app-for-teams-server` 資料夾中的檔案，以建立一個包含變更的 zip 檔案。

### 部署 Teams 應用程式

#### 將應用程式資訊清單上傳至 Microsoft Teams

您所在組織的應用程式原則決定您是否能夠安裝 Microsoft Teams 應用程式。安裝應用程式可能需要 Microsoft 365 管理員帳戶。

1. 開啟 [Microsoft Teams 管理中心](https://admin.teams.microsoft.com)。
2. 在瀏覽面板中，選取 Teams 應用程式 > 管理應用程式。
3. 選取動作 > 上傳新應用程式。
4. 上傳編輯的 `tableau-server-app-for-teams.zip` 檔案。您會收到確認訊息，其中包含管理應用程式的連結。

#### 為使用者安裝並釘選應用程式

可以安裝應用程式，讓其可供所有或部分使用者使用。還可以釘選應用程式，讓其顯示在使用者的應用程式列中。

1. 開啟 [Microsoft Teams 管理中心](https://admin.teams.microsoft.com)。
2. 在瀏覽面板中，選取 Teams 應用程式 > 設定原則。
3. 在已安裝應用程式下，選取新增應用程式，然後新增 Tableau 應用程式。
4. 也可以在已釘選應用程式下，選取新增應用程式，然後新增 Tableau 應用程式。
5. 儲存變更。

新增 Tableau 應用程式後，最多可能需要 24 小時才能供使用者使用。

### 安裝 Word 和 PowerPoint 增益集

安裝適用於 Microsoft Teams 的應用程式不會安裝 Word 和 PowerPoint 增益集。可以在 Microsoft 365 系統管理中心個別安裝增益集。

1. 開啟 [Microsoft 365 系統管理中心](https://admin.cloud.microsoft.com)。
2. 從瀏覽窗格中，選取「代理程式」\>「所有代理程式」。
3. 選取上傳自訂代理程式。
4. 上傳編輯的 `tableau-server-app-for-teams.zip` 檔案。
5. 選擇是為所有使用者還是特定使用者發佈應用程式，以及是否預先安裝應用程式。
6. 接受權限。
7. 檢閱並完成部署。

完成部署之後，增益集最多可能需要 72 小時才能供使用者使用。

## 設定 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-tw/connected_apps_direct.htm)或[為 Tableau Server 設定具有直接信任的已連線應用程式](https://help.tableau.com/current/server/zh-tw/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/zh-tw/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 中的站台設定選項，請選取增益集窗格底部的「設定」按鈕。

1. 對於標籤，請為站台指定名稱。此名稱會向 Microsoft 365 應用程式的使用者顯示。若未輸入標籤，應用程式會顯示站台名稱。此欄位為可選欄位。
2. 對於 Tableau 站台名稱，輸入站台 URL 中顯示的名稱。例如，對於 `https://us-west-2b.online.tableau.com/#/site/mysitename/home`，需要輸入 `mysitename`。若將應用程式連線到 Tableau Server 並要使用預設站台，請將此欄位留為空白。
3. 對於基礎 URL，請輸入站台 URL 中以 `tableau.com`結尾的部分，例如， `https://us-west-2b.online.tableau.com`。
4. 對於使用者對應屬性，選取用於透過單一登入驗證使用者的 Microsoft Entra 屬性。
5. 對於已連線應用程式 ID、已連線應用程式密碼 ID 和已連線應用程式密碼值，請貼上建立已連線應用程式時複製的值。
6. 選取新增站台設定。

Tableau 應用程式會在儲存設定詳細資訊之前測試連線。若應用程式無法連線到 Tableau，則不會新增站台設定。失敗的原因可能是已連線應用程式無法驗證、已連線應用程式未啟用、站台資訊錯誤，或者使用的帳戶不是 Tableau 管理員帳戶。這也可能意味著該應用程式無法存取 Tableau Server，因為它位於防火牆後。

## 新增或刪除站台設定

新增站台設定後，可以新增其他站台或刪除現有站台設定。

1. 在適用於 Microsoft Teams 的 Tableau 應用程式中，選取設定索引標籤。或者，在 Word 或 PowerPoint 增益集窗格上，選取**設定**按鈕。
2. 在「設定」下，選取 Tableau 站台設定索引標籤。
3. 若要新增站台，請選取新增站台詳細資訊。或者，若要移除站台，請選取該站台的刪除圖示。若要顯示這些選項，您必須是目前所連線 Tableau 站台的站台管理員。