Configurer le module complémentaire Tableau pour Google Workspace

S’applique à : Tableau Cloud, Tableau Server

Le module complémentaire Tableau pour Google Workspace vous permet d’afficher le contenu Tableau directement dans votre flux de travail et d’interagir avec lui en toute sécurité. Vous pouvez intégrer des instantanés d’images de visualisations Tableau et de métriques Pulse dans Google Docs et Google Slides. Vous pouvez également connecter vos sources de données Tableau Cloud directement à Google Sheets et exporter les données de vos Google Sheets vers Tableau Cloud.

Le module complémentaire est disponible pour Tableau Cloud et Tableau Server, et est disponible sur Google Workspace Marketplace. Les administrateurs Tableau sont responsables de l’installation et de la configuration de l’application pour connecter un site Tableau à un environnement Google Workspace.

Pour plus d’informations sur l’utilisation du module complémentaire Tableau pour Google Workspace, consultez Accéder au contenu Tableau dans Google Workspace.

Conditions préalables

Pour configurer le module complémentaire Tableau pour Google Workspace, vous avez besoin des applications et des comptes suivants :

Tableau Cloud ou Tableau Server
Un compte d’administrateur de site pour Tableau Cloud ou un compte d’administrateur de serveur pour Tableau Server
Un abonnement Google Workspace
Un compte administrateur Google Workspace
Des licences utilisateur pour Tableau et Google Workspace, où l’adresse e-mail Google Workspace de chaque utilisateur correspond à son nom d’utilisateur Tableau

Installer le module complémentaire Tableau

Ouvrez Google Workspace Marketplace et recherchez la liste des modules complémentaires Tableau.

Si le bouton d’installation n’est pas disponible, il est possible que votre administrateur Google Workspace dispose d’une liste d’autorisations définie des modules complémentaires disponibles. Assurez-vous que votre administrateur Google Workspace a ajouté le module complémentaire Tableau à la liste d’autorisations. L’administrateur Google Workspace a aussi la possibilité d’installer automatiquement le module complémentaire pour les utilisateurs en fonction des groupes d’utilisateurs Google.

Si le bouton d’installation est actif, sélectionnez-le, puis ouvrez Google Docs ou Slides dans un nouvel onglet de navigateur. Une fois le module complémentaire installé, vous verrez une icône Tableau dans le volet latéral droit.

Configurer le module complémentaire Tableau

La première fois que vous ouvrez le module complémentaire Tableau, vous êtes invité à autoriser l’accès. Le module complémentaire Tableau a besoin d’accéder à vos fichiers Google Drive (par exemple, Google Docs et Google Slides) pour importer et exporter un contenu depuis Tableau.

Cliquez sur le bouton Authorize Acces (Autoriser l’accès) pour déclencher une notification OAuth, qui décrit les autorisations spécifiques requises.

Après avoir accordé l’accès au module complémentaire Tableau, vous pouvez recevoir une autre invite vous demandant si le module complémentaire peut accéder à ce document ou cette diapositive. Au lieu de demander l’accès à tous les fichiers Drive de l’utilisateur, nous ne demandons que les autorisations sur les fichiers avec lesquels vous souhaitez utiliser le module complémentaire. Sélectionnez Authorize (Autoriser).

Configurer votre site Tableau

La première fois que vous ouvrez le module complémentaire Tableau, vous êtes invité à ajouter une configuration de site. Utilisez ce paramètre pour spécifier le site Tableau Cloud que vous souhaitez intégrer à Google Workspace.

Seuls les utilisateurs disposant de droits d’administrateur sur le site Tableau Cloud peuvent gérer les configurations de site.

Étape 1 : Obtenir des détails sur votre site Tableau

