Configurer des composants Lightning Web pour Tableau et l’authentification transparente

S’applique à : Tableau Cloud, Tableau Server

Les composants Lightning Web (LWC) pour Tableau permettent aux clients Salesforce de faire glisser et déposer des vues Tableau et des métriques Tableau Pulse sur les pages Lightning dans Salesforce.

  • Le composant pour la vue Tableau vous permet d’ajouter des vues intégrées à partir de Tableau Cloud ou Tableau Server.
  • Le composant Tableau Pulse vous permet d’ajouter des métriques Tableau Pulse intégrées à partir de Tableau Cloud.

L’authentification transparente du composant Lightning Webpour Tableau vous permet de visualiser le contenu Tableau à l’aide de jetons de confiance de l’application connectée sans avoir à vous connecter. L’authentification transparente est facultative pour le composant Lightning Web pour la vue Tableau et obligatoire pour le composant Lightning Web pour Tableau Pulse.

Ajouter une URL de confiance

Ajoutez en tant qu’URL de confiance la vue Tableau ou l’URL Pulse que vous souhaitez ajouter à votre page Lightning.

  1. Depuis votre application Salesforce, sélectionnez l’icône en forme d’engrenage dans le coin supérieur droit, puis sélectionnez Installation.
  2. Dans le volet de navigation gauche, entrez « URL de confiance » dans la barre de recherche Recherche rapide.
  3. Sélectionnez la page des paramètres URL de confiance.
  4. Sélectionnez Nouvel URL de confiance.
  5. Entrez un Nom d’API et un URL en suivant les instructions sur la page des paramètres. Remarque : L’URL doit commencer par https://
  6. Pour Contexte CSP, sélectionnez Tous.
  7. Pour Directives CSP, cochez toutes les cases.
  8. Sélectionnez Enregistrer.

Activer les composants Lightning Web pour Tableau et configurer l’authentification transparente

Configurer les paramètres Salesforce

Les étapes suivantes ne doivent être effectuées qu’une seule fois par un administrateur Salesforce :

  1. Depuis votre application Salesforce, sélectionnez l’icône en forme d’engrenage dans le coin supérieur droit, puis sélectionnez Installation.
  2. Dans le volet de navigation gauche, entrez « Tableau » dans la barre de recherche Recherche rapide.
  3. Sélectionnez la page des paramètres Intégration de Tableau .
  4. Cochez les cases Activer les composants Lightning Web pour Tableau et Activer l’authentification unique basée sur un jeton.

    Remarque : Ces deux cases doivent être cochées pour configurer le composant Lightning Web pour Tableau Pulse. Pour le composant Lightning Web pour la vue Tableau, vous pouvez choisir de ne pas configurer l’authentification par jeton et de vous connecter manuellement lors du chargement du composant.

    Pour utiliser le composant Lightning Web pour la vue Tableau sur Tableau Mobile, vous devez activer l’authentification par jeton et configurer l’authentification transparente.

  5. Pour le champ Sélectionner l’identité de l’utilisateur Tableau, définissez un champ utilisateur au niveau de l’entreprise afin d’authentifier l’utilisateur dans Tableau. Vous devez sélectionner le champ utilisateur Salesforce qui correspond au nom d’utilisateur Tableau. La liste déroulante affiche la valeur du champ pour l’utilisateur actuel, ou une valeur nulle si aucune valeur n’est définie. Si aucun des champs utilisateur ne correspond au nom d’utilisateur Tableau, sélectionnez un champ vide (par exemple, ID de fédération ou un champ personnalisé). Ensuite, remplissez le nom d’utilisateur Tableau de vos utilisateurs dans le champ vide.

    Remarque : La configuration du champ Identité de l’utilisateur Tableau s’applique à tous les utilisateurs et n’a pas besoin d’être définie individuellement.

  6. Enregistrez vos modifications.
  7. Si vous êtes l’administrateur Tableau, gardez l’onglet Intégration de Tableau des paramètres Salesforce ouvert pendant que vous configurez les paramètres Tableau dans la section suivante. Si vous n’êtes pas l’administrateur, partagez l’URL de l’émetteur et l’URI JWKS avec votre administrateur Tableau.

