GetUserAttr - script- en diagramfunctie

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:

1. Maak een nieuwe Qlik Sense-app.

2. Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie. 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 scriptinstructie die de systeemvariabele QlikCloudGroupMode instelt op 2. Het kenmerk userGroups geeft zowel de IdP- als de aangepaste groepen waartoe de gebruiker behoort.

   • Een reeks scriptvariabeledefinities voor de beschikbare kenmerken die de functie GetUserAttr kan retourneren.

   Set QlikCloudGroupMode = 2;
   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');
   Let vUserLocale = GetUserAttr('userLocale');
   Let vUserZoneinfo = GetUserAttr('userZoneinfo');

3. Laad de gegevens en open een nieuw werkblad in de geavanceerde bewerkingsmodus.

4. Maak een tabelobject en voeg de volgende uitdrukkingen toe als dimensies.

• =vUserEmail

• =vUserSubject

• =vUserGroups retourneert een door komma's gescheiden lijst in een tekenreeks

• =vUserLocale

• =vUserZoneinfo

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.

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:

1. Maak een nieuwe Qlik Sense-app.

2. Open een nieuw werkblad in de geavanceerde bewerkingsmodus.

3. Open het dialoogvenster Variabelen.

4. Selecteer Nieuwe maken en doe vervolgens het volgende:

   • Voer onder Naam vUserEmail 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')

• Landinstellingen voor de gebruiker

  • Naam: vUserLocale

  • Definitie: =GetUserAttr('userLocale')

• Zone-info gebruiker

  • Naam: vUserZoneinfo

  • Definitie: =GetUserAttr('userZoneinfo')

5. Maak een tabelobject en voeg de volgende uitdrukkingen toe als dimensies:

• =vUserEmail

• =vUserSubject

• =vUserGroups (retourneert een door komma's gescheiden lijst in een tekenreeks)

• =vUserLocale

• =vUserZoneinfo

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.

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:

1. Maak een nieuwe Qlik Sense-app.

2. Open de editor voor laden van gegevens en voeg het onderstaande load-script toe aan een nieuwe sectie. Het load-script bevat:

   • Een nieuwe tabel met de naam Attributes , die elk kenmerk als veld bevat.

   • Een scriptinstructie die de systeemvariabele QlikCloudGroupMode instelt op 1 voor aangepaste groepen. Het kenmerk userGroups retourneert alleen de aangepaste groepen waartoe de gebruiker behoort.

   Set QlikCloudGroupMode = 1;
   Attributes:
   Load RowNo() as Key,
   GetUserAttr('userEmail') as UserEmail,
   GetUserAttr('userSubject') as UserSubject,
   GetUserAttr('userLocale') as UserLocale,
   GetUserAttr('userZoneinfo') as UserZoneinfo,
   GetUserAttr('userGroups') as UserGroups autogenerate 1;
   

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

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:

1. Maak een nieuwe Qlik Sense-app.

2. Open een nieuw werkblad in de geavanceerde bewerkingsmodus.

3. Sleep een tekst- en afbeeldingsobject naar het werkblad.

4. Klik in het lege diagram en voer het volgende label in:

   E-mail gebruiker:

5. In het eigenschappenvenster selecteert u Meting toevoegen.

6. Voer de volgende uitdrukking in:

   • =GetUserAttr('userEmail')

7. Voeg labels en metingen toe voor de andere kenmerken op nieuwe regels. Gebruik de volgende uitdrukkingen voor elk kenmerk:

   • =GetUserAttr('userSubject'), voor Onderwerp gebruiker

   • =GetUserAttr('userGroups'), voor Gebruikersgroepen

   • =GetUserAttr('userLocale'), voor Landinstellingen voor de gebruiker

   • =GetUserAttr('userZoneinfo'), voor Zone-info gebruiker