De functie GetUserAttr() retourneert de volgende informatie voor de gebruiker die een app opent:
Het e-mailadres van de gebruiker.
Het onderwerp van de gebruiker.
De identiteitsprovider (IdP)-groepen waartoe de gebruiker behoort.
Gebruik de functie GetUserAttr() direct in het load-script of in een diagramuitdrukking. In beide gevallen kunt u de functie gebruiken om kenmerken in een variabele op te slaan of rechtstreeks zonder een variabele. Als u deze functie gebruikt in Qlik Sense met clientbeheer, retourneert hij alleen lege gegevenswaarden. U kunt de functie daarom gebruiken om scripts te ontwikkelen in Qlik Sense met clientbeheer, zonder dat er fouten optreden en met de intentie om de apps later naar Qlik Cloud te uploaden.
Syntaxis:
GetUserAttr(name)
Retourgegevenstypen: dubbele waarde
Argumenten
Argument
Beschrijving
name
De naam van het kenmerk dat u moet worden geretourneerd. Voer in als een tekenreekswaarde in de uitdrukking. De tekenreekswaarde is hoofdlettergevoelig.
Gebruik de functie gebruiken om gebruikerskenmerken in uw app te laden. De functie kan de volgende kenmerken retourneren:
Gebruikerskenmerken die kunnen worden geretourneerd door de GetUserAttr()-functie
Kenmerk
Beschrijving
Voorbeeld van load-scriptvariabele
Voorbeeld van een diagramuitdrukking (geen variabele)
Voorbeeld van resultaten van diagramuitdrukking
userEmail
Het e-mailadres van de huidige gebruiker.
Let vUserEmail = GetUserAttr('userEmail')
=GetUserAttr('userEmail')
john.doe@company.com
userSubject
Het onderwerp van de huidige gebruiker.
Let vUserSubject = GetUserAttr('userSubject')
=GetUserAttr('userSubject')
00uss7ra3dk9doJln0x7
userGroups
De IdP-groepen van de huidige gebruiker die toegang heeft tot de app. Retourneert een door komma's gescheiden lijst in een tekenreeks.
Let vUserGroups = GetUserAttr('userGroups')
=GetUserAttr('userGroups')
Sales,Product-Lead,OKTA-Github-RnD
Wanneer gebruiken
Deze functie retourneert gebruikerseigenschappen en groepen voor de huidige gebruiker van de app. Hiermee kunt u oplossingen bouwen die de inhoud aanpast die voor uw gebruikers verschijnt. In een wereldwijde verkoopapplicatie kunt u bijvoorbeeld productspecifieke werkbladen tonen aan alleen die vertegenwoordigers die verantwoordelijk zijn voor een bepaalde productgroep. Deze functie kan worden gebruikt in het load-script of in diagramuitdrukkingen van de app, ofwel direct als een uitdrukking of in een uitdrukking die is opgeslagen als een variabele.
Voorbeeld – Gebruikerskenmerken opslaan als variabelen in het script
In dit voorbeeld wordt een reeks scriptvariabelen gedefinieerd die kunnen worden gebruikt in de appinhoud die u maakt. Elke keer dat de app opnieuw wordt geladen, worden de kenmerken beoordeeld en toegevoegd aan de app.
Doe het volgende:
Maak een nieuwe Qlik Sense-app.
Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuw tabblad. Het load-script bevat:
Een nieuwe tabel, met de naam Transactions, die voorbeeldtransactiegegevens bevat. Dit kan worden vervangen door gegevens of wordt toegevoegd als een tijdelijke aanduiding.
Een reeks scriptvariabeledefinities voor de beschikbare kenmerken die de functie GetUserAttr kan retourneren.
Transactions:
Load * inline [
id,date,amount
1,1/1/2023,500.67
2,1/2/2023,458.91
3,1/3/2023,12.34
4,1/4/2023,90.90
5,1/5/2023,256.30
6,1/6/2023,789.16
7,1/7/2023,501.25
8,1/8/2023,87.01
9,1/9/2023,161.16
10,1/10/2023,300.06
];
Let vUserEmail = GetUserAttr('userEmail');
Let vUserSubject = GetUserAttr('userSubject');
Let vUserGroups = GetUserAttr('userGroups');
Laad de gegevens en open een nieuw werkblad in de geavanceerde bewerkingsmodus.
Maak een tabelobject en voeg de volgende uitdrukkingen toe als dimensies.
=vUserEmail
=vUserSubject
=vUserGroups retourneert een door komma's gescheiden lijst in een tekenreeks
TipU kunt een dimensielabel toevoegen, zoals E-mail gebruiker, voor een betere leesbaarheid wanneer u de dimensie aanmaakt.
De uitvoer in de tabel geeft de beschikbare gebruikerskenmerken dynamisch weer. De volgende tabel toont een voorbeeld van resultaten die met de functie GetUserAttr zijn geretourneerd.
Resultatentabel
=vUserEmail
=vUserSubject
=vUserGroups
john.doe@company.com
00uss7ra3dk9doJln0x7
Sales,Product-Lead,OKTA-Github-RnD
Voorbeeld – Gebruikerskenmerken opslaan als variabelen en ze in diagramuitdrukkingen gebruiken
In dit voorbeeld worden in plaats van variabelen te definiëren in het load-script, variabelen gedefinieerd in de app. Zodra de variabelen gedefinieerd zijn, kunnen ze gebruikt worden in diagramuitdrukkingen in de app. Het belangrijkste voordeel van het gebruik van de functie in diagramuitdrukkingen is dat de kenmerken automatisch vernieuwd worden zonder dat de app opnieuw geladen hoeft te worden. Hierdoor kunnen apps soepeler tussen gebruikers worden verplaatst als onderdeel van de app-levenscyclus.
Doe het volgende:
Maak een nieuwe Qlik Sense-app.
Open een nieuw werkblad in de geavanceerde bewerkingsmodus.
Open het dialoogvenster Variabelen.
Selecteer Nieuwe maken en doe vervolgens het volgende:
Voer onder NaamvUserEmail in.
Voer onder Definitie=GetUserAttr('userEmail') in.
Selecteer Maken.
Er wordt een appvariabele gemaakt om het e-mailadres van de gebruiker weer te geven. Herhaal deze stap om een variabele te maken voor de resterende kenmerken met behulp van de volgende parameters:
Onderwerp gebruiker
Naam: vUserSubject
Definitie: =GetUserAttr('userSubject')
Gebruikersgroepen
Naam: vUserGroups
Definitie: =GetUserAttr('userGroups')
Maak een tabelobject en voeg de volgende uitdrukkingen toe als dimensies:
=vUserEmail
=vUserSubject
=vUserGroups (retourneert een door komma's gescheiden lijst in een tekenreeks)
TipU kunt een dimensielabel toevoegen, zoals E-mail gebruiker, voor een betere leesbaarheid wanneer u de dimensie aanmaakt.
De uitvoer in de nieuwe tabel geeft de beschikbare gebruikerskenmerken dynamisch weer. De volgende tabel toont een voorbeeld van resultaten die met de functie GetUserAttr zijn geretourneerd.
Resultatentabel
=vUserEmail
=vUserSubject
=vUserGroups
john.doe@company.com
00uss7ra3dk9doJln0x7
Sales,Product-Lead,OKTA-Github-RnD
Voorbeeld – De functie GetUserAttr direct in het load-script gebruiken
U kunt de functie tevens zonder variabele in uw apps gebruiken. Dit voorbeeld laat zien hoe u een tabel kunt laden met elk kenmerk als een afzonderlijke veld. Van hieruit kunt u visualisaties in de app maken om deze details weer te geven.
Doe het volgende:
Maak een nieuwe Qlik Sense-app.
Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuw tabblad. Het load-script bevat:
Een nieuwe tabel, met de naam Attributes , die elk kenmerk als veld bevat.
Attributes:
Load RowNo() as Key,
GetUserAttr('userEmail') as UserEmail,
GetUserAttr('userSubject') as UserSubject,
GetUserAttr('userGroups') as UserGroups autogenerate 1;
Laad de gegevens. Een tabel wordt aangemaakt in het gegevensmodel en geeft elk van de kenmerken in afzonderlijke velden weer.
Nu kunt u de kenmerkvelden in visualisaties gebruiken, zoals tabellen of tekst- en afbeeldingsobjecten.
Voorbeeld – De functie GetUserAttr direct in diagramuitdrukkingen gebruiken
U kunt de functie direct en zonder een variabele in diagramuitdrukkingen gebruiken. De gebruikerskenmerken worden vernieuwd zonder dat u de app opnieuw hoeft te laden. Hierdoor kunnen apps soepeler tussen gebruikers worden verplaatst als onderdeel van de app-levenscyclus.
Doe het volgende:
Maak een nieuwe Qlik Sense-app.
Open een nieuw werkblad in de geavanceerde bewerkingsmodus.
Sleep een tekst- en afbeeldingsobject naar het werkblad.
Klik in het lege diagram en voer het volgende label in:
E-mail gebruiker:
In het eigenschappenvenster selecteert u Meting toevoegen.
Voer de volgende uitdrukking in:
=GetUserAttr('userEmail')
Voeg labels en metingen toe voor de andere kenmerken, User Subject en User Groups, op nieuwe regels. Gebruik de volgende uitdrukkingen voor elk kenmerk:
=GetUserAttr('userSubject'), voor Onderwerp gebruiker
=GetUserAttr('userGroups), voor Gebruikersgroepen
Was deze pagina nuttig?
Als u problemen ervaart op deze pagina of de inhoud onjuist is – een typfout, een ontbrekende stap of een technische fout – laat het ons weten zodat we dit kunnen verbeteren!