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 definitioner 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 konto- eller användarobjekt 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 snabbsökningsrutan.
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 informationen 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 som du vill hämta informationen 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
När du konfigurerar en Lightning-webbkomponent för Tableau kan du använda komponentfältet Definitionsnamn för UAF för att välja de UAF-anspråksdefinitioner som du vill lägga till.
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.
Upplev molnsidor
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).
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 snabbsökningsrutan.
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.
Sidorna App, Start 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.
Upplev molnsidor
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.