GetUserAttr - fonction de script et fonction de graphique
La fonction GetUserAttr() renvoie les informations suivantes pour l'utilisateur qui accède à une application :
L'adresse e-mail de l'utilisateur.
L'objet de l'utilisateur.
Les groupes de fournisseurs d'identité (IdP) auxquels l'utilisateur appartient.
Utilisez la fonction GetSysAttr() directement dans le script de chargement ou dans une expression de graphique. Dans l'un ou l'autre cas, vous pouvez utiliser la fonction pour stocker des attributs dans une variable ou directement sans variable. Si vous utilisez cette fonction dans Qlik Sense Client-Managed, elle renvoie uniquement des valeurs de données vides. Par conséquent, vous pouvez utiliser la fonction pour développer des scripts dans Qlik Sense Client-Managed sans rencontrer d'erreurs, dans l'intention de charger ultérieurement les applications dans Qlik Cloud.
GetUserAttr(name)
double
Arguments
Argument
Description
name
Nom de l'attribut à renvoyer. Saisissez cette valeur sous forme de chaîne dans l'expression. La valeur de chaîne saisie est sensible à la casse.
Utilisez la fonction pour charger des attributs utilisateur dans votre application. La fonction peut renvoyer les attributs suivants :
Attributs utilisateur susceptibles d'être renvoyés par la fonction GetUserAttr()
Attribut
Description
Exemple de variable de script de chargement
Exemple d'expression de graphique (sans variable)
Exemple de résultats d'expression de graphique
userEmail
E-mail de l'utilisateur actif.
Let vUserEmail = GetUserAttr('userEmail')
=GetUserAttr('userEmail')
john.doe@company.com
userSubject
Objet de l'utilisateur actif.
Let vUserSubject = GetUserAttr('userSubject')
=GetUserAttr('userSubject')
00uss7ra3dk9doJln0x7
userGroups
Groupes d'IdP de l'utilisateur actif accédant à l'application. Renvoie une liste séparée par des virgules dans une chaîne.
Let vUserGroups = GetUserAttr('userGroups')
=GetUserAttr('userGroups')
Sales,Product-Lead,OKTA-Github-RnD
Cas d'utilisation
Cette fonction renvoie les propriétés utilisateur et les groupes d'utilisateurs de l'utilisateur actif de l'application. Cela vous permet d'élaborer des solutions qui personnalisent le contenu qui apparaît à vos utilisateurs. Par exemple, dans une application commerciale globale, vous pouvez afficher des feuilles spécifiques à des produits aux seuls représentants commerciaux chargés d'un groupe de produits en particulier. Utilisez la fonction dans des instructions LOAD dans le script de chargement de l'application ou dans des expressions de graphique, soit directement sous forme d'expression, soit dans une expression stockée sous forme de variable.
Exemple - Stockage des attributs utilisateur sous forme de variables dans le script
Cet exemple définit un ensemble de variables de script qui peuvent être utilisées dans le contenu de l'application que vous créez. À chaque chargement de l'application, les attributs sont évalués et ajoutés à l'application.
Procédez comme suit :
Créez une application Qlik Sense.
Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet. Le script de chargement contient :
Nouvelle table, appelée Transactions, avec des échantillons de données de transaction. Elles peuvent être remplacées par n'importe quelles données et sont ajoutées comme paramètres fictifs.
Série de définitions de variable de script, pour les attributs disponibles que la fonction GetUserAttr peut renvoyer.
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');
Chargez les données et ouvrez une nouvelle feuille en mode d'édition avancé.
Créez un objet Table et ajoutez les expressions suivantes sous forme de dimensions :
=vUserEmail
=vUserSubject
=vUserGroups, ce qui renvoie une liste séparée par des virgules dans une chaîne
Note ConseilVous pouvez ajouter une étiquette de dimension telle que E-mail de l'utilisateur pour améliorer la lisibilité lorsque vous créez la dimension.
La sortie de la table affiche dynamiquement les attributs utilisateur disponibles. Le tableau suivant montre un exemple de résultats renvoyés à l'aide de la fonction GetUserAttr.
Tableau de résultats
=vUserEmail
=vUserSubject
=vUserGroups
john.doe@company.com
00uss7ra3dk9doJln0x7
Sales,Product-Lead,OKTA-Github-RnD
Exemple – Stockage d'attributs utilisateur sous forme de variables et leur utilisation dans des expressions de graphique
Dans cet exemple, au lieu de définir des variables dans le script de chargement, les variables sont définies dans l'application. Une fois définies, les variables peuvent être utilisées dans des expressions de graphique dans l'application. Le principal avantage de l'utilisation de la fonction dans des expressions de graphique réside dans le fait que les attributs seront automatiquement actualisés sans qu'il soit nécessaire d'actualiser l'application. Cela permet le déplacement plus fluide des applications entre utilisateurs dans le cadre du cycle de vie de l'application.
Procédez comme suit :
Créez une application Qlik Sense.
Ouvrez une nouvelle feuille en mode d'édition avancé
Ouvrez la boîte de dialogue Variables.
Sélectionnez Créer, puis procédez comme suit :
Sous Nom, saisissez vUserEmail.
Sous Définition, saisissez =GetUserAttr('userEmail').
Sélectionnez Créer.
Une variable d'application est créée pour afficher l'adresse e-mail de l'utilisateur. Répétez cette étape pour créer une variable pour les attributs restants à l'aide des paramètres suivants :
Objet de l'utilisateur
Nom : vUserSubject
Définition : =GetUserAttr('userSubject')
Groupes d'utilisateurs
Nom : vUserGroups
Définition : =GetUserAttr('userGroups')
Créez un objet Table et ajoutez les expressions suivantes sous forme de dimensions :
=vUserEmail
=vUserSubject
=vUserGroups (renvoie une liste séparée par des virgules dans une chaîne)
Note ConseilVous pouvez ajouter une étiquette de dimension telle que E-mail de l'utilisateur pour améliorer la lisibilité lorsque vous créez la dimension.
La sortie de la nouvelle table affiche dynamiquement les attributs utilisateur disponibles. Le tableau suivant montre un exemple de résultats renvoyés par la fonction GetUserAttr.
Tableau de résultats
=vUserEmail
=vUserSubject
=vUserGroups
john.doe@company.com
00uss7ra3dk9doJln0x7
Sales,Product-Lead,OKTA-Github-RnD
Exemple – Utilisation de la fonction GetUserAttr dans le script de chargement
Vous pouvez également utiliser la fonction dans vos applications sans variable. Cet exemple montre comment charger une table avec chaque attribut sous forme de champ individuel. Ensuite, vous pouvez créer des visualisations dans l'application pour afficher ces détails.
Procédez comme suit :
Créez une application Qlik Sense.
Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à un nouvel onglet. Le script de chargement contient :
Nouvelle table, appelée Attributes, contenant chaque attribut sous forme de champ.
Attributes:
Load RowNo() as Key,
GetUserAttr('userEmail') as UserEmail,
GetUserAttr('userSubject') as UserSubject,
GetUserAttr('userGroups') as UserGroups autogenerate 1;
Chargez les données. Une table est créée dans le modèle de données qui affiche chacun des attributs dans des champs individuels.
Vous pouvez maintenant utiliser les champs d'attribut dans des visualisations comme des tables ou des objets Texte et image.
Exemple – Utilisation de la fonction GetUserAttr dans des expressions de graphique
Vous pouvez saisir la fonction directement dans des expressions de graphique sans utiliser de variable. Les attributs utilisateur seront actualisés sans qu'il soit nécessaire d'actualiser l'application. Cela permet le déplacement plus fluide des applications entre utilisateurs dans le cadre du cycle de vie de l'application.
Procédez comme suit :
Créez une application Qlik Sense.
Ouvrez une nouvelle feuille en mode d'édition avancé
Faites glisser un objet Texte et image sur la feuille.
Cliquez à l'intérieur du graphique vide et saisissez l'étiquette suivante :
E-mail de l'utilisateur :
Dans le panneau des propriétés, sélectionnez Ajouter une mesure.
Saisissez l'expression suivante :
=GetUserAttr('userEmail')
Ajoutez des étiquettes et des mesures pour les autres attributs, User Subject et User Groups, sur de nouvelles lignes. Utilisez les expressions suivantes pour chaque attribut :
=GetUserAttr('userSubject'), pour l'objet de l'utilisateur
=GetUserAttr('userGroups), pour les groupes d'utilisateurs
Cette page vous a-t-elle aidé ?
Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – dites-nous comment nous améliorer !