Die Funktion GetUserAttr() gibt die folgenden Informationen für den Benutzer zurück, der auf eine App zugreift:
die E-Mail-Adresse des Benutzers
dem Betreff des Benutzers
die IdP-Gruppen (Identitätsanbietergruppen), zu denen der Benutzer gehört.
Verwenden Sie die Funktion GetUserAttr() direkt im Ladeskript oder in einer Diagrammformel. In beiden Fällen können Sie die Funktion verwenden, um Attribute in einer Variablen oder direkt ohne Variablen zu speichern. Wenn Sie diese Funktion in Qlik Sense Client-Managed verwenden, werden nur leere Datenwerte zurückgegeben. Daher können Sie die Funktion zum Entwickeln von Skripten in Qlik Sense Client-Managed verwenden, ohne dass Fehler auftreten, wenn Sie die Absicht haben, die Apps später an Qlik Cloud hochzuladen.
Syntax:
GetUserAttr(name)
Rückgabe Datentyp: dual
Argumente
Argument
Beschreibung
name
Der Name des Attributs, das zurückgegeben werden soll. Geben Sie ihn als Zeichenfolgenwert in die Formel ein. Beim eingegebenen Zeichenfolgenwert wird die Groß- und Kleinschreibung unterschieden.
Verwenden Sie die Funktion zum Laden von Benutzerattributen in die App. Die Funktion kann die folgenden Attribute zurückgeben:
Benutzerattribute, die von der Funktion GetUserAttr() zurückgegeben werden können
Attribut
Beschreibung
Beispiel einer Ladeskriptvariablen
Beispiel einer Diagrammformel (keine Variable)
Beispiel für Diagrammformelergebnisse
userEmail
Die E-Mail des aktuellen Benutzers
Let vUserEmail = GetUserAttr('userEmail')
=GetUserAttr('userEmail')
john.doe@company.com
userSubject
Der Betreff des aktuellen Benutzers
Let vUserSubject = GetUserAttr('userSubject')
=GetUserAttr('userSubject')
00uss7ra3dk9doJln0x7
userGroups
Die IdP-Gruppen des aktuellen Benutzers, der auf die App zugreift. Gibt eine kommagetrennte Liste als String zurück.
Let vUserGroups = GetUserAttr('userGroups')
=GetUserAttr('userGroups')
Sales,Product-Lead,OKTA-Github-RnD
Verwendung
Diese Funktion gibt Benutzereigenschaften und Gruppen für den aktuellen Benutzer der App zurück. So können Sie Lösungen erstellen, die den für Ihre Benutzer angezeigten Inhalt anpassen. In einer globalen Vertriebsanwendung können Sie beispielsweise produktspezifische Arbeitsblätter nur denjenigen Vertriebsmitarbeitern zeigen, die für eine bestimmte Produktgruppe zuständig sind. Diese Funktion kann in load-Anweisungen im Ladeskript der App oder in Diagrammformeln verwendet werden, entweder direkt als Formel oder in einer als Variable gespeicherten Formel.
Beispiel – Speichern von Benutzerattributen als Variablen im Skript
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:
Erstellen Sie eine neue Qlik Sense App.
Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in eine neue Registerkarte 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 Reihe von Skriptvariablendefinitionen für die verfügbaren Attribute, die von der Funktion GetUserAttr() zurückgegeben werden können.
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');
Laden Sie die Daten und öffnen Sie ein neues Arbeitsblatt im erweiterten Bearbeitungsmodus.
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
TipphinweisSie können zur besseren Lesbarkeit bei der Erstellung der Dimension eine Dimensionsbezeichnung hinzufügen, z. B. Benutzer-E-Mail.
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.
Ergebnistabelle
=vUserEmail
=vUserSubject
=vUserGroups
john.doe@company.com
00uss7ra3dk9doJln0x7
Sales,Product-Lead,OKTA-Github-RnD
Beispiel – Speichern von Benutzerattributen als Variablen und Verwendung der Variablen in Diagrammformeln
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:
Erstellen Sie eine neue Qlik Sense App.
Öffnen Sie ein neues Arbeitsblatt im erweiterten Bearbeitungsmodus.
Öffnen Sie das Dialogfeld „Variablen“.
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')
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)
TipphinweisSie können zur besseren Lesbarkeit bei der Erstellung der Dimension eine Dimensionsbezeichnung hinzufügen, z. B. Benutzer-E-Mail.
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.
Ergebnistabelle
=vUserEmail
=vUserSubject
=vUserGroups
john.doe@company.com
00uss7ra3dk9doJln0x7
Sales,Product-Lead,OKTA-Github-RnD
Beispiel – Verwenden der Funktion GetUserAttr im Ladeskript
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:
Erstellen Sie eine neue Qlik Sense App.
Öffnen Sie den Dateneditor und fügen Sie das Ladeskript unten in eine neue Registerkarte ein. Das Ladeskript umfasst:
Eine neue Tabelle mit dem Namen Attributes, die jedes Attribut als Feld enthält.
Attributes:
Load RowNo() as Key,
GetUserAttr('userEmail') as UserEmail,
GetUserAttr('userSubject') as UserSubject,
GetUserAttr('userGroups') as UserGroups autogenerate 1;
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.
Beispiel – Verwenden der Funktion GetUserAttr in Diagrammformeln
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:
Erstellen Sie eine neue Qlik Sense App.
Öffnen Sie ein neues Arbeitsblatt im erweiterten Bearbeitungsmodus.
Ziehen Sie ein „Text und Bild“-Objekt auf das Arbeitsblatt.
Klicken Sie in das leere Diagramm und geben Sie die folgende Beschriftung ein:
Benutzer-E-Mail:
Wählen Sie im Eigenschaftsfenster Kennzahl hinzufügen aus.
Geben Sie die folgende Formel ein:
=GetUserAttr('userEmail')
Fügen Sie Bezeichnungen und Kennzahlen für die anderen Attribute (User Subject und User Groups) in neuen Zeilen hinzu. Verwenden Sie die folgenden Formeln für jedes Attribut:
=GetUserAttr('userSubject') für den Benutzerbetreff
=GetUserAttr('userGroups) für Benutzergruppen
Hat diese Seite Ihnen geholfen?
Wenn Sie Probleme mit dieser Seite oder ihren Inhalten feststellen – einen Tippfehler, einen fehlenden Schritt oder einen technischen Fehler –, teilen Sie uns bitte mit, wie wir uns verbessern können!