Använd användarattributsfunktioner (UAF) med Lightning-webbkomponenter för Tableau
Du kan använda användarattributsfunktioner (UAF) med dina Lightning-webbkomponenter (LWC) för Tableau-vyer och Tableau Pulse för att få fram specifika data baserat på attributen för användaren som tittar på en visualisering. Användarattributsfunktioner tillhandahåller säkerhet på radnivå, så att personer som tittar på din visualisering bara ser data som är relevanta för dem. Mer information om UAF finns i Unlock the Power of Personalized Analytics with User Attribute Functions (på engelska).
Förutsättningar
Enkel inloggning (SSO) med tokenautentisering är konfigurerat för Lightning-webbkomponenter för Tableau. Se Konfigurera Lightning-webbkomponenter för Tableau och enkel inloggning (SSO) med tokenautentisering.
Tableau är konfigurerat till att samla in användarattribut i autentiseringsarbetsflöden. Se Tillåt insamling av användarattribut.
Tableau-innehåll som ska bäddas in inkluderar användarattributsfunktioner. Ett exempel på hur du använder användarattributsfunktioner i en Tableau-arbetsbok finns i Ensure the content author includes user attribute functions (på engelska).
Anspråksdefinitioner för Tableau-UAF i Salesforce
Med anspråksdefinitioner för Tableau-UAF kan du inkludera anspråk för användarattribut i JWT. Värdena för de här attributen kan hämtas från objekten Konto, Användare, Affärsmöjlighet eller Fall i Salesforce. När de används tillsammans med användarattributsfunktioner i Tableau-innehåll visas endast data som matchar de angivna attributen.
En Tableau-instrumentpanel kan till exempel konfigureras till att endast visa försäljningsdata där värdet i datakolumnen [State/Province] matchar ett av värdena i JWT-anspråket för attributet ”state”.
Syntax: USERATTRIBUTEINCLUDES(”attribute_name”, förväntat värde))
Exempel: USERATTRIBUTEINCLUDES('state', [State/Province])
Att skapa en anspråksdefinition i Salesforce kan inkludera lämplig användarspecifik information i JWT. I det här exemplet kan attributet ”state” fyllas i med värden från konton där den aktuella användaren är kontoägare, genom att värden hämtas från fältet Billing State/Province.
Exempel på anspråksdefinition
Definitionsnamn: state_Account_BillingState
Attributnamn: state
Målobjekt: Account
Målobjektsfält: Billing State/Province
Relation mellan användare och målobjekt: Current Viewer is the Account Owner (Aktuell användare är kontoägare)
Om en säljare till exempel äger konton i Washington, Oregon och Kalifornien kommer JWT att inkludera ett anspråk för ”state” med värdena [WA, OR, CA]. Tableau-instrumentpanelen skulle då endast visa data med [State/Province]-värden som matchar WA, OR eller CA.
Skapa en definition
Följ de här stegen för att skapa en definition för användarattribut:
Välj kugghjulet i det övre högra hörnet av Salesforce-appen och sedan Setup (Konfigurera).
I den vänstra navigeringsrutan anger du ”Tableau” i sökrutan Snabbsökning.
Välj inställningssidan för Tableau UAF Claims Definition (Anspråksdefinition för Tableau-UAF).
Välj Create New (Skapa ny).
Fyll i definitionsvärdena:
Definitionsnamn: Ange ett unikt namn. (Exempel: state_Account_BillingState)
Attributnamn: Ange attributnamnet som anges av användarattributsfunktionen i Tableau. (Exempel: state)
Målobjekt: Välj målobjektet som du vill hämta värdena från. Lightning-webbkomponenter från Tableau har för närvarande stöd för objekten User (Användare) och Account (Konto).
Målobjektsfält: Välj fältet på målobjektet som du vill hämta värdena från. (Exempel: Billing State/Province)
Relation mellan användare och målobjekt: Välj relationen mellan den aktuella användaren och målobjektet. (Exempel: Current Viewer is the Account Owner).
Välj Save (Spara). Om du vill gå tillbaka till inställningssidan för anspråksdefinition för Tableau-UAF utan att spara kan du välja Cancel (Avbryt).
Lägg till en definition på en sida för en Lightning-webbkomponent för Tableau
Lightning-sidorna Start, App och Post
Så här lägger du till en definition:
Välj Välj ....
Använd pilarna för att flytta tillgängliga definitioner till fältet Valda.
Välj OK.
Upprepa detta för alla Tableau Lightning-webbkomponenter på samma sida. Mer information finns i Faktorer att tänka på med flera komponenter på samma sida.
Experience Cloud-sidor och verktygsfältet
Tillhandahåll en kommaavgränsad lista med namn på UAF-anspråksdefinitioner. Om du vill kopiera definitionsnamn går du via Salesforce-appen till inställningssidan för Tableau UAF Claims Definition (Anspråksdefinition för Tableau-UAF) och väljer Copy (Kopiera).
Om flera Lightning-webbkomponenter för Tableau-vyer eller Tableau Pulse läggs till på samma sida måste varje komponent ha samma uppsättning UAF-definitionsnamn. Det är bara en av komponenterna som autentiseras till Tableau, och den sessionen används för att läsa in båda komponenterna. Det innebär att relevant information om användarattribut för båda komponenterna måste finnas i sessionen, oavsett vilken komponent som sköter autentiseringen.
Exempel:
Om du har två komponenter för Tableau-vyer, där den ena behöver information om användarattribut från definition A och den andra behöver information om användarattribut från definition B, så måste båda komponenterna innehålla både definition A och definition B.
Om en komponent för en Tableau-vy behöver definition A, men Tableau Pulse-komponenten på samma sida inte behöver någon information om användarattribut, så måste båda komponenterna innehålla definition A.
Ta bort en definition
Följ de här stegen för att ta bort en definition för användarattribut:
Välj kugghjulet i det övre högra hörnet av Salesforce-appen och sedan Setup (Konfigurera).
I den vänstra navigeringsrutan anger du ”Tableau” i sökrutan Snabbsökning.
Välj inställningssidan för Tableau UAF Claims Definition (Anspråksdefinition för Tableau-UAF).
Välj Delete (Ta bort) för definitionen som du vill ta bort.
Lightning-sidorna Start, App och Post
Om du tar bort en definition som redan har lagts till i en Lightning-webbkomponent för Tableau ska du uppdatera sidan i Lightning-appbyggaren för att uppdatera de tillgängliga definitionerna. Borttagna definitioner tas bort automatiskt.
Experience Cloud-sidor och verktygsfältet
Borttagna definitioner tas inte bort automatiskt från komponentfältet Tableau LWC (Lightning-webbkomponent för Tableau). Borttagna definitioner i komponentfältet UAF Definition Namn (Definitionsnamn för UAF) kommer inte att orsaka problem, men skapar en onödig och förvirrande röra. Om du vill ta bort definitioner från komponentfältet Tableau LWC (Lightning-webbkomponent för Tableau) väljer du fältet UAF Definition Names (Definitionsnamn för UAF) och tar manuellt bort alla namn som inte längre används.