Gebruikerskenmerkfuncties (UAF) benutten met Tableau Lightning-webcomponenten
U kunt gebruikerskenmerkfuncties (User Attribute Functions, ofwel UAF) gebruiken met uw Tableau View- en Pulse Lightning-webcomponenten (LWC) om specifieke data weer te geven op basis van de kenmerken van de gebruiker die een visualisatie bekijkt. Gebruikerskenmerkfuncties bieden beveiliging op rijniveau, zodat mensen die uw visualisatie bekijken, alleen data zien die voor hen relevant zijn. Zie De kracht van gepersonaliseerde analyses ontgrendelen met gebruikerskenmerkfuncties voor meer informatie over UAF's.
Vereisten
Eenmalige aanmelding (SSO) met tokenverificatie is geconfigureerd voor Tableau Lightning-webcomponenten. Zie Tableau Lightning-webcomponenten en eenmalige aanmelding configureren met tokenverificatie.
Tableau is geconfigureerd om gebruikerskenmerken vast te leggen in verificatieworkflows. Zie Toestaan dat gebruikerskenmerken worden vastgelegd.
De in te sluiten Tableau-inhoud omvat gebruikerskenmerkfuncties. Zie Ervoor zorgen dat de auteur van de inhoud gebruikerskenmerkfuncties opneemt voor een voorbeeld van hoe u gebruikerskenmerkfuncties in een Tableau-werkmap kunt gebruiken.
Tableau UAF-claimdefinities in Salesforce
Met Tableau UAF-claimdefinities kunt u claims voor gebruikerskenmerken opnemen in de JWT. De waarden voor deze kenmerken kunnen worden opgehaald uit de objecten Account, User, Opportunity of Case in Salesforce. Wanneer deze functie wordt gebruikt in combinatie met gebruikerskenmerkfuncties in Tableau-inhoud, worden alleen data weergegeven die overeenkomen met de opgegeven kenmerken.
Een Tableau-dashboard kan bijvoorbeeld zo worden geconfigureerd dat alleen verkoopdata worden weergegeven waarvan de waarde in de datakolom [Staat/Provincie] overeenkomt met een van de waarden in de JWT-claim voor het kenmerk 'state'.
Syntaxis: USERATTRIBUTEINCLUDES('attribute_name', verwachte waarde)
Voorbeeld: USERATTRIBUTEINCLUDES('state', [Staat/Provincie])
Als u een claimdefinitie maakt in Salesforce, kunt u de juiste gebruikerspecifieke informatie in de JWT opnemen. In dit voorbeeld kunnen voor het kenmerk 'state' waarden worden ingevuld uit accounts waarvan de huidige gebruiker de accounteigenaar is. Hiervoor worden waarden uit het veld Staat/provincie van facturering gehaald.
Voorbeeld van claimdefinitie
Definitienaam: state_Account_BillingState
Kenmerknaam: state
Doelobject: Account
Doelobjectveld: Staat/provincie van facturering
Relatie viewer-doelobject: huidige viewer is de accounteigenaar
In het geval van een vertegenwoordiger die accounts heeft in Washington, Oregon en Californië, zal de JWT een claim voor 'state' bevatten met de waarden [WA, OR, CA]. Op het Tableau-dashboard ziet u dan alleen data met [Staat/Provincie]-waarden die overeenkomen met WA, OR of CA.
Een definitie maken
Voer de volgende stappen uit om een gebruikerskenmerkdefinitie te maken:
Selecteer rechtsboven in uw Salesforce-app het tandwiel en selecteer vervolgens Configuratie.
Typ in het linker navigatiedeelvenster Tableau in de zoekbalk Snel zoeken.
Selecteer de instellingenpagina voor Tableau UAF-claimdefinitie
Selecteer Nieuwe maken.
Vul de definitiewaarden in:
Definitienaam: voer een unieke naam in. (Voorbeeld: state_Account_BillingState)
Kenmerknaam: voer de kenmerknaam in die is opgegeven door de gebruikerskenmerkfunctie in Tableau. (Voorbeeld: 'state')
Doelobject: selecteer het doelobject van waaruit u de waarden wilt halen. Tableau LWC's ondersteunen momenteel de objecten Gebruikers en Accounts.
Doelobjectveld: selecteer het veld op het doelobject van waaruit u de waarden wilt halen. (Voorbeeld: Staat/provincie van facturering)
Relatie tussen viewer en doelobject: selecteer de relatie tussen de huidige viewer en het doelobject. (Voorbeeld: Huidige viewer is de accounteigenaar).
Selecteer Opslaan. Of selecteer Annuleren om terug te gaan naar de instellingenpagina van Tableau UAF-claimdefinitie zonder op te slaan.
Een definitie toevoegen aan een Tableau Lightning-webcomponentpagina
App-, start- en recordpagina's in Lightning
Een definitie toevoegen
Selecteer Selecteer….
Gebruik de pijlen om beschikbare definities naar het veld Geselecteerd te verplaatsen.
Selecteer OK.
Herhaal dit voor alle Tableau Lightning-webcomponenten op dezelfde pagina. Zie Overwegingen voor meerdere componenten op dezelfde pagina voor meer informatie.
Experience Cloud-pagina's en de utility bar
Voer een door komma's gescheiden lijst met namen van UAF-claimdefinities in. Als u definitienamen wilt kopiëren, navigeert u vanuit de Salesforce-app naar de instellingenpagina Tableau UAF-claimdefinitie en selecteert u Kopiëren.
Overwegingen voor meerdere componenten op dezelfde pagina
Als meerdere Tableau View- of Tableau Pulse Lightning-webcomponenten aan dezelfde pagina worden toegevoegd, moet elke component dezelfde set UAF-definitienamen hebben. Slechts één van de componenten wordt geverifieerd bij Tableau. Die sessie wordt gebruikt om beide componenten te laden. Dit betekent dat de relevante gebruikerskenmerkinformatie voor beide componenten aanwezig moet zijn in die sessie, ongeacht welk component de verificatie uitvoert.
Bijvoorbeeld:
Als u twee Tableau View-componenten hebt en de ene gebruikerskenmerkinformatie uit definitie A nodig heeft en de andere de gebruikerskenmerkinformatie uit definitie B, moeten beide componenten zowel definitie A als definitie B bevatten.
Als een Tableau View-component definitie A nodig heeft, maar de Tableau Pulse-component op dezelfde pagina geen gebruikerskenmerkinformatie nodig heeft, moeten beide componenten definitie A bevatten.
Een definitie verwijderen
Voer de volgende stappen uit om een gebruikerskenmerkdefinitie te verwijderen:
Selecteer rechtsboven in uw Salesforce-app het tandwiel en selecteer vervolgens Configuratie.
Typ in het linker navigatiedeelvenster Tableau in de zoekbalk Snel zoeken.
Selecteer de instellingenpagina voor Tableau UAF-claimdefinitie
Selecteer Verwijderen voor de definitie die u wilt verwijderen.
App-, start- en recordpagina's in Lightning
Als u een definitie verwijdert die al aan een Tableau LWC is toegevoegd, vernieuwt u de pagina in Lightning App Builder om de beschikbare definities bij te werken. Verwijderde definities worden automatisch gewist.
Experience Cloud-pagina's en de utility bar
Verwijderde definities worden niet automatisch gewist uit het Tableau LWC-componentveld. Verwijderde definities in het componentveld Namen UAF-definities veroorzaken geen problemen, maar wellicht wel onnodige verwarring. Als u definities uit het Tableau LWC-componentveld wilt verwijderen, selecteert u het veld Namen UAF-definities en verwijdert u handmatig alle namen die niet meer in gebruik zijn.