GetUserAttr – Skript- och diagramfunktion

Det här exemplet definierar en uppsättning skript-variabler som kan användas i appinnehåll som du skapar. Varje gång appen läses in kommer attributen att utvärderas och läggas till appen.

Gör följande:

1. Skapa en ny Qlik Sense-app.

2. Öppna dataladdningsredigeraren och lägg till laddningsskriptet nedan i ett nytt delavsnitt. Laddningsskriptet innehåller:

   • En ny tabell, som heter Transactions, innehåller exempeltransaktionsdata. Den kan ersättas med vilka data som helst och läggs till som en platshållare.

   • Ett skript som ställer in systemvariabeln QlikCloudGroupMode till 2. Attributet userGroups returnerar både IdP och de anpassade grupper som användaren tillhör.

   • En serie definitioner av skriptvariabler för tillgängliga attribut som funktionen GetUserAttr kan returnera.

   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. Läs in dina data och öppna ett nytt ark i avancerat redigeringsläge.

4. Skapa en tabell och lägg till följande uttryck som dimensioner:

• =vUserEmail

• =vUserSubject

• =vUserGroups returnerar en kommaseparerad lista i en sträng

• =vUserLocale

• =vUserZoneinfo

Utdata i tabellen visar dynamiskt de tillgängliga användarattributen. Följande tabell visar ett exempel på resultat som returneras med hjälp av funktionen GetUserAttr.

I det här exemplet definieras variabler i appen i stället för i laddningsskriptet. När variablerna har definierats kan de användas i diagramuttryck i appen. Den största fördelen med att använda funktionen i diagramuttryck är att attributen uppdateras automatiskt utan att appen behöver laddas om. Detta gör det möjligt att flytta appar mellan användare på ett smidigare sätt som en del av appens livscykel.

Gör följande:

1. Skapa en ny Qlik Sense-app.

2. Öppna ett nytt ark i avancerat redigeringsläge.

3. Öppna dialogrutan variabler.

4. Välj Skapa ny och gör sedan följande:

   • Under Namn skriver du vUserEmail.

   • Under Definition skriver du =GetUserAttr('userEmail').

   • Välj Skapa.

En variabel i appen skapas för att visa användarens e-postadress. Upprepa detta steg för att skapa en variabel för de återstående attributen med hjälp av följande parametrar:

• Användare Ämne

  • Namn: vUserSubject

  • Definition: =GetUserAttr('userSubject')

• Användargrupper

  • Namn: vUserGroups

  • Definition: =GetUserAttr('userSubject')

• Användarens plats

  • Namn: vUserLocale

  • Definition: =GetUserAttr('userLocale')

• Zoninfo användare

  • Namn: vUserZoneinfo

  • Definition: =GetUserAttr('userZoneinfo')

5. Skapa en tabell och lägg till följande uttryck som dimensioner:

• =vUserEmail

• =vUserSubject

• =vUserGroups (returnerar en kommaseparerad lista i en sträng)

• =vUserLocale

• =vUserZoneinfo

Utdata i den nya tabellen visar de tillgängliga användarattributen dynamiskt. Följande tabell visar ett exempel på resultat som returneras med hjälp av funktionen GetUserAttr.

Du kan även använda funktionen i dina appar utan någon variabel. I det här exemplet ser du hur du kan läsa in en tabell med vart och ett av attributen som enskilt fält. Utifrån detta kan du skapa visualiseringar i appen för att visa dessa detaljer.

Gör följande:

1. Skapa en ny Qlik Sense-app.

2. Öppna dataladdningsredigeraren och lägg till laddningsskriptet nedan i ett nytt delavsnitt. Laddningsskriptet innehåller:

   • En ny tabell som heter Attributes, som innehåller varje attribut som ett fält.

   • En skriptsats som ställer in systemvariabeln QlikCloudGroupMode till 1 för anpassade grupper. Attributet userGroups returnerar enbart anpassade grupper som användaren tillhör.

   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. Ladda data. En tabell skapas i datamodellen och visar vart och ett av attributen i enskilda fält.

Nu kan du använda attributfälten i visualiseringar, som tabeller eller text- och bildobjekt.

Du kan ange funktionen direkt i diagramuttryck utan att använda någon variabel. Användarattributen uppdateras utan att appen behöver laddas om. Detta möjliggör smidigare förflyttning av appar mellan användare som en del av appens livscykel.

Gör följande:

1. Skapa en ny Qlik Sense-app.

2. Öppna ett nytt ark i avancerat redigeringsläge.

3. Dra ett text- och bildobjekt till arket.

4. Klicka inuti det tomma diagrammet och ange följande etikett:

   User Email:

5. Välj lägg till mått i egenskaps-panelen.

6. Ange följande uttryck:

   • =GetUserAttr('userEmail')

7. Lägg till etiketter och mått för de andra attributen på nya rader. Använd följande uttryck för varje attribut:

   • =GetUserAttr('userSubject'), för användarens ämne

   • =GetUserAttr('userGroups'), för användargrupper

   • =GetUserAttr('userLocale'), för användarens plats

   • =GetUserAttr('userZoneinfo'), för uppgifter om användarens zon​

Översikt

I det här exemplet visas eller döljs en kolumn i en tabell baserat på domänen för användarens e-postadress.

Gör följande:

1. Skapa en ny Qlik Sense-app.

2. Öppna dataladdningsredigeraren och lägg till laddningsskriptet nedan i ett nytt delavsnitt. Laddningsskriptet innehåller:

   • En datauppsättning läses in i en tabell som heter Transactions.

   • Följande fält i datatabellen:

     • ID

     • Date

     • Amount

     Laddningsskript

     Transactions:
     Load * inline [
     ID, Date, Amount
     1, 1/1/2023, 500.67
     2, 1/2/2023, 458.91
     3, 1/3/2023, 12.34
     ];

3. Ladda data och öppna ett ark. Skapa en ny tabell och lägg till dessa fält som dimensioner:

   • ID

   • Date

   • Amount

   Lägg till följande uttryck som en beräknad dimension:

   • =WildMatch(GetUserAttr('userEmail'),'*@qlik.com')>0, för att kontrollera om användarens e-postdomän matchar @qlik.com.

4. I egenskapspanelen för dimensionen Amount, under Visa kolumn om, lägger du till följande uttryck:

   • =WildMatch(GetUserAttr('userEmail'),'*@qlik.com')>0, för att visa kolumnen Belopp om användarens e-postadress matchar domänen qlik.com.

   Uttrycket kommer endast att visa kolumnen Amount för de användare med en e-postadressdomän innehåller @qlik.com. Kolumnen kommer att vara dold för användare med andra domännamn.

I det här exemplet kan du se hur funktionen GetUserAttr används för att villkorligt dölja eller visa en viss kolumn. Kolumnen Amount visas i den första tabellen eftersom e-postadressen för den användare som visar appen innehåller domänen @qlik.com, och uttrycket för dimensionen i kolumn 4 returnerar -1. Kolumnen Amount är dold från resultaten i den andra tabellen eftersom användaren inte har någon e-postadress med domänen qlik.com.