Configurer les paramètres Tableau

Dans un onglet, accédez à la page des paramètres Intégration de Tableau de votre entreprise Salesforce. Dans un autre onglet, accédez à votre site Tableau et suivez les instructions ci-après pour configurer l’application connectée.

Pour Tableau Server, suivez les étapes ci-après :

  1. Connectez-vous à l’interface Web de Tableau Services Manager (TSM) en tant qu’administrateur Tableau Server.
  2. Accédez à Identité de l’utilisateur et accès, puis sélectionnez l’onglet Serveur d’autorisation.
  3. Cochez la case Activer l’accès OAuth pour le contenu intégré.
  4. Entrez l’URL de l’émetteur et l’URI JWKS, disponibles sur la page des paramètres Intégration de Tableau de l’entreprise Salesforce. Utilisez le bouton Copier de la page des paramètres de l’entreprise Salesforce pour copier la valeur de l’URL de l’émetteur, puis collez-la dans l’interface Web de TSM. Répétez ce processus pour la valeur URI JWKS.

    5. Remarque : Le champ URI JWKS est indiqué comme facultatif dans l’interface Web de TSM, mais cette valeur est requise dans le cadre de l’authentification transparente LWC de Tableau.

  5. Sélectionnez Enregistrer les modifications en attente.
  6. Dans le coin supérieur droit de la page, sélectionnez Modifications en attente, puis sélectionnez Appliquer les modifications et redémarrer pour arrêter et redémarrer Tableau Server.

Pour plus d’information, consultez Enregistrer votre EAS auprès de Tableau Server(Le lien s’ouvre dans une nouvelle fenêtre).

Pour Tableau Cloud, suivez les étapes ci-après :

  1. Ouvrez la page Paramètres de Tableau, puis choisissez l’onglet Applications connectées.
  2. Dans la liste déroulante Nouvelle application connectée, sélectionnez Authentification Oauth 2.0.
  3. Dans la boîte de dialogue Créer une application connectée, entrez l’URL de l’émetteur et l’URI JWKS, disponibles sur la page des paramètres Intégration des vues Tableau de l’entreprise Salesforce. Utilisez le bouton Copier de la page des paramètres de l’entreprise Salesforce pour copier la valeur de l’URL de l’émetteur, puis collez-la dans la page des paramètres de Tableau. Répétez ce processus pour la valeur URI JWKS.

    4. Important : La boîte de dialogue Créer une application connectée indique que le champ URI JWKS est facultatif, mais cette valeur est requise dans le cadre de l’authentification transparente LWC de Tableau.

  4. Cochez la case Activer l’application connectée.
  5. Sélectionnez Créer.

    6. Remarque : L’application connectée est désignée Serveur d’autorisation externe.

Pour plus d’information, consultez Enregistrer votre EAS auprès de Tableau Cloud(Le lien s’ouvre dans une nouvelle fenêtre).

Si vous souhaitez créer un mappage d’hôte pour ce site, ne fermez pas l’onglet Applications connectées. Vous pouvez utiliser l’URL de cette page et le bouton Copier l’ID de site pour remplir les champs de mappage d’hôte dans la section suivante.

Configurer ou modifier le mappage d’hôte

Suivez ces étapes pour créer ou modifier un mappage d’hôte.

Conseil : La configuration du champ Identité de l’utilisateur Tableau s’applique à tous les utilisateurs et n’a pas besoin d’être définie individuellement.

