Optimiser les fonctions d’attributs utilisateur (UAF) avec les composants Web Lightning de Tableau
Vous pouvez optimiser les fonctions d’attribut utilisateur (UAF) avec vos composants Web Lightning pour les vues Tableau et pour Tableau Pulse afin d’afficher les données spécifiques en fonction des attributs de l’utilisateur qui consulte une visualisation. Les Fonctions d’attributs utilisateur offrent une sécurité au niveau des lignes afin que les personnes qui consultent votre visualisation ne voient que les données qui les concernent. Pour plus d’informations sur les UAF, consultez Tirer le meilleur parti des analyses personnalisées avec les fonctions d’attributs utilisateur.
Conditions préalables
L’authentification unique (SSO) au moyen de l’authentification par jeton est configurée pour les composants Web Lightning de Tableau. Consultez Configurer les composants Web Lightning pour Tableau et l’authentification unique (SSO) au moyen de l’authentification par jeton.
Tableau est configuré pour capturer les attributs utilisateur dans les flux de travail d’authentification. Consultez Autoriser la capture des attributs utilisateur.
Le contenu Tableau à intégrer comprend les fonctions d’attributs utilisateur. Pour obtenir un exemple d’utilisation des fonctions d’attribut utilisateur dans un classeur Tableau, consultez S’assurer que l’auteur du contenu inclut les fonctions d’attribut utilisateur.
Définitions des revendications d’UAF de Tableau dans Salesforce
Les définitions de revendications d’UAF de Tableau vous permettent d’inclure des revendications pour les attributs utilisateur dans le JWT. Les valeurs de ces attributs peuvent être extraites des objets Compte, Utilisateur, Opportunité ou Cas dans Salesforce. En combinaison avec les fonctions d’attribut utilisateur dans le contenu Tableau, seules les données correspondant aux attributs spécifiés sont affichées.
Par exemple, un tableau de bord Tableau peut être configuré de manière à afficher uniquement les données de vente lorsque la valeur de sa colonne de données [État/province] correspond à l’une des valeurs de la revendication du JWT pour l’attribut « État ».
Syntaxe : USERATTRIBUTEINCLUDES(« nom_d’attribut », valeur attendue)
Exemple : USERATTRIBUTEINCLUDES(« état », [État/province])
La création d’une définition de revendication dans Salesforce peut inclure les informations spécifiques à l’utilisateur concerné dans le JWT. Dans cet exemple, l’attribut « État » peut être renseigné avec des valeurs générées par des comptes dont l’utilisateur actuel est le propriétaire, en extrayant des valeurs du champ État/province de facturation.
Exemple de définition de revendication
Nom de la définition : state_Account_BillingState
Nom de l’attribut : état
Objet cible : Compte
Champ Objet cible : État/province de facturation
Relation objet cible du Viewer : le Viewer actuel est le propriétaire du compte
Dans le cas d’un représentant commercial avec des comptes dans les États de Washington, de l’Oregon et de Californie, le JWT comprendra une revendication pour l’« état » avec les valeurs [WA, OR, CA]. Le tableau de bord Tableau afficherait alors uniquement les données avec des valeurs [État/province] correspondant à WA, OR ou CA.
Créer une définition
Pour créer une définition d’attribut utilisateur, procédez comme suit :
Depuis votre application Salesforce, sélectionnez l’icône en forme d’engrenage dans le coin supérieur droit, puis sélectionnez Installation.
Dans le volet de navigation de gauche, entrez « Tableau » dans la barre de recherche Recherche rapide.
Sélectionnez la page des paramètres Définition des revendications d’UAF de Tableau.
Sélectionnez Créer nouveau.
Renseignez les valeurs de définition :
Nom de la définition : entrez un nom unique. (Exemple : state_Account_BillingState)
Nom d’attribut : entrez le nom d’attribut spécifié par la fonction d’attribut utilisateur dans Tableau. (Exemple : état)
Objet cible : sélectionnez l’objet cible d’où vous souhaitez extraire les valeurs. Les composants Web Lightning pour Tableau prennent actuellement en charge les objets Utilisateur et Compte.
Champ Objet cible : sélectionnez le champ de l’objet cible d’où vous souhaitez extraire les valeurs. (Exemple : État/province de facturation)
Relation Objet cible du Viewer : sélectionnez la relation entre le Viewer actuel et l’objet cible. (Exemple : le Viewer actuel est le propriétaire du compte).
Sélectionnez Enregistrer. Pour revenir à la page des paramètres Définition des revendications d’UAF de Tableau sans enregistrer, sélectionnez Annuler.
Ajouter une définition à une page de composant Web Lightning pour Tableau
Pages d’accueil, d’application et d’enregistrements de Lightning
Pour ajouter une définition :
Sélectionnez Sélectionner….
Utilisez les flèches pour déplacer les définitions disponibles vers le champ Sélectionné.
Sélectionnez OK.
Répétez l’opération pour tous les composants Web Lightning de Tableau sur la même page. Pour plus d’informations, consultez Considérations relatives à plusieurs composants sur une même page.
Pages et barres d’outils Experience Cloud
Entrez une liste de valeurs séparées par des virgules de noms de définitions de revendications d’UAF. Pour copier les noms de définition, dans l’application Salesforce, accédez à la page de configuration Définition de revendications d’UAF de Tableau et sélectionnez Copier.
Considérations relatives à plusieurs composants sur une même page
Si plusieurs composants Web Lightning pour les vues Tableau ou pour Tableau Pulse sont ajoutés à la même page, chaque composant doit utiliser le même ensemble de noms des définitions de fonctions d’attribut utilisateur (UAF). Un seul des composants s’authentifie auprès de Tableau, et cette session permettra de charger les deux composants. Cela signifie que cette session doit contenir les attributs utilisateur pertinents pour les deux composants, quel que soit le composant effectuant l’authentification.
Par exemple :
Si vous avez deux composants pour les vues Tableau, l’un nécessitant les attributs utilisateur de la Définition A et l’autre ceux de la Définition B, les deux composants doivent inclure les Définitions A et B à la fois.
Si un composant pour les vues Tableau nécessite une Définition A, mais le composant Tableau Pulse sur la même page n’a besoin d’aucun attribut utilisateur, les deux composants doivent inclure la Définition A.
Supprimer une définition
Pour supprimer une définition d’attribut utilisateur, procédez comme suit :
Depuis votre application Salesforce, sélectionnez l’icône en forme d’engrenage dans le coin supérieur droit, puis sélectionnez Installation.
Dans le volet de navigation de gauche, entrez « Tableau » dans la barre de recherche Recherche rapide.
Sélectionnez la page des paramètres Définition des revendications d’UAF de Tableau.
Sélectionnez Supprimer pour la définition que vous souhaitez supprimer.
Pages d’accueil, d’application et d’enregistrements de Lightning
Si vous supprimez une définition déjà ajoutée à un composant Web Lightning pour Tableau, actualisez la page dans générateur d’application Lightning pour mettre à jour les définitions disponibles. Les définitions supprimées sont automatiquement supprimées.
Pages et barres d’outils Experience Cloud
Les définitions supprimées ne sont pas automatiquement supprimées du champ Composant Web Lightning pour Tableau. Les définitions supprimées dans le champ de composant Noms des définitions de fonctions d’attribut utilisateur (UAF) ne posent pas de problème, mais créent un encombrement inutile qui prête à confusion. Pour supprimer des définitions du champ de composant Composant Web Lightning pour Tableau, sélectionnez le champ Noms des définitions de fonctions d’attribut utilisateur (UAF) et supprimez manuellement tous les noms qui ne sont plus utilisés.