Pour communiquer avec votre site Tableau, assurez-vous d’avoir une application connectée avec approbation directe.
Si ce n’est pas le cas, votre administrateur Tableau doit suivre les instructions pour configurer les applications connectées avec l’approbation directe.
Définissez l’état sur Activé. Vous pouvez ignorer les paramètres de niveau d’accès et de liste d’autorisations de domaines parce que le module complémentaire utilise l’API REST de Tableau.
Collectez l’ID client, l’ID du secret et la valeur secrète de l’application connectée à Tableau. Vous saisirez ces informations lors de la configuration du module complémentaire Tableau.

Étape 2 : Configurer le module complémentaire Tableau

Ouvrez le module complémentaire Tableau dans Google Docs ou Google Slides.
Sélectionnez Ajouter une nouvelle configuration de site et entrez les informations de votre site Tableau et les détails de l’application connectée.
Renseignez les champs de configuration comme décrit dans le tableau suivant.

Propriété	Description
Étiquette	(Facultatif) : Utilisez ce champ pour créer une étiquette conviviale pour le site. Si vous laissez cette propriété vide, le module complémentaire utilise par défaut le nom du site.
URL de base de Tableau	Il s’agit du nom d’hôte de votre site Tableau. Par exemple, si votre site Tableau est accessible à l’adresse https://us-east-1.online.tableau.com/#/site/devplatembed/home, l’URL de base serait https://us-east-1.online.tableau.com.
Site Tableau	Le nom de votre site Tableau est exactement tel qu’il apparaît dans l’URL. Gardez à l’esprit que ce champ est sensible à la casse. Par exemple, dans l’exemple d’URL fourni précédemment, le nom du site est devplatembed. Notez que, du fait des caractères restreints dans les URL, le nom du site peut différer légèrement de son étiquette d’affichage dans Tableau Cloud. Si vous configurez le site par défaut pour une instance de Tableau Server, ce champ doit rester vide.
Mappage des utilisateurs	Ce paramètre détermine la méthode utilisée par le module complémentaire pour authentifier les utilisateurs de Google Workspace dans Tableau. E-mail : lorsque cette option est sélectionnée, le module complémentaire utilise l’adresse e-mail Google Workspace de l’utilisateur comme nom d’utilisateur Tableau Cloud. Other attributes (Autres attributs) : tous les attributs personnalisés que vous avez établis pour vos utilisateurs sont répertoriés ici. Les attributs personnalisés doivent être configurés pour chaque utilisateur Google qui souhaite s’authentifier auprès de Tableau. Consultez Mappage des utilisateurs pour plus de détails.
Case à cocher Domaines	Chaque domaine enregistré dans Google Workspace aura une case à cocher correspondante. Pour plus d’informations, reportez-vous à la section Domaines.
Identifiants de l’application connectée	Les détails du site Tableau que vous avez rassemblés à l’étape 1. Entrez l’ID client, l’ID du secret et la valeur secrète de l’application connectée à Tableau.

Sélectionnez Enregistrer et actualisez la page Web.

La prochaine fois que vous ouvrez le module complémentaire Tableau, un menu déroulant affiche la liste des sites configurés.

Pour commencer à utiliser le module complémentaire Tableau, sélectionnez le bouton Accueil en haut à droite.

Pour gérer les configurations de votre site, sélectionnez Paramètres dans l’écran d’accueil.

Mappage des utilisateurs

Pour authentifier le module complémentaire Tableau avec Tableau Cloud ou Server, l’utilisateur Google doit être associé à son nom d’utilisateur Tableau correspondant. Pour Tableau Cloud, les noms d’utilisateur correspondent souvent à des adresses e-mail. Si vous sélectionnez E-mail dans la liste déroulante, le module complémentaire utilise l’adresse e-mail Google Workspace principale de l’utilisateur pour se connecter.

Toutefois, si vos noms d’utilisateur Tableau ne correspondent pas aux adresses e-mail principales de Google Workspace, vous pouvez utiliser des attributs personnalisés ou des ID externes. Le module complémentaire prend en charge ces méthodes d’authentification alternatives. Il inclut automatiquement les attributs personnalisés détectés ou les ID externes en tant qu’options dans le menu déroulant de sélection aux côtés du choix d’e-mail standard.

Attributs personnalisés