Créer un nouveau mappage d’hôte

  1. Depuis votre application Salesforce, sélectionnez l’icône en forme d’engrenage dans le coin supérieur droit, puis sélectionnez Installation.
  2. Dans le volet de navigation gauche, entrez « Tableau » dans la barre de recherche Recherche rapide.
  3. Sélectionnez la page des paramètres Intégration de Tableau .
  4. Dans la section Mappage d’hôte Tableau, sélectionnez Créer un nouveau.
  5. Remplissez les détails du mappage d’hôte :
    1. URL de site Tableau : entrez une URL pour le site Tableau que vous souhaitez mapper. L’URL doit contenir le nom de site, sauf s’il s’agit d’une installation sur site utilisant le site par défaut. Remarque : Si vous souhaitez créer un mappage d’hôte pour ce site, ne fermez pas l’onglet Applications connectées. Vous pouvez utiliser l’URL de cette page et le bouton Copier l’ID de site pour remplir les champs de mappage d’hôte dans la section suivante.
    2. ID de site Tableau : entrez un identifiant de site pour le site Tableau que vous souhaitez mapper. Vous pouvez utiliser le bouton Copier l’ID de site sur la page des paramètres Applications connectées ou sur la boîte de dialogue Partager.
    3. Type d’hôte de site Tableau : sélectionnez Tableau Cloud ou Tableau Server.
  6. Sélectionnez Enregistrer. Pour revenir à la page des paramètres Intégration de Tableau sans enregistrer, sélectionnez Annuler.

Modifier un mappage d’hôte

Vous pouvez mettre à jour l’ID de site et le type d’hôte pour un mappage existant. Si vous devez modifier l’URL du site, supprimez le mappage existant, puis créez-en un nouveau avec l’URL correct.
  1. Dans la page des paramètres Intégration de Tableau de l’application Salesforce, sélectionnez Modifier en regard d’un mappage d’hôte existant.
  2. Modifiez les champs ID de site Tableau ou Type d’hôte de site Tableau selon vos besoins.
  3. Sélectionnez Enregistrer. Pour revenir à la page des paramètres Intégration de Tableau sans enregistrer, sélectionnez Annuler.

Ajouter des composants Lightning Web pour Tableau à une page Lightning à l’aide du générateur d’application Lightning

Les composants Lightning Web pour Tableau sont accessibles uniquement sur les pages d’application, d’accueil et d’enregistrements Lightning. Pour en savoir plus sur les types de pages Lightning et l’utilisation du générateur d’application Lightning, consultez la section Générateur d’application Lightning dans l’aide de Salesforce.

Pour ajouter un composant Lightning Web pour la vue Tableau ou un composant Lightning Web pour Tableau Pulse à une page Lightning existante, procédez comme suit :

  1. Accédez à la page Lightning que vous souhaitez modifier.
  2. Sélectionnez l’icône en forme d’engrenage en haut à droite.
  3. Sélectionnez la page Modifier.
  4. Passez à la section Ajouter un composant Lightning Web pour Tableau à une page Lightning ci-dessous.

Pour ajouter un composant Lightning Web pour la vue Tableau ou un composant Lightning Web pour Tableau Pulse à une nouvelle page Lightning, procédez comme suit :

  1. Depuis votre application Salesforce, sélectionnez l’icône en forme d’engrenage dans le coin supérieur droit, puis sélectionnez Installation.
  2. Dans le volet de navigation gauche, tapez « Générateur d’application Lightning » dans la barre de recherche Recherche rapide.
  3. Sélectionnez la page de configuration du Générateur d’application Lightning.
  4. Sélectionnez Nouveau.
  5. Sélectionnez le type de page que vous souhaitez créer. Les composants Lightning Web pour Tableau sont accessibles sur les pages d’application, d’accueil et d’enregistrements.
  6. Sélectionnez Suivant.
  7. Entrez un nom et sélectionnez une mise en page pour la nouvelle page, puis sélectionnez Terminé.

Ajouter un composant Lightning Web pour Tableau à une page Lightning

  1. Dans la liste Composants à gauche de la page, faites glisser et déposer le composant pour la vue Tableau ou pour Tableau Pulse sur la page.
  2. Configurer le composant Lightning Web :

