Tableau Lightning 웹 구성 요소에서 UAF(사용자 특성 함수) 활용
Tableau 뷰 및 Pulse LWC(Lightning 웹 구성 요소)와 함께 UAF(사용자 특성 함수)를 활용하여 비주얼리제이션을 보는 사용자의 특성에 따라 특정 데이터를 표시할 수 있습니다. 사용자 특성 함수는 행 수준 보안을 제공하여 비주얼리제이션을 보는 사람들이 본인과 관련된 데이터만 볼 수 있도록 합니다. UAF에 대한 자세한 내용은 사용자 특성 함수를 통해 개인 맞춤형 분석의 최대 활용을 참조하십시오.
필수 요건
Tableau Lightning 웹 구성 요소에 대해 토큰 인증을 사용한 SSO(Single Sign-On)가 구성되어 있어야 합니다. 토큰 인증을 사용하여 Tableau Lightning 웹 구성 요소 및 SSO(Single Sign-On) 구성을 참조하십시오.
Tableau가 인증 워크플로우에서 사용자 특성을 캡처하도록 구성되어 있습니다. 사용자 특성 캡처 허용을 참조하십시오.
내장할 Tableau 콘텐츠에 사용자 특성 함수가 포함되어 있어야 합니다. Tableau 통합 문서에서 사용자 특성 함수를 사용하는 방법에 대한 예는 콘텐츠 작성자가 사용자 특성 함수를 포함하는지 확인을 참조하십시오.
Salesforce의 Tableau UAF 클레임 정의
Tableau UAF 정의를 사용하면 JWT에 사용자 특성에 대한 클레임을 포함할 수 있습니다. 이러한 특성의 값을 Salesforce의 계정 또는 사용자 개체에서 가져올 수 있습니다. Tableau 콘텐츠의 사용자 특성 함수와 함께 사용하는 경우 지정된 특성과 일치하는 데이터만 표시됩니다.
예를 들어, [State/Province] 데이터 열의 값이 'state' 특성에 대한 JWT 클레임의 값 중 하나와 일치하는 매출 데이터만 표시하도록 Tableau 대시보드를 구성할 수 있습니다.
구문: USERATTRIBUTEINCLUDES('특성_이름', 예상 값)
예: USERATTRIBUTEINCLUDES('state', [State/Province])
Salesforce에서 클레임 정의를 만들면 JWT에 적절한 사용자별 정보를 포함할 수 있습니다. 이 예에서는 Billing State/Province(청구 주/시/도) 필드에서 값을 가져와서 현재 사용자가 계정 소유자인 계정의 값으로 'state' 특성을 채울 수 있습니다.
클레임 정의 예
Definition Name(정의 이름): state_Account_BillingState
Attribute Name(특성 이름): state
Target Object(대상 개체): Account
Target Object Field(대상 개체 필드): Billing State/Province
Viewer Target Object Relationship(열람자 대상 개체 관계): Current Viewer is the Account Owner(현재 열람자가 계정 소유자임)
워싱턴, 오리건, 캘리포니아에 계정을 소유한 영업 담당자의 경우 JWT에는 값이 [WA, OR, CA]인 'state'에 대한 클레임이 포함됩니다. 그러면 Tableau 대시보드에는 WA, OR 또는 CA와 일치하는 [State/Province] 값이 있는 데이터만 표시됩니다.
정의 만들기
사용자 특성 정의를 만들려면 다음 단계를 수행합니다.
Salesforce 앱에서 오른쪽 상단의 톱니바퀴를 선택한 다음 Setup(설정)을 선택합니다.
왼쪽 탐색 패널의 Quick Find(빠른 찾기) 검색 표시줄에서 "Tableau"를 입력합니다.
Tableau UAF Claims Definition(클레임 정의) 설정 페이지를 선택합니다.
Create New(새로 만들기)를 선택합니다.
정의 값을 입력합니다.
Definition Name(정의 이름): 고유 이름을 입력합니다. (예: state_Account_BillingState)
Attribute Name(특성 이름): Tableau의 사용자 특성 함수에 지정된 특성 이름을 입력합니다. (예: state)
Target Object(대상 개체): 정보를 가져올 대상 개체를 선택합니다. Tableau LWC는 현재 Users(사용자) 및 Accounts(계정) 개체를 지원합니다.
Target Object Field(대상 개체 필드): 정보를 가져올 필드를 선택합니다. (예: Billing State/Province)
Viewer Target Object Relationship(열람자 대상 개체 관계): 현재 열람자와 대상 개체 간의 관계를 선택합니다. (예: Current Viewer is the Account Owner).
저장을 선택합니다. 또는 저장하지 않고 Tableau UAF Claims Definition(클레임 정의) 설정 페이지로 돌아가려면 Cancel(취소)을 선택합니다.
Tableau Lightning 웹 구성 요소 페이지에 정의 추가
Tableau LWC를 구성할 때 UAF Definition Names(UAF 정의 이름) 구성 요소 필드를 사용하여 추가하려는 UAF 클레임 정의를 선택합니다.
정의를 추가하려면:
Select(선택)…을 선택합니다.
화살표를 사용하여 사용 가능한 정의를 Selected(선택됨) 필드로 이동합니다.
확인을 선택합니다.
Experience Cloud 페이지
UAF 클레임 정의 이름의 쉼표로 구분된 목록을 입력합니다. 정의 이름을 복사하려면 Salesforce 앱에서 Tableau UAF Claims Definition(Tableau UAF 클레임 정의) 설정 페이지로 이동하고 Copy(복사)를 선택합니다.
정의 삭제
사용자 특성 정의를 삭제하려면 다음 단계를 수행합니다.
Salesforce 앱에서 오른쪽 상단의 톱니바퀴를 선택한 다음 Setup(설정)을 선택합니다.
왼쪽 탐색 패널의 Quick Find(빠른 찾기) 검색 표시줄에서 "Tableau"를 입력합니다.
Tableau UAF Claims Definition(클레임 정의) 설정 페이지를 선택합니다.
삭제할 정의에 대해 Delete(삭제)를 선택합니다.
App(앱), Home(홈) 및 Record(레코드) 페이지
Tableau LWC에 이미 추가된 정의를 삭제하는 경우 Lightning App Builder에서 페이지를 새로 고쳐서 사용 가능한 정의를 업데이트하십시오. 삭제된 정의는 자동으로 제거됩니다.
Experience Cloud 페이지
삭제된 정의는 Tableau LWC 구성 요소 필드에서 자동으로 제거되지 않습니다. UAF Definition Names(UAF 정의 이름) 구성 요소 필드에서 삭제된 정의는 문제를 일으키지 않지만 불필요하고 혼란스럽게 보일 수 있습니다. Tableau LWC 구성 요소 필드에서 정의를 제거하려면 UAF Definition Names(UAF 정의 이름) 필드를 선택하고 더 이상 사용하지 않는 이름을 수동으로 삭제합니다.