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

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:

  1. Selecteer rechtsboven in uw Salesforce-app het tandwiel en selecteer vervolgens Configuratie.

  2. Typ in het linker navigatiedeelvenster 'Tableau' in de zoekbalk Snel zoeken.

  3. Selecteer de instellingenpagina voor Tableau UAF-claimdefinitie

  4. Selecteer Nieuwe maken.

  5. Vul de definitiewaarden in:

    1. Definitienaam: voer een unieke naam in. (Voorbeeld: state_Account_BillingState)

    2. Kenmerknaam: voer de kenmerknaam in die is opgegeven door de gebruikerskenmerkfunctie in Tableau. (Voorbeeld: 'state')

    3. Doelobject: Selecteer het doelobject vanwaaruit u de informatie wilt halen. Tableau LWC's ondersteunen momenteel de objecten Gebruikers en Accounts.

    4. Doelobjectveld: selecteer het veld vanwaaruit u de informatie wilt halen. (Voorbeeld: Staat/provincie van facturering)

    5. Relatie tussen viewer en doelobject: selecteer de relatie tussen de huidige viewer en het doelobject. (Voorbeeld: Huidige viewer is de accounteigenaar).

  6. 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

  1. Selecteer Selecteer….

  2. Gebruik de pijlen om beschikbare definities naar het veld Geselecteerd te verplaatsen.

  3. 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:

  1. Selecteer rechtsboven in uw Salesforce-app het tandwiel en selecteer vervolgens Configuratie.

  2. Typ in het linker navigatiedeelvenster 'Tableau' in de zoekbalk Snel zoeken.

  3. Selecteer de instellingenpagina voor Tableau UAF-claimdefinitie

  4. 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.