Enregistrer et activer la page

  1. Après avoir ajouté et configuré un composant Lightning Web pour la vue Tableau ou pour Tableau Pulse, sélectionnez Enregistrer.
  2. Si vous avez créé une nouvelle page, il vous sera demandé d’activer la page afin qu’elle soit visible par les utilisateurs. Sélectionnez Activer.
  3. Sur l’onglet Paramètres de page de la page Activation, entrez un nom, choisissez une icône et sélectionnez votre préférence d’affichage.
  4. (Facultatif) Sur l’onglet Lightning Experience de la page Activation, vous pouvez ajouter la page à diverses applications Lightning Experience.
  5. (Facultatif) Sur l’onglet Navigation de Tableau Mobile de la page Activation, vous pouvez ajouter la page au menu de navigation de Tableau Mobile.
    Remarque : Le composant Lightning Web pour Tableau Pulse n’est pas disponible dans Tableau Mobile.
  6. Sélectionnez Enregistrer.

Intégrer plusieurs vues Tableau

Vous pouvez intégrer plusieurs vues Tableau sur une page Salesforce Lightning, à condition que toutes les vues proviennent du même site. Tableau ne prend en charge qu’une seule session, et cette session est spécifique au site. La dernière session accordée efface la précédente.

Pour intégrer des vues Tableau provenant de plusieurs sites, vous devez créer une page Lightning distincte, spécifique à chaque site.

Authentification transparente du composant LWC pour vue Tableau sur téléphone mobile

Remarque : Le composant Lightning Web pour la vue Tableau est disponible sur iOS 17.2.1 et ses versions ultérieures. Le composant Lightning Web pour Tableau Pulse n’est actuellement pas disponible sur iOS ou Android.

Observez les bonnes pratiques ci-après afin d’éviter les problèmes pour les utilisateurs mobiles :

  • Type de page Lightning : les utilisateurs mobiles peuvent accéder aux pages d’application et aux pages d’enregistrements, mais pas aux pages d’accueil.

    Remarque : Les pages d’enregistrements doivent être associées à un type d’enregistrement spécifique.

  • Si vous utilisez la même page pour les utilisateurs d’ordinateurs de bureau et de téléphones mobiles, sélectionnez Activation pour vérifier que la page Lightning est définie comme valeur par défaut de l’organisation pour les formats d’ordinateurs de bureau et de téléphones.
  • Envisagez de créer des pages Lightning distinctes pour les ordinateurs de bureau et les téléphones portables afin d’offrir une expérience visuelle personnalisée. La hauteur du composant Vue Tableau est fixe et ne s’adapte pas dynamiquement aux différentes tailles d’écran.
  • Pour ajouter une barre de défilement à une vue, sélectionnez Afficher la barre d’outils dans le volet Propriétés du composant Vue Tableau.
  • Pour le type Page d’application, sélectionnez Activation, puis sélectionnez l’onglet Lightning Experience. Ajoutez votre page à la liste LightningBolt pour faciliter la recherche de la page sur téléphone mobile.
  • Sur le téléphone mobile, iOS bloque le trafic inter-sites par défaut. Ouvrez les paramètres de votre téléphone mobile, sélectionnez Paramètres Salesforce, puis activez Autoriser le suivi inter-sites. Pour plus d’information, consultez Activer le suivi inter-sites(Le lien s’ouvre dans une nouvelle fenêtre).

Résoudre l’authentification transparente du composant LWC pour vue Tableau