Vous pouvez établir des attributs personnalisés via la console d’administration Google. Accédez à la section Annuaire > Utilisateurs, puis dans le menu Plus d’options, sélectionnez Gérer les attributs personnalisés.

Définissez le nom de la catégorie (schéma) et de l’attribut en sélectionnant le bouton Ajouter un attribut personnalisé.

Assurez-vous que les paramètres suivants sont sélectionnés dans les menus déroulants :

Type : Texte

Valeur : Valeur unique

Les administrateurs ont la possibilité de limiter la visibilité de cet attribut personnalisé afin qu’il ne soit accessible qu’à eux-mêmes et à l’utilisateur individuel.

Console d’administration Google Workspace avec une boîte de dialogue permettant d’ajouter des champs personnalisés.

Une fois que vous avez créé un attribut personnalisé, vous devez définir sa valeur pour chaque utilisateur du module complémentaire Tableau pour Google Workspace.

Pour des mises à jour individuelles, accédez à la page Utilisateurs de la console d’administration Google, sélectionnez un utilisateur et entrez la valeur dans la section Informations utilisateur où le nouveau champ apparaît.

Pour gérer ces valeurs à grande échelle ou les synchroniser avec Active Directory, nous vous recommandons d’utiliser l’outil Directory Sync. Vous pouvez également automatiser ces mises à jour via l’API Google Directory.

ID externes

Si vous avez configuré des synchronisations d’annuaires qui remplissent les ID externes, vous pouvez les utiliser dans le module complémentaire. Cependant, étant donné que Google définit les types d’ID externes intégrés comme des tableaux, ils ne sont pas visibles dans le module complémentaire. Ces tableaux pouvant contenir plusieurs valeurs dans des ordres variables pour différents utilisateurs, le module complémentaire ne peut pas déterminer la valeur à sélectionner. Par conséquent, le module complémentaire est limité à la prise en charge des ID externes uniquement lorsqu’ils sont catégorisés comme un type personnalisé.

Domaines

Le module complémentaire s’authentifie auprès de Tableau via le point de terminaison /auth/signin en transmettant un JWT. Ce jeton inclut les détails de l’application connectée et le nom d’utilisateur Tableau de l’utilisateur Google. Pour identifier la configuration correcte du site pour un utilisateur spécifique, le module complémentaire utilise l’attribut hostedDomain fourni par l’API de Google.

Une fois enregistrées, les configurations de site sont associées à des domaines spécifiques. Par exemple, si un utilisateur se connecte en tant que someuser@salesforce.com, les API de Google indiquent au module complémentaire que le domaine de l’utilisateur est salesforce.com. Le module complémentaire recherche ensuite les configurations de site associées à ce domaine pour remplir la liste déroulante du sélecteur de site, un processus efficace pour environ 95 % des clients.

Dans certains cas, les utilisateurs finaux d’une même organisation peuvent être répartis sur plusieurs domaines, tels que user1@salesforce.com et user2@tableau.com. Les API Google standard ne fournissent pas de mécanisme permettant d’identifier ces utilisateurs comme faisant partie de la même entreprise, sauf si des autorisations administratives leur sont accordées.

Pour rationaliser ce processus, le module complémentaire récupère tous les domaines liés à un client lors de la configuration ou de la mise à jour du site. Vous pouvez ainsi fournir une seule fois les détails d’un site Tableau et les appliquer à plusieurs domaines simultanément. La liste de contrôle des domaines n’affiche des domaines supplémentaires que si l’utilisateur dispose des autorisations nécessaires pour exécuter cet appel d’API spécifique et que ces domaines sont définis dans Google Workspace.

Remarque : seuls les super-administrateurs ou les utilisateurs disposant d’autorisations Domain Management, Users Read(gestion de domaine et lecture utilisateur) peuvent configurer le module complémentaire dans Google Docs, Slides ou Sheets pour plusieurs domaines, car l’outil nécessite des autorisations de niveau administrateur pour accéder aux données de répertoire Google Workspace.