GetUserAttr - fonction de script et fonction de graphique

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 :

1. Créez une application Qlik Sense.

2. Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à une nouvelle section. 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.

   • Instruction de script qui attribue la valeur 2 à la variable système QlikCloudGroupMode. L'attribut userGroups renverra les groupes d'IdP et les groupes personnalisés auxquels appartient l'utilisateur.

   • Série de définitions de variable de script, pour les attributs disponibles que la fonction GetUserAttr peut renvoyer.

   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. Chargez les données et ouvrez une nouvelle feuille en mode d'édition avancé.

4. 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

• =vUserLocale

• =vUserZoneinfo

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.

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 :

1. Créez une application Qlik Sense.

2. Ouvrez une nouvelle feuille en mode d'édition avancé

3. Ouvrez la boîte de dialogue Variables.

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

• Paramètres régionaux de l'utilisateur

  • Nom : vUserLocale

  • Définition : =GetUserAttr('userLocale')

• Zoneinfo de l'utilisateur

  • Nom : vUserZoneinfo

  • Définition : =GetUserAttr('userZoneinfo')

5. 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)

• =vUserLocale

• =vUserZoneinfo

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.

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 :

1. Créez une application Qlik Sense.

2. Ouvrez l'éditeur de chargement de données et ajoutez le script de chargement ci-dessous à une nouvelle section. Le script de chargement contient :

   • Nouvelle table, appelée Attributes, contenant chaque attribut sous forme de champ.

   • Instruction de script qui attribue la valeur 1 à la variable système QlikCloudGroupMode pour les groupes personnalisés. L'attribut userGroups renverra uniquement les groupes personnalisés auxquels appartient l'utilisateur.

   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. 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.

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 :

1. Créez une application Qlik Sense.

2. Ouvrez une nouvelle feuille en mode d'édition avancé

3. Faites glisser un objet Texte et image sur la feuille.

4. Cliquez à l'intérieur du graphique vide et saisissez l'étiquette suivante :

   E-mail de l'utilisateur :

5. Dans le panneau des propriétés, sélectionnez Ajouter une mesure.

6. Saisissez l'expression suivante :

   • =GetUserAttr('userEmail')

7. Ajoutez des étiquettes et des mesures pour les autres attributs 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

   • =GetUserAttr('userLocale'), pour les paramètres régionaux de l'utilisateur

   • =GetUserAttr('userZoneinfo'), pour Zoneinfo de l'utilisateur​