Configurer l’application Tableau pour Microsoft Teams
L’application Tableau pour Microsoft Teams permet à vos utilisateurs d’interagir avec les vues (visualisations) et les métriques Tableau sans quitter leur flux de travail. En tant qu’administrateur Tableau, vous installez et configurez l’application pour connecter votre site Tableau existant à votre déploiement Microsoft Teams. Vous pouvez installer l’application pour Tableau Cloud directement depuis Microsoft Marketplace. Pour installer l’application pour Tableau Server, vous devez télécharger et installer l’application en sideload.
Pour plus d’informations sur l’application Tableau pour Microsoft Teams, consultez Accéder au contenu Tableau dans Microsoft Teams. Cet article traite de la configuration de l’application Tableau.
Voir également
- FAQ sur l’application Tableau sur GitHub(Le lien s’ouvre dans une nouvelle fenêtre)
- Notes de version sur GitHub(Le lien s’ouvre dans une nouvelle fenêtre)
- Didacticiel de prise en main sur Youtube(Le lien s’ouvre dans une nouvelle fenêtre)
Conditions préalables
Pour configurer l’application Tableau pour Microsoft Teams, vous avez besoin des applications et des comptes suivants.
- Tableau Cloud ou Tableau Server à partir de la version 2023.1
- Un compte d’administrateur de site pour Tableau Cloud ou un compte d’administrateur de serveur pour Tableau Server
- Un abonnement Microsoft 365 pour les grandes entreprises
- Microsoft Teams
- Un compte d’administrateur Microsoft 365, si les stratégies de votre organisation exigent un compte d’administrateur pour installer des applications
- Licences utilisateur pour Tableau et Microsoft Teams qui sont mappées les unes aux autres sur la base d’un des attributs de mappage utilisateur
Attributs de mappage utilisateur
Pour permettre l’authentification unique avec Tableau, vous mappez les comptes utilisateur dans Microsoft Teams aux comptes utilisateur dans Tableau. Vous pouvez configurer ce mappage à l’aide d’attributs du SDK Microsoft Teams ou du profil Microsoft Entra d’un utilisateur.
Attributs du SDK Microsoft Teams
| Attribut | Description |
|---|---|
| Preferred_Username(Le lien s’ouvre dans une nouvelle fenêtre) | Adresse e-mail de l’utilisateur Microsoft Teams. Il peut arriver que cette valeur diffère de l’adresse e-mail définie dans Microsoft Entra. |
| User Principal Name(Le lien s’ouvre dans une nouvelle fenêtre) | Principal moyen de connexion des utilisateurs à Microsoft Entra. |
Attributs du profil Microsoft Entra
| Attribut | Description |
|---|---|
| Primary Email(Le lien s’ouvre dans une nouvelle fenêtre) | Correspond à l’attribut user.mail et représente l’adresse e-mail de l’utilisateur. |
| Mail Nickname(Le lien s’ouvre dans une nouvelle fenêtre) | Correspond à l’attribut user.mailNickname et représente l’alias d’un utilisateur. |
| Employee ID(Le lien s’ouvre dans une nouvelle fenêtre) | Correspond à l’attribut user.employeeId et représente un identificateur d’employé attribué par l’entreprise. |
| On-Premise Distinguished Name(Le lien s’ouvre dans une nouvelle fenêtre) | Correspond à l’attribut user.onPremiseDistinguishedName et représente le nom distinctif (DN) synchronisé à partir d’un serveur Active Directory local. |
| On-Premise User Principal Name(Le lien s’ouvre dans une nouvelle fenêtre) | Correspond à l’attribut user.onPremiseUserPrincipalName et représente l’élément userPrincipalName synchronisé à partir d’un serveur Active Directory local. |
| On-premise SAM Account Name(Le lien s’ouvre dans une nouvelle fenêtre) | Correspond à l’attribut user.onPremiseSamAccountName et représente l’élément samAccountName synchronisé à partir d’un serveur Active Directory local. |
| Extension Attribute X(Le lien s’ouvre dans une nouvelle fenêtre) | Microsoft Entra vous permet d’ajouter jusqu’à 15 attributs supplémentaires au profil Entra d’un utilisateur. Si le nom d’utilisateur Tableau n’existe pas dans Microsoft Entra, utilisez un attribut d’extension pour stocker le nom d’utilisateur Tableau pour chaque utilisateur Entra. |
Conditions préalables supplémentaires pour Tableau Server
L’application Tableau utilise des appels d’API pour communiquer avec Tableau Server et intégrer des contenus interactifs. Ces appels doivent pouvoir joindre Tableau Server.
- Si Tableau Server se trouve derrière un pare-feu, autorisez les requêtes HTTP entrantes provenant des plages d’adresses IP 4.152.0.0/15 et 20.2.0.0/16.
- Assurez-vous que les utilisateurs peuvent accéder à Tableau Server de la même manière qu’ils accèdent à Microsoft Teams.
- Si les utilisateurs doivent être sur un VPN pour accéder à Microsoft Teams, Tableau Server doit être accessible à partir du même VPN.
- Si les utilisateurs peuvent accéder à Microsoft Teams depuis l’Internet public, Tableau Server doit être accessible depuis l’Internet public.
- Si les utilisateurs peuvent accéder à Microsoft Teams via des applications mobiles, Tableau Server doit être accessible depuis des appareils mobiles.
Installer l’application Tableau pour Tableau Server
Pour installer l’application Tableau pour Tableau Server, modifiez le fichier manifest de l’application de manière à personnaliser le nom d’hôte, puis téléchargez ce fichier sur Microsoft Teams.
Pour installer l’application Tableau pour Tableau Cloud, consultez le Guide de configuration de Tableau Cloud.
1. Télécharger et modifier le fichier manifest de l’application
- Depuis GitHub, téléchargez le fichier manifest de l’application.
Extrayez les fichiers du fichier manifest
tableau-server-app-for-teams.zip.Ouvrez le fichier
manifest.jsondans un éditeur de texte.Dans le fichier
manifest.json, recherchez*.online.tableau.comet remplacez ce domaine par le nom d’hôte de votre environnement Tableau Server. Si l’URL de votre Tableau Server esthttps://analytics.company.com, le nom d’hôte seraitanalytics.company.com.Enregistrez vos modifications dans
manifest.json.Compressez les fichiers dans le dossier
tableau-app-for-teams-serverpour créer un fichier zip incluant vos modifications.
2. Charger le fichier manifest de l’application
Les stratégies d’application de votre organisation déterminent si vous êtes en mesure d’installer des applications Microsoft Teams. Un compte d’administrateur Microsoft 365 peut être requis pour installer des applications.
Ouvrez le Centre d’administration Microsoft Teams(Le lien s’ouvre dans une nouvelle fenêtre).
Dans le volet de navigation, sélectionnez Applications Teams > Gérer les applications.
Sélectionnez Actions > Charger une nouvelle application.
Chargez le fichier
tableau-server-app-for-teams.zipque vous avez modifié. Vous recevez un message de confirmation avec un lien pour gérer l’application.
3. Installer et épingler l’application pour vos utilisateurs
Vous pouvez installer l’application pour la rendre disponible à tous vos utilisateurs ou un sous-ensemble d’utilisateurs. Vous pouvez également épingler l’application afin qu’elle apparaisse dans la barre d’applications de vos utilisateurs.
Ouvrez le Centre d’administration Microsoft Teams(Le lien s’ouvre dans une nouvelle fenêtre).
Dans le volet de navigation, sélectionnez Applications Teams > Stratégies d’installation.
Sous Applications installées, sélectionnez Ajouter des applications, puis ajoutez l’application Tableau.
Si vous le souhaitez, sous Applications épinglées, sélectionnez Ajouter des applications, puis ajoutez l’application Tableau.
Enregistrez vos modifications.
Après avoir ajouté l’application Tableau, il peut s’écouler jusqu’à 24 heures avant que l’application soit disponible pour vos utilisateurs.
Configurer l’application Tableau
Une fois que vous avez installé l’application Tableau, Microsoft Teams vous invite à configurer l’application. Vous configurez les informations de votre site pour connecter l’application à votre site Tableau.
1. Créer une application connectée
L’application Tableau pour Microsoft Teams utilise une application connectée pour authentifier les utilisateurs avec l’authentification unique. Vous créez cette connexion virtuelle dans Tableau Cloud ou Tableau Server.
Dans Tableau Cloud ou Tableau Server, créez une application connectée avec approbation directe. Pour plus d’informations, consultez Configurer les applications connectées avec l’approbation directe pour Tableau Cloud ou Configurer les applications connectées avec l’approbation directe pour Tableau Server(Le lien s’ouvre dans une nouvelle fenêtre).
- Si vous limitez la liste d’autorisations de domaines pour l’application connectée aux domaines spécifiés uniquement, ajoutez les domaines suivants à la liste d’autorisations.
tableau-ms-teams-prod-gycea7csh5hsbfh5.a02.azurefd.netteams.microsoft.com*.teams.microsoft.com
- Si vos utilisateurs accèdent à l’application à partir d’autres plates-formes Microsoft, ajoutez les domaines supplémentaires à partir de la liste des URL Microsoft 365(Le lien s’ouvre dans une nouvelle fenêtre).
- Si vous limitez la liste d’autorisations de domaines pour l’application connectée aux domaines spécifiés uniquement, ajoutez les domaines suivants à la liste d’autorisations.
Activez l’application connectée.
Générez un secret d’application connectée.
Copiez l’ID client, l’ID du secret et la valeur secrète de l’application connectée. Enregistrez ces valeurs. Vous en aurez besoin lorsque vous configurerez votre site Tableau dans Microsoft Teams.
2. Ajouter votre configuration de site à l’application Tableau
Lorsque vous ouvrez l’application Tableau, si vous n’avez pas encore configuré l’application, un écran de configuration s’affiche.
Pour Étiquette, donnez un nom au site. Ce nom s’affiche pour les utilisateurs de l’application Microsoft Teams. Si vous ne saisissez pas d’étiquette, l’application affiche le nom du site. Ce champ est facultatif.
Dans le champ Nom du site Tableau, saisissez le nom du site tel qu’il apparaît dans l’URL de votre site. Par exemple, pour l’URL
https://us-west-2b.online.tableau.com/#/site/mysitename/home, vous allez entrermysitename. Si vous connectez l’application à Tableau Server et que vous souhaitez utiliser le site par défaut, laissez ce champ vide.Pour l’URL de base, saisissez la partie de l’URL du site qui se termine par
tableau.com, par exemplehttps://us-west-2b.online.tableau.com.Pour Attribut de mappage utilisateur, sélectionnez l’attribut Microsoft Entra utilisé pour authentifier l’utilisateur avec l’authentification unique.
Pour D de l’application connectée, l’ID du secret de l’application connectée et la Valeur du secret de l’application connectée, collez les valeurs que vous avez copiées lors de la création de l’application connectée.
Sélectionnez Ajouter une configuration de site.
L’application Tableau teste la connexion avant d’enregistrer les détails de configuration. La configuration du site ne sera pas ajoutée si l’application ne peut pas se connecter à Tableau. Plusieurs causes peuvent expliquer cet échec : l’application connectée n’est pas en mesure de s’authentifier, l’application connectée n’est pas activée, les informations du site sont incorrectes ou le compte que vous utilisez n’est pas un compte administrateur Tableau. Cela peut également signifier que l’application ne peut pas joindre Tableau Server parce qu’il se trouve derrière un pare-feu.
Ajouter ou supprimer des configurations de site
Après avoir ajouté une configuration de site, vous pouvez ajouter des sites supplémentaires ou supprimer une configuration de site existante.
Dans l’application Tableau pour Microsoft Teams, sélectionnez l’onglet Configuration.
Sous Configuration, sélectionnez l’onglet Configuration du site Tableau. Seuls les administrateurs Tableau peuvent accéder aux paramètres de cet onglet.
Pour ajouter un site, sélectionnez Ajouter les détails du site. Ou, pour supprimer un site, sélectionnez l’icône de suppression de ce site.
