Gebruikersfuncties
Dit artikel introduceert gebruikersfuncties en hun gebruik in Tableau. Het laat ook zien hoe u een gebruikersberekening kunt maken aan de hand van een voorbeeld.
Waarom gebruikersfuncties gebruiken
Met gebruikersfuncties kunt u gebruikers- of beveiligingsfilters op rijniveau maken. Deze zijn van invloed op visualisaties die zijn gepubliceerd in Tableau Server of Tableau Cloud, zodat alleen bepaalde personen uw visualisatie kunnen zien.
Als u bijvoorbeeld een visualisatie hebt gepubliceerd op Tableau Server of Tableau Cloud waarin de verkoopprestaties van elke medewerker van uw afdeling worden weergegeven, wilt u wellicht alleen toestaan dat medewerkers hun eigen verkoopcijfers zien wanneer ze die visualisatie openen.
In dit geval kunt u de functie ISMEMBEROF gebruiken om een veld te maken dat ‘true’ retourneert als de gebruikersnaam van de persoon die is aangemeld bij de server lid is van een opgegeven groep (op de server), zoals bijvoorbeeld de groep 'Managers'. Wanneer u de weergave vervolgens met dit berekende veld filtert, kan alleen de persoon die deel uitmaakt van die groep de data zien.
De berekening zou er in dit geval als volgt uit kunnen zien:
ISMEMBEROF('Managers')Opmerking: als uw groeps- of gebruikersnamen bepaalde niet-alfanumerieke tekens bevatten, moet u HTML URL-codering gebruiken voor de speciale tekens wanneer u de onderstaande functies gebruikt.
Sommige speciale tekens zijn toegestaan zonder HTML URL-codering, zoals onderstrepingstekens, haakjes en uitroeptekens. _ ( ) ! Veel andere tekens moeten gecodeerd worden.
Bijvoorbeeld de functie ISMEMBEROF("USERS+") moet worden geschreven als ISMEMBEROF("USERS%2B"), omdat de '+' de HTML URL-codering voor het symbool '+' is. Zie HTML URL-coderingsreferentie(Link wordt in een nieuw venster geopend) op de site W3schools Web Developer voor informatie over HTML URL-codering.
Functies voor gebruikerskenmerken gebruiken om toegang tot data te beheren en aan te passen
Tot de gebruikersfuncties in Tableau behoren de zogenaamde functies voor gebruikerskenmerken. Deze kunnen worden gebruikt om data te verbergen of te tonen op basis van wie toegang probeert te krijgen tot de inhoud. De functies voor gebruikerskenmerken werken alleen als de gebruikerskenmerken tijdens de runtime als onderdeel van de verificatieworkflow aan Tableau worden doorgegeven.
Aandachtspunten tijdens authoring:
- Functies voor gebruikerskenmerken kunnen worden opgenomen in inhoud die in Tableau Desktop, Tableau Cloud of Tableau Server is geschreven.
- Functies voor gebruikerskenmerken in inhoud die wordt geopend via SAML SSO (eenmalige aanmelding)- of OIDC-workflows worden alleen ondersteund in Tableau Cloud.
- Wanneer u in Tableau Desktop, Tableau Cloud of Tableau Server schrijft, is er met deze functies geen voorbeeld van de inhoud beschikbaar. Functies voor gebruikerskenmerken retourneren de waarden NULL of FALSE. Om er zeker van te zijn dat de functies voor gebruikerskenmerken werken zoals verwacht, raden we u aan de inhoud te controleren nadat deze beschikbaar is gesteld. Zie de Help bij Tableau Embedding API v3(Link wordt in een nieuw venster geopend) of de onderwerpen OIDC(Link wordt in een nieuw venster geopend) of SAML(Link wordt in een nieuw venster geopend) voor meer informatie over workflows die deze gebruikersfuncties bevatten.
- Functies voor gebruikerskenmerken kunnen niet worden gebruikt in workflows die afhankelijk zijn van Tableau Bridge.
Workflow 1: Workflows insluiten (JWT en met Tableau verbonden apps)
Functies voor gebruikerskenmerken (USERATTRIBUTE en USERATTRIBUTEINCLUDES) in ingesloten inhoud kunnen worden ingeschakeld via gebruikerskenmerken die worden doorgegeven in een JSON Web Token (JWT) van een met Tableau verbonden app(Link wordt in een nieuw venster geopend) in Tableau Cloud of een met Tableau verbonden app(Link wordt in een nieuw venster geopend) in Tableau Server 2025.1 en later. Wanneer gebruikerskenmerken worden doorgegeven vanuit JWT's, kan ingesloten inhoud die met deze functies is geschreven, de voor gebruikers weergegeven data beheren en aanpassen.
Opmerkingen:
Raadpleeg de Help van Tableau Embedding API v3(Link wordt in een nieuw venster geopend) voor bekende problemen en beperkingen die van invloed kunnen zijn op de workflow.
Het gebruikerskenmerk laten werken:
In Tableau Cloud moet de sitebeheerder 1) de instelling Gebruikerstoegang beheren in verificatieworkflows inschakelen, 2) de verbonden app configureren met de claimwaarden van de gebruikerskenmerken in het JWT, en 3) de auteur van de inhoud moet een functie voor gebruikerskenmerken (USERATTRIBUTE of USERATTRIBUTEINCLUDES) maken.
In Tableau Server moet de serverbeheerder 1) de functie voor gebruikerskenmerken inschakelen via de methode Site bijwerken(Link wordt in een nieuw venster geopend) met gebruik van Tableau REST API en optioneel de TSM-optie features.VizDataServiceClientEnable(Link wordt in een nieuw venster geopend) inschakelen, 2) de verbonden app configureren met de claimwaarden van het gebruikerskenmerk in het JWT, en 3) de auteur van de inhoud moet een functie voor gebruikerskenmerken(Link wordt in een nieuw venster geopend) maken.
Lees Datatoegang aanpassen en beheren met behulp van gebruikerskenmerken(Link wordt in een nieuw venster geopend) in de Help van Tableau Embedding API v3 voor meer informatie.
Workflow 2: Inhoudworkflows met directe SAML- of OIDC-aanmelding (alleen Tableau Cloud)
Naast de hierboven beschreven workflow voor insluiting worden de functies voor gebruikerskenmerken met ingang van oktober 2025 uitgebreid met aanvullende workflows voor insluiting en niet-insluiting (Tableau 2025.3). Functies voor gebruikerskenmerken in inhoud kunnen worden ingeschakeld via gebruikerskenmerken die worden doorgegeven in OIDC-claims of SAML-asserties. Deze worden vastgelegd door Tableau Cloud wanneer de gebruiker zich aanmeldt om toegang te krijgen tot de inhoud, mits deze is geconfigureerd voor aanmelding via OIDC of SAML SSO. Wanneer kenmerken worden doorgegeven vanuit de claims of asserties, kan inhoud die met deze functies (USERATTRIBUTE en USERATTRIBUTEINCLUDES) is geschreven, de voor gebruikers weergegeven data beheren en aanpassen.
Opmerkingen:
Raadpleeg de onderwerpen OIDC(Link wordt in een nieuw venster geopend) of SAML(Link wordt in een nieuw venster geopend) voor informatie over bekende problemen en beperkingen die van invloed kunnen zijn op de workflow.
Het gebruikerskenmerk werkt alleen in Tableau Cloud als de sitebeheerder 1) de instelling Gebruikerstoegang beheren in verificatieworkflows inschakelt, 2) de claimwaarden van de gebruikerskenmerken opneemt in de JWT- of SAML-respons, en 3) als de auteur van de inhoud een functie voor gebruikerskenmerken (USERATTRIBUTE of USERATTRIBUTEINCLUDES) maakt.
Gebruikersfuncties in Tableau
FULLNAME( )
| Syntaxis | FULLNAME( ) |
| Uitvoer | Tekenreeks |
| Definitie | Retourneert de volledige naam voor de huidige gebruiker. |
| Voorbeeld | FULLNAME( ) Hiermee wordt de volledige naam van de aangemelde gebruiker geretourneerd, bijvoorbeeld 'Hamlin Myrer'. [Manager] = FULLNAME( ) Als manager 'Hamlin Myrer' is aangemeld, retourneert dit voorbeeld alleen TRUE als het veld Manager in de weergave 'Hamlin Myrer' bevat. |
| Opmerkingen | Deze functie controleert:
Gebruikersfilters Wanneer een berekend veld zoals |
ISFULLNAME
| Syntaxis | ISFULLNAME("User Full Name") |
| Uitvoer | Booleaanse waarde |
| Definitie | Retourneert |
| Voorbeeld | ISFULLNAME("Hamlin Myrer") |
| Opmerkingen | Het argument Deze functie controleert:
|
ISMEMBEROF
| Syntaxis | ISMEMBEROF("Group Name") |
| Uitvoer | Booleaanse waarde of null-waarde |
| Definitie | Retourneert |
| Voorbeeld | ISMEMBEROF('Superstars')ISMEMBEROF('domain.lan\Sales') |
| Opmerkingen | Het argument Als de gebruiker is aangemeld bij Tableau Cloud of Tableau Server, wordt het groepslidmaatschap bepaald door Tableau-groepen. De functie retourneert TRUE als de opgegeven tekenreeks 'Alle gebruikers' is De functie Als er een wijziging wordt aangebracht in het groepslidmaatschap van een gebruiker, wordt de wijziging in de gegevens die op het groepslidmaatschap zijn gebaseerd, doorgevoerd in een werkmap of weergave met een nieuwe sessie. De bestaande sessie weerspiegelt oude gegevens. |
ISUSERNAME
| Syntaxis | ISUSERNAME("username") |
| Uitvoer | Booleaanse waarde |
| Definitie | Retourneert TRUE als de gebruikersnaam van de huidige gebruiker overeenkomt met de opgegeven gebruikersnaam, of FALSE als deze niet overeenkomen. |
| Voorbeeld | ISUSERNAME("hmyrer") |
| Opmerkingen | Het argument Deze functie controleert:
|
USERDOMAIN( )
| Syntaxis | USERDOMAIN( ) |
| Uitvoer | Tekenreeks |
| Definitie | Retourneert het domein voor de huidige gebruiker. |
| Opmerkingen | Deze functie controleert:
|
USERNAME( )
| Syntaxis | USERNAME( ) |
| Uitvoer | Tekenreeks |
| Definitie | Retourneert de gebruikersnaam voor de huidige gebruiker. |
| Voorbeeld | USERNAME( ) Hiermee wordt de gebruikersnaam van de aangemelde gebruiker geretourneerd, bijvoorbeeld 'hmyrer'. [Manager] = USERNAME( ) Als manager 'hmyrer' is aangemeld, retourneert dit voorbeeld alleen TRUE als het veld Manager in de weergave 'hmyrer' bevat. |
| Opmerkingen | Deze functie controleert:
Gebruikersfilters Wanneer een berekend veld zoals |
USERATTRIBUTE
Opmerking: Raadpleeg Functies voor gebruikerskenmerken gebruiken om toegang tot data te beheren en aan te passen voordat u deze functie gebruikt. Zie Verificatie en ingesloten weergaven(Link wordt in een nieuw venster geopend) in de Help bij Embedding API v3 en de onderwerpen OIDC(Link wordt in een nieuw venster geopend) of SAML(Link wordt in een nieuw venster geopend) voor meer informatie, afhankelijk van uw workflow.
| Syntaxis | USERATTRIBUTE('attribute_name') |
| Uitvoer | String of null-waarde |
| Definitie | Als Retourneert null als |
| Voorbeeld | Stel dat 'Regio' het gebruikerskenmerk is dat is opgenomen in de JWT- of SAML-respons en wordt doorgegeven aan Tableau. Als auteur van de werkmap kunt u uw visualisatie zo instellen dat de data worden gefilterd op basis van een opgegeven regio. In dat filter kunt u de volgende berekening gebruiken. [Region] = USERATTRIBUTE("Region")Wanneer Gebruiker2 uit de regio West de ingesloten visualisatie bekijkt, toont Tableau alleen de juiste data voor de regio West. |
| Opmerkingen | U kunt de functie USERATTRIBUTEINCLUDES gebruiken als u verwacht dat <'attribute_name'> meerdere waarden retourneert. |
USERATTRIBUTEINCLUDES
Opmerking: Raadpleeg Functies voor gebruikerskenmerken gebruiken om toegang tot data te beheren en aan te passen voordat u deze functie gebruikt. Zie Verificatie en ingesloten weergaven(Link wordt in een nieuw venster geopend) in de Help bij Embedding API v3 en de onderwerpen OIDC of SAML voor meer informatie, afhankelijk van uw workflow.
| Syntaxis | USERATTRIBUTEINCLUDES('attribute_name', 'expected_value') |
| Uitvoer | Booleaanse waarde |
| Definitie | Retourneert
Zo niet, dan wordt |
| Voorbeeld | Stel dat 'Regio' het gebruikerskenmerk is dat is opgenomen in de JWT- of SAML-respons en wordt doorgegeven aan Tableau. Als auteur van de werkmap kunt u uw visualisatie zo instellen dat de data worden gefilterd op basis van een opgegeven regio. In dat filter kunt u de volgende berekening gebruiken. USERATTRIBUTEINCLUDES('Region', [Region])Als Gebruiker2 uit de regio West toegang krijgt tot de ingesloten visualisatie, controleert Tableau of het gebruikerskenmerk Regio overeenkomt met een van de veldwaarden [Regio]. Als dit waar is, toont de visualisatie de juiste data. Wanneer Gebruiker3 uit de regio Noord dezelfde visualisatie opent, kan deze geen data zien omdat er geen overeenkomst is met de veldwaarden van [Regio]. |
Een gebruikersberekening maken
Gebruikersberekeningen werken rechtstreeks met de gebruikers en groepen die u hebt ingesteld in Tableau Server of Tableau Cloud. U kunt gebruikersberekeningen maken en deze gebruiken als filters, zodat gebruikers alleen de data zien die voor hen relevant zijn.
Als u bijvoorbeeld een kaart hebt die er ongeveer zo uitziet, met verkoopdata voor 48 Amerikaanse staten, kunt u een gebruikersberekening maken om alleen de delen van de kaart weer te geven die relevant zijn voor elke gebruiker, zoals data die relevant zijn voor een regionale manager versus data die relevant zijn voor een nationale manager. (Een nationale manager zou data voor het hele land moeten kunnen zien, terwijl regionale managers alleen data zouden moeten kunnen zien voor de regio die ze beheren.)
Wanneer de nationale manager is ingelogd, ziet deze de volgende visualisatie:
Wanneer de regiomanager voor het westen is ingelogd, ziet deze alleen de verkopen voor diens eigen regio:
Volg de onderstaande stappen om een gebruikersfunctie te maken die vergelijkbaar is met dit voorbeeld.
Voordat u begint
Om dit voorbeeld te kunnen volgen, moet u toegang hebben tot Tableau Server of Tableau Cloud. U moet ook een server- of sitebeheerder zijn.
Stap 1: de gebruikers en groepen maken
Aanmelden bij Tableau Server of Tableau Cloud.
Voeg de volgende gebruikers toe in Tableau Server of Tableau Cloud:
Sadie Pawthorne
Chuck Magee
Fred Suzuki
Roxanne Rodriguez
Zie Gebruikers toevoegen aan een site(Link wordt in een nieuw venster geopend) in de Tableau Server Help voor meer informatie.
Maak een nieuwe groep aan met de naam Nationale Managers.
Zie Een lokale groep maken(Link wordt in een nieuw venster geopend) in de Tableau Server Help voor meer informatie.
Voeg uzelf toe aan de groep Nationale Managers.
Zie Gebruikers toevoegen aan een groep(Link wordt in een nieuw venster geopend) in de Tableau Server Help voor meer informatie.
Stap 2: de visualisatie maken
Open Tableau Desktop en maak verbinding met de databron Voorbeeld: Superstore die bij Tableau wordt geleverd.
Klik in de linkerbenedenhoek van de werkruimte op het tabblad Databron.
Sleep op de pagina Databron vanuit het deelvenster Verbindingen aan de linkerkant het werkblad Personen naar het joingebied.
Klik op het pictogram 'Join' en selecteer Links.
Navigeer naar een nieuw werkblad.
Dubbelklik in het deelvenster Data, onder Dimensies, op Staat.
Er wordt een kaartweergave gemaakt.
Sleep in het deelvenster Data, onder Meetwaarden, de optie Verkoop naar Kleur op de kaart Markeringen.
Selecteer het veld Lengtegraad in de container Kolommen en houd Control (Command op Mac) op uw toetsenbord ingedrukt om het te kopiëren. Sleep de kopie naar de rechterkant van het origineel in de container Kolommen.
Klik op het tweede (onderste) tabblad Lengtegraad op de kaart Markeringen.
Sleep in het deelvenster Data Regio naar Kleur op de kaart Markeringen.
De kaartweergave aan de rechterkant wordt bijgewerkt met nieuwe kleuren.
Klik op de kaart Markeringen op de vervolgkeuzelijst Markeringstype en selecteer Kaart.
Klik op de kaart Markeringen op Kleur en pas onder Opaciteit de schuifregelaar aan naar 50%.
Klik op het eerste tabblad Lengtegraad op de kaart Markeringen.
Klik op de kaart Markeringen op Kleur > Kleuren bewerkenen selecteer vervolgens Grijs uit de vervolgkeuzelijst met kleurenpaletten.
De kaartweergave aan de linkerkant wordt bijgewerkt.
Klik op de container Kolommen met de rechtermuisknop op het veld Lengtegraad aan de rechterkant en selecteer Dubbele as.
De kaart ziet er als volgt uit:
Stap 3: de gebruikersberekening maken
Selecteer Analyse > Berekend veld maken.
Doe het volgende in de berekeningseditor die wordt geopend:
Geef het berekende veld de naam: Gebruikersfilter.
Voer de volgende formule in:
[Regional Manager] = USERNAME() OR ISMEMBEROF("National Managers")Met deze berekening wordt gecontroleerd of een persoon is opgenomen in het veld Regio (Personen) of dat een persoon is opgenomen in de groep Nationale managers. Als dat zo is, wordt ‘true’ geretourneerd.
Klik op OK als u klaar bent.
De nieuwe gebruikersberekening wordt getoond onder Dimensies in het deelvenster Data. Net als uw andere velden kunt u deze in een of meer visualisaties gebruiken.
Stap 4: de gebruikersberekening aan de container Filters toevoegen
Sleep Gebruikersfilter in het deelvenster Data onder Dimensies naar de container Filters.
Selecteer in het dialoogvenster Filter dat wordt geopend True en klik vervolgens op OK.
Opmerking: als u niet bent aangemeld bij Tableau Server of Tableau Cloud, is de optie ‘True’ niet zichtbaar. Meld u in Tableau Desktop aan bij Tableau Server of Tableau Cloud om deze optie te selecteren. Zie Aanmelden bij Tableau Server of Tableau Cloud(Link wordt in een nieuw venster geopend) voor meer informatie.
Stap 5: de tabelberekening testen
Klik in Tableau Desktop in de rechterbenedenhoek van de werkruimte op de vervolgkeuzelijst Filteren als gebruiker en wijzig de gebruiker in Sadie Pawthorne.
De kaart wordt bijgewerkt en toont nu alleen het westelijke deel van de Verenigde Staten, omdat Sadie in het werkblad Personen aan dat deel is toegewezen.
Selecteer opnieuw de vervolgkeuzelijst Filter als gebruiker en wijzig de gebruiker in Roxanne Rodriguez.
De kaart wordt bijgewerkt en toont nu alleen de centrale regio van de Verenigde Staten, omdat Roxanne in het werkblad Personen aan de centrale regio is toegewezen.
Selecteer opnieuw de vervolgkeuzelijst Filter als gebruiker en wijzig de gebruiker in Chuck Magee.
De kaart wordt bijgewerkt en toont nu alleen het oostelijke deel van de Verenigde Staten, omdat Chuck in het werkblad Personen aan dat oostelijke deel is toegewezen.
Selecteer opnieuw de vervolgkeuzelijst Filter als gebruiker en wijzig de gebruiker in Fred Suzuki.
De kaart wordt bijgewerkt en toont nu alleen de zuidelijke regio van de Verenigde Staten, omdat Fred in het werkblad Personen aan die regio is toegewezen.
Selecteer nogmaals de vervolgkeuzelijst Filter als gebruiker en wijzig de gebruiker weer in uzelf.
De kaart wordt bijgewerkt en toont alle data, omdat u deel uitmaakt van de groep Nationale Managers op de server.
Dit gedrag blijft bestaan wanneer u de weergave publiceert naar Tableau Server of Tableau Cloud. Gebruikers die niet zijn opgenomen in de groep Nationale managers of in het werkblad Personen in de databron Voorbeeld Superstore staan, zien alleen een lege visualisatie.