Vérifier la configuration de Salesforce et Tableau

  1. Vérifiez que les valeurs de l’URL de l’émetteur et de l’URI JWKS correspondent dans les paramètres Salesforce et Tableau et que l’URI JWKS se termine par un identifiant ou un code.

    • Pour Tableau Cloud, ouvrez la page Intégration de Tableau des Paramètres Salesforce dans un seul onglet. Dans un autre onglet, ouvrez l’onglet Applications connectées des paramètres Tableau. Dans l’onglet Applications connectées, sélectionnez Serveur d’autorisation externe, puis sélectionnez Modifier. Vérifiez que les valeurs de l’URL de l’émetteur et de l’URI JWKS correspondent et que l’URI JWKS se termine par un identifiant ou un code.
    • Pour Tableau Server, ouvrez la page Intégration de Tableau des Paramètres Salesforce dans un seul onglet. Ensuite, connectez-vous à l’interface Web de Tableau Services Manager (TSM), accédez à Identité de l’utilisateur et accès, puis ouvrez l’onglet Serveur d’autorisation.

  2. Vérifier le mappage d’hôte : si vous avez enregistré un mappage d’hôte, vérifiez que l’ID de site et le type d’hôte sont corrects.

Vérifier le jeton JWT

Dans l’éditeur de propriétés du composant Lightning Web pour la vue Tableau, sélectionnez Mode débogage pour vérifier que le jeton JWT fonctionne comme prévu.

  1. Ouvrez les fichiers journaux de la console et copiez le jeton.
  2. Accédez au site Web jwt.io(Le lien s’ouvre dans une nouvelle fenêtre) et collez le jeton dans le champ Codé.
  3. Vérifiez les éléments suivants :
    • L’objet (« obj ») correspond au nom d’utilisateur Tableau.
    • Pour Tableau Cloud, le public (« pub ») est « tableau+ID_site ».
      Pour Tableau Server, le public (« pub ») est « tableau ».
    • La portée (« pté ») inclut à la fois « tableau:views:embed » et « tableau:insights:embed ».
    • Le serveur EAS émetteur (« émet ») est exact.

Vérifier l’activation de la page

Il arrive qu’un utilisateur crée une page Lightning, mais qu’elle ne soit ni activée ni attribuée nulle part, de sorte qu’elle est introuvable par les utilisateurs. Sélectionnez Activation pour vérifier que la page Lightning est définie comme valeur par défaut de l’organisation pour les formats prévus.

Conseil :Lors du débogage, il convient de faire glisser et déposer un composant de texte enrichi sur votre page. Ajoutez une brève description du type de page et de l’URL de la vue que vous essayez d’intégrer. Cela permet de faire en sorte que la page visualisée par l’utilisateur final est bien celle que l’administrateur est en train de modifier.

Confirmer que le composant Lightning Web pour la vue Tableau fonctionne sans authentification transparente (composant Lightning Web pour la vue Tableau uniquement)

  1. Dans le volet Vue Tableau de votre page Lightning, décochez la case Jeton d’authentification par défaut, puis enregistrez les modifications.
  2. Si vous êtes connecté à Tableau dans un autre onglet, déconnectez-vous. Vérifiez que la navigation vers l’URL de la vue vous redirige vers la page de connexion de Tableau. Ne vous connectez-pas.
  3. Accédez à la page Lightning. Un bouton Se connecter à Tableau sera visible sur le composant Lightning Web pour la vue Tableau.
  4. Sélectionnez Se connecter à Tableau, puis entrez vos identifiants de connexion à Tableau.
    Remarque : Si la vue ne se charge pas, cela indique un problème plus global d’authentification à Tableau.

Erreur : la version du composant Lightning Web n’est plus prise en charge (composant Lightning Web pour la vue Tableau uniquement)

Pour résoudre cette erreur, procédez comme suit :

  1. Dans la liste des composants, recherchez « Tableau », faites ensuite glisser-déposer le composant Vue Tableau sur la page.
  2. Copiez toutes les propriétés du volet Vue Tableau de l’ancien composant vers le nouveau composant.
  3. Sélectionnez l’icône de suppression sur l’ancien composant.

Voir également

Dépanner les applications connectées(Le lien s’ouvre dans une nouvelle fenêtre)

Enregistrer EAS de manière à activer l’authentification unique pour le contenu intégré

Retour en haut
Merci de vos commentaires!Votre commentaire s été envoyé avec succès. Merci!