GetUserAttr - Skript- und Diagrammfunktion

In diesem Beispiel wird eine Reihe von Skriptvariablen definiert, die in den von Ihnen erstellten App-Inhalten verwendet werden können. Bei jedem Laden der App werden die Attribute ausgewertet und zur App hinzugefügt.

Gehen Sie folgendermaßen vor:

1. Erstellen Sie eine neue Qlik Sense App.

2. Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in einen neuen Abschnitt ein. Das Ladeskript umfasst:

   • Eine neue Tabelle mit dem Namen Transactions mit Beispieltransaktionsdaten. Sie kann durch beliebige Daten ersetzt werden und wird als Platzhalter hinzugefügt.

   • Eine Skript-Anweisung, die die Systemvariable QlikCloudGroupMode auf 2 festlegt. Das Attribut userGroups gibt sowohl die IdP- als auch die benutzerdefinierten Gruppen zurück, zu denen der Benutzer gehört.

   • Eine Reihe von Skriptvariablendefinitionen für die verfügbaren Attribute, die von der Funktion GetUserAttr() zurückgegeben werden können.

   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. Laden Sie die Daten und öffnen Sie ein neues Arbeitsblatt im erweiterten Bearbeitungsmodus.

4. Erstellen Sie ein Tabellen-Objekt und fügen Sie die folgenden Formeln als Dimensionen hinzu:

• =vUserEmail

• =vUserSubject

• =vUserGroups – gibt eine kommagetrennte Liste in einem String zurück

• =vUserLocale

• =vUserZoneinfo

Die Ausgabe in der Tabelle zeigt die verfügbaren Benutzerattribute dynamisch an. Die folgende Tabelle zeigt ein Beispiel für die Ergebnisse, die von der Funktion GetUserAttr zurückgegeben werden.

In diesem Beispiel werden die Variablen nicht im Ladeskript, sondern in der App definiert. Anschließend können diese Variablen in Diagrammformeln in der App verwendet werden. Der Hauptvorteil der Verwendung der Funktion in Diagrammformeln besteht darin, dass die Attribute automatisch aktualisiert werden, ohne dass Sie die App neu laden müssen. Dies ermöglicht einen reibungsloseren Wechsel von Apps zwischen Benutzern im Rahmen des Lebenszyklus einer App.

Gehen Sie folgendermaßen vor:

1. Erstellen Sie eine neue Qlik Sense App.

2. Öffnen Sie ein neues Arbeitsblatt im erweiterten Bearbeitungsmodus.

3. Öffnen Sie das Dialogfeld „Variablen“.

4. Wählen Sie Neu erstellen aus und gehen Sie dann wie folgt vor:

   • Geben Sie unter NamevUserEmail ein.

   • Geben Sie unter Definition =GetUserAttr('userEmail') ein.

   • Wählen Sie Erstellen aus.

Es wird eine App-Variable erstellt, um die E-Mail-Adresse des Benutzers anzuzeigen. Wiederholen Sie diesen Schritt, um eine Variable für die übrigen Attribute mit den folgenden Parametern zu erstellen:

• Benutzerbetreff

  • Name: vUserSubject

  • Definition: =GetUserAttr('userSubject')

• Benutzergruppen

  • Name: vUserGroups

  • Definition: =GetUserAttr('userGroups')

• Gebietsschema des Benutzers

  • Name: vUserLocale

  • Definition: =GetUserAttr('userLocale')

• Zoneninformationen des Benutzers

  • Name: vUserZoneinfo

  • Definition: =GetUserAttr('userZoneinfo')

5. Erstellen Sie ein Tabellen-Objekt und fügen Sie die folgenden Formeln als Dimensionen hinzu:

• =vUserEmail

• =vUserSubject

• =vUserGroups (gibt eine kommagetrennte Liste in einem String zurück)

• =vUserLocale

• =vUserZoneinfo

Die Ausgabe in der neuen Tabelle zeigt die verfügbaren Benutzerattribute dynamisch an. Die folgende Tabelle zeigt ein Beispiel für die Ergebnisse, die von der Funktion GetUserAttr zurückgegeben werden.

Sie können die Funktion in Ihren Apps auch ohne Variable verwenden. Dieses Beispiel zeigt, wie Sie eine Tabelle mit jedem Attribut als einzelnes Feld laden können. Von hier aus können Sie Visualisierungen in der App erstellen, um diese Details anzuzeigen.

Gehen Sie folgendermaßen vor:

1. Erstellen Sie eine neue Qlik Sense App.

2. Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in einen neuen Abschnitt ein. Das Ladeskript umfasst:

   • Eine neue Tabelle mit dem Namen Attributes, die jedes Attribut als Feld enthält.

   • Eine Skript-Anweisung, die die Systemvariable QlikCloudGroupMode für benutzerdefinierte Gruppen auf 1 festlegt. Das Attribut userGroups gibt nur die benutzerdefinierten Gruppen zurück, zu denen der Benutzer gehört.

   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. Laden Sie die Daten. Im Datenmodell wird eine Tabelle erstellt, die jedes der Attribute als einzelnes Feld anzeigt.

Jetzt können Sie die Attributfelder in Visualisierungen wie Tabellen oder „Text und Bild“-Objekten verwenden.

Sie können die Funktion direkt in Diagrammformeln eingeben, ohne eine Variable zu verwenden. Die Benutzerattribute werden aktualisiert, ohne dass Sie die App neu laden müssen. Dies ermöglicht einen reibungsloseren Wechsel von Apps zwischen Benutzern als Teil des App-Lebenszyklus.

Gehen Sie folgendermaßen vor:

1. Erstellen Sie eine neue Qlik Sense App.

2. Öffnen Sie ein neues Arbeitsblatt im erweiterten Bearbeitungsmodus.

3. Ziehen Sie ein „Text und Bild“-Objekt auf das Arbeitsblatt.

4. Klicken Sie in das leere Diagramm und geben Sie die folgende Beschriftung ein:

   Benutzer-E-Mail:

5. Wählen Sie im Eigenschaftsfenster Kennzahl hinzufügen aus.

6. Geben Sie die folgende Formel ein:

   • =GetUserAttr('userEmail')

7. Fügen Sie Bezeichnungen und Kennzahlen für die anderen Attribute in neuen Zeilen hinzu. Verwenden Sie die folgenden Formeln für jedes Attribut:

   • =GetUserAttr('userSubject') für den Benutzerbetreff

   • =GetUserAttr('userGroups) für Benutzergruppen

   • =GetUserAttr('userLocale') für Gebietsschema des Benutzers

   • =GetUserAttr('userZoneinfo') für Zoneninformationen des Benutzers​