設定適用於 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 的伺服器管理員帳戶
- 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 同步的使用者主體名稱。 |
| On-premise SAM Account Name(連結在新視窗開啟) | 對應於 user.onPremiseSamAccountName 屬性，表示從內部部署 Active Directory 同步的 SAM 帳戶名稱。 |
| Extension Attribute X(連結在新視窗開啟) | 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 Teams 相同的方式存取 Tableau Server。
- 若使用者必須透過 VPN 才能存取 Microsoft Teams，則必須能夠透過相同 VPN 存取 Tableau Server。
- 若使用者可以從公共網際網路存取 Microsoft Teams，則必須能夠從公共網際網路存取 Tableau Server。
- 若使用者可以透過行動應用程式存取 Microsoft Teams，則必須能夠透過行動裝置存取 Tableau Server。
安裝 Tableau Server 版 Tableau 應用程式
若要安裝 Tableau Server 版 Tableau 應用程式，請編輯應用程式資訊清單，以自訂主機名稱，然後將應用程式資訊清單上傳至 Microsoft Teams。
若要安裝 Tableau Cloud 版 Tableau 應用程式，請參閱 Tableau Cloud 設定指南。
1.下載並編輯應用程式資訊清單
- 從 GitHub 下載應用程式資訊清單。
從資訊清單檔
tableau-server-app-for-teams.zip中擷取檔案。在文字編輯器中開啟檔案
manifest.json。在
manifest.json中搜尋*.online.tableau.com，並將該網域取代為 Tableau Server 環境的主機名稱。若 Tableau Server URL 為https://analytics.company.com，則主機名稱將為analytics.company.com。儲存對
manifest.json的變更。壓縮
tableau-app-for-teams-server資料夾中的檔案，以建立一個包含變更的 zip 檔案。
2.上傳應用程式資訊清單
您所在組織的應用程式原則決定您是否能夠安裝 Microsoft Teams 應用程式。安裝應用程式可能需要 Microsoft 365 管理員帳戶。
在瀏覽面板中，選取 Teams 應用程式 > 管理應用程式。
選取動作 > 上傳新應用程式。
上傳您編輯的
tableau-server-app-for-teams.zip檔案。您會收到確認訊息，其中包含管理應用程式的連結。
3.為使用者安裝並釘選應用程式
可以安裝應用程式，讓其可供所有或部分使用者使用。還可以釘選應用程式，讓其顯示在使用者的應用程式列中。
在瀏覽面板中，選取 Teams 應用程式 > 設定原則。
在已安裝應用程式下，選取新增應用程式，然後新增 Tableau 應用程式。
也可以在已釘選應用程式下，選取新增應用程式，然後新增 Tableau 應用程式。
儲存變更。
新增 Tableau 應用程式後，最多可能需要 24 小時才能供使用者使用。
設定 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 應用程式時，若尚未設定該應用程式，則會看到一個設定畫面。
對於標籤，請為站台指定名稱。此名稱會向 Microsoft Teams 應用程式的使用者顯示。若未輸入標籤，應用程式會顯示站台名稱。此欄位為可選欄位。
對於 Tableau 站台名稱，輸入站台 URL 中顯示的名稱。例如，對於
https://us-west-2b.online.tableau.com/#/site/mysitename/home，需要輸入mysitename。若將應用程式連線到 Tableau Server 並要使用預設站台，請將此欄位留為空白。對於基礎 URL，請輸入站台 URL 中以
tableau.com結尾的部分，例如，https://us-west-2b.online.tableau.com。對於使用者對應屬性，選取用於透過單一登入驗證使用者的 Microsoft Entra 屬性。
對於已連線應用程式 ID、已連線應用程式密碼 ID 和已連線應用程式密碼值，請貼上建立已連線應用程式時複製的值。
選取新增站台設定。
Tableau 應用程式會在儲存設定詳細資訊之前測試連線。若應用程式無法連線到 Tableau，則不會新增站台設定。失敗的原因可能是已連線應用程式無法驗證、已連線應用程式未啟用、站台資訊錯誤，或者使用的帳戶不是 Tableau 管理員帳戶。這也可能意味著該應用程式無法存取 Tableau Server，因為它位於防火牆後。
新增或刪除站台設定
新增站台設定後，可以新增其他站台或刪除現有站台設定。
在適用於 Microsoft Teams 的 Tableau 應用程式中，選取設定索引標籤。
在「設定」下，選取 Tableau 站台設定索引標籤。只有 Tableau 管理員才能存取此索引標籤上的設定。
若要新增站台，請選取新增站台詳細資訊。或者，若要移除站台，請選取該站台的刪除圖示。