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. Öppn skriptredigeraren och lägg till laddningsskriptet nedan till en ny flik. 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.

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

   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');

3. Läs in dina data och öppna ett nytt ark i avancerat redigeringsläge.

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

• =vUserEmail

• =vUserSubject

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

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')

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

• =vUserEmail

• =vUserSubject

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

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. Öppn skriptredigeraren och lägg till laddningsskriptet nedan till en ny flik. Laddningsskriptet innehåller:

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

   Attributes:
   Load RowNo() as Key,
   GetUserAttr('userEmail') as UserEmail,
   GetUserAttr('userSubject') as UserSubject,
   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 dessa attributfält 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, User Subject och User Groups, 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​