---
schema_version: "1"
id: 5f742a51967b311e3a14a6aa97f12801842a8011e74f0cc211497365a1e05ab0
title: 透過 Tableau Lightning Web 元件利用使用者屬性函數 (UAF)
collection: tableau
version: current
locale: zh-tw
portal_url: https://docs.salesforce.com/tableau/current/zh-tw/online/lwc_uaf.md
canonical_url: https://help.tableau.com/current/online/zh-tw/lwc_uaf.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 6e578bb0f82107bd97de7565b25fb35abac59ba3b8e8d6d8323d118897fc77ad
description: Use User Attribute Functions (UAF) with Tableau Lightning web components for row-level security.
---
[跳至主要內容](#main-content)

# 透過 Tableau Lightning Web 元件利用使用者屬性函數 (UAF)

可以透過 Tableau 檢視和 Pulse Lightning Web 元件 (LWC) 利用使用者屬性函數 (UAF)，以根據查看視覺效果的使用者的屬性顯示特定資料。[使用者屬性函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_user.htm)可提供列層級安全性，以便檢視視覺效果的人員只能看到與他們相關的資料。有關 UAF 的更多資訊，請參閱[使用使用者屬性函數解鎖個性化分析的力量](https://www.tableau.com/zh-tw/blog/unlock-power-personalized-analytics-user-attribute-functions)。

必要條件

- 為 Tableau Lightning Web 元件設定具有權杖驗證的單一登入 (SSO)。請參閱[使用權杖驗證設定 Tableau Lightning Web 元件和單一登入 (SSO)](https://help.tableau.com/current/server/zh-tw/lwc_seamless_auth.htm)。
- Tableau 已設定為在驗證工作流程中擷取使用者屬性。請參閱[允許擷取使用者屬性](https://help.tableau.com/current/server/zh-tw/lwc_seamless_auth.htm#allow-capture-of-user-attributes)。
- 要內嵌的 Tableau 內容包括[使用者屬性函數](https://help.tableau.com/current/pro/desktop/zh-tw/functions_functions_user.htm)。有關如何在 Tableau 工作簿中使用使用者屬性函數的範例，請參閱[確保內容作者包括使用者屬性函數](https://help.tableau.com/current/api/embedding_api/zh-tw/docs/embedding_api_user_attributes.html#4-ensure-the-content-author-includes-user-attribute-functions)。

## Salesforce 中的 Tableau UAF 宣告定義

Tableau UAF 聲明定義可讓您在 JWT 中包含對使用者屬性聲明。這些屬性的值可以從 Salesforce 中的帳戶、使用者、機會或案例物件中提取。與 Tableau 內容中的使用者屬性函數結合使用時，僅顯示與指定屬性相符的資料。

例如，Tableau 儀表板可以設定為僅顯示其 \[州/省\] 資料欄中的值與屬性「州」的 JWT 宣告中的某個值相符的銷售資料。

**語法**：USERATTRIBUTEINCLUDES（'attribute\_name'，預期值）

**範例**：USERATTRIBUTEINCLUDES('state'，\[州/省\])

在 Salesforce 中建立宣告定義可以在 JWT 中包含適當的使用者特定資訊。在此範例中，屬性「州」可填入目前使用者為帳戶擁有者的帳戶中的值，方式是從帳單州/省欄位中擷取值。

**宣告定義範例**

- 定義名稱：state\_Account\_BillingState
- 屬性名稱：州
- 目標物件：帳戶
- 目標物件欄位：帳單州/省
- 檢視者目標物件關係：目前檢視者為帳戶擁有者

若銷售代表在華盛頓、奧勒岡州和加州擁有帳戶，則 JWT 將包含對「州」的宣告，其值為 \[WA、OR、CA\]。Tableau 儀表板將僅顯示 \[州/省\] 值與 WA、OR 或 CA 相符的資料。

## Experience Cloud 中的外部使用者支援

透過 Experience Cloud 站台存取 Tableau 的**外部使用者**支援使用者屬性函數 (UAF) 和主機對應。這允許與已登入外部使用者關聯的 Salesforce 屬性包含在 JWT 中，從而啟用基於該使用者資料的個人化 Tableau 檢視。

外部使用者包括經過驗證的 Experience Cloud 使用者，例如合作夥伴和客戶社群使用者。**不支援來賓使用者。**

為確保功能正常：

- 外部使用者必須有權存取 UAF 和主機對應所使用的相關記錄。
- 必須將以下物件設定為允許外部存取（例如，公用唯讀）：
    - 分析使用者屬性函數權杖
    - 主機對應
- UAF 宣告必須由具有設定存取權限的內部 Salesforce 使用者建立和設定。

進行適當的共用設定後，UAF 和主機對應對外部使用者的作用與對內部使用者的作用相同。

## 建立定義

若要建立使用者屬性定義，請遵循下列步驟：

1. 在 Salesforce 應用程式中，選取右上角的齒輪，然後選取設定。
2. 在左側瀏覽窗格的快速尋找搜尋列中輸入「Tableau」。
3. 選取 Tableau UAF 宣告定義設定頁面。
4. 選取新建。
5. 填入定義值：
    
    1. 定義名稱：輸入一個唯一的名稱。（例如：state\_Account\_BillingState）
    2. 屬性名稱：輸入 Tableau 中使用者屬性函數指定的屬性名稱。（例如：州）
    3. 目標物件：選取想要從中提取值的目標物件。Tableau LWC 目前支援使用者和帳戶物件。
    4. 目標物件欄位：選取想要從中提取值的目標物件上的欄位。（例如：帳單州/省）
    5. 檢視者目標物件關係：選取目前檢視者與目標物件之間的關係。（例如：目前檢視者為帳戶擁有者）。
6. 選取「儲存」。或者，若想要返回 Tableau UAF 宣告定義設定頁面而不儲存，請選取取消。

## 將定義新增至 Tableau Lightning Web 元件頁面

### 首頁、應用程式和記錄 Lightning 頁面

若要新增定義：

1. 選取選取…。
2. 使用箭頭將可用的定義移動至已選取欄位。
3. 選取「確定」。
4. 對同一頁面上的所有 Tableau Lightning Web 元件重複此動作。有關詳情，請參閱[同一頁面上多個元件的注意事項](#Consider)。

### Experience Cloud 頁面與公用程式列

輸入 UAF 宣告定義名稱的逗號分隔清單。若要複製定義名稱，從 Salesforce 應用程式中瀏覽至 Tableau UAF 宣告定義設定頁面，然後選取複製。

### 有關詳情同一頁面上多個元件的注意事項

如果將多個 Tableau View 或 Tableau Pulse Lightning Web 元件新增至相同頁面，則每個元件必須具有相同的一組 UAF 定義名稱。只有一個元件向 Tableau 進行驗證，並且該工作階段將用於載入兩個元件。這代表無論哪個元件進行驗證，兩個元件的相關使用者屬性資訊都必須存在於該工作階段中。

例如：

- 如果有兩個 Tableau View 元件，其中一個需要來自訂 A 的使用者屬性資訊，另一個需要來自訂 B 的使用者屬性資訊，則兩個元件都必須同時包含定義 A 和定義 B。
- 如果 Tableau View 元件需要定義 A，但同一頁面上的 Tableau Pulse 元件不需要任何使用者屬性資訊，則兩個元件都必須包含定義 A。

## 刪除定義

若要刪除使用者屬性定義，請遵循下列步驟：

1. 在 Salesforce 應用程式中，選取右上角的齒輪，然後選取設定。
2. 在左側瀏覽窗格的快速尋找搜尋列中輸入「Tableau」。
3. 選取 Tableau UAF 宣告定義設定頁面。
4. 對想要刪除的定義選取刪除。

### 首頁、應用程式和記錄 Lightning 頁面

若刪除已新增至 Tableau LWC 的定義，請重新整理 Lightning 應用程式產生器中的頁面，以更新可用的定義。已刪除的定義會自動移除。

### Experience Cloud 頁面與公用程式列

已刪除的定義不會自動從 Tableau LWC 元件欄位中移除。刪除 UAF 定義名稱元件欄位中的定義不會導致問題，但會造成不必要且令人困惑的混亂。若要從 Tableau LWC 元件欄位中移除定義，請選取 UAF 定義名稱欄位，然後手動刪除不再使用的任何名稱。