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-definities kunt u claims voor gebruikerskenmerken opnemen in de JWT. De waarden voor deze kenmerken kunnen worden opgehaald uit Account- of Gebruiker-objecten 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 vanwaaruit u de informatie wilt halen. Tableau LWC's ondersteunen momenteel de objecten Gebruikers en Accounts.
Doelobjectveld: selecteer het veld vanwaaruit u de informatie 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
Wanneer u een Tableau LWC configureert, gebruikt u het componentveld Namen UAF-definities om de UAF-claimdefinities te selecteren die u wilt toevoegen.
Een definitie toevoegen
Selecteer Selecteer….
Gebruik de pijlen om beschikbare definities naar het veld Geselecteerd te verplaatsen.
Selecteer OK.
Experience Cloud-pagina's
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.
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
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
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.