Aide de Tableau Desktop et de la création Web

Vous pouvez intégrer des métriques pour les afficher avec d’autres contenus Web si elles semblent plus pertinentes pour vos spectateurs. Lorsque vous chargez une métrique intégrée, vous obtenez les données les plus récentes disponibles, car vous vous connectez directement à vos données sur Tableau Server ou Tableau Cloud.

Pour intégrer des métriques dans une page Web, copiez le code d’intégration HTML fourni sur Tableau Server ou Tableau Cloud ou utilisez l’exemple JavaScript ci-dessous. Vous pouvez intégrer plusieurs métriques sur une seule page, tant qu’elles proviennent du même site Tableau.

Les métriques intégrées fonctionnent avec les mêmes navigateurs Web pris en charge par Tableau Cloud et Tableau Server. Pour obtenir une liste des navigateurs pris en charge, consultez les Spécifications techniques. Même si l’intégration est prise en charge par Safari, les utilisateurs Viewer doivent désactiver l’option « Empêcher le suivi intersites » pour voir le contenu intégré.

Le code d’intégration et les paramètres des métriques intégrées diffèrent de ceux utilisés pour les vues intégrées. Pour plus d’informations sur les vues intégrées, consultez Intégrer des vues dans des pages Web.

Remarque : votre administrateur Tableau peut limiter les sites où l’intégration est autorisée ou désactiver complètement l’intégration. Si votre métrique intégrée ne se charge pas, contactez votre administrateur pour vous assurer que le site sur lequel vous l’avez intégrée figure sur la liste d’autorisations d’intégration. Pour plus d’informations, consultez Paramètres du site Tableau pour l’intégration.

Copier le code d’intégration

Le moyen le plus rapide d’intégrer une métrique consiste à copier le code d’intégration fourni par Tableau.

1. Sur Tableau Cloud et Tableau Server, accédez à la page des détails de la métrique que vous souhaitez intégrer.
2. Cliquez sur le bouton Partager une métrique.
3. Cliquez sur le bouton Copier le code d’intégration.
   
4. Collez le code d’intégration dans la page Web où vous souhaitez intégrer la métrique.

Écrire votre propre code d’intégration

Lorsque vous copiez le code d’intégration depuis Tableau Server ou Tableau Cloud, vous copiez le code d’intégration HTML, sans aucun paramètre facultatif. Si vous souhaitez davantage de contrôle sur la métrique intégrée, vous pouvez soit personnaliser le code HTML soit utiliser l’exemple JavaScript pour écrire votre propre script.

Exemple HTML

<tableau-metric
	src='https://mycompany/#/metrics/1'
	link-target='https://example.com'>
</tableau-metric>
<script type='module' src='https://mycompany/javascripts/api/tableau.metric.1.latest.min.js'></script>

Exemple JavaScript

<div id='metricDiv'/>
<script type='module'>
	import { TableauMetric } from 'https://mycompany/javascripts/api/tableau.metric.1.latest.min.js';
				
	let metric = new TableauMetric();

	metric.src = 'https://mycompany/#/metrics/1';
	metric.linkTarget = 'https://example.com';document.getElementById('metricDiv').appendChild(metric);
</script>

Paramètres du code d’intégration

Les paramètres du code d’intégration peuvent être utilisés pour personnaliser les options d’intégration HTML et JavaScript.

Authentification pour les métriques intégrées

Les métriques intégrées suivent les mêmes restrictions de licences et d’autorisations utilisées sur Tableau Server et Tableau Cloud. Pour voir une métrique intégrée, l’utilisateur Viewer doit se connecter à un compte sur le site Tableau à partir duquel la métrique est intégrée. Contrairement aux vues intégrées, les métriques intégrées ne permettent pas aux utilisateurs Viewer qui ne sont pas connectés d’utiliser un compte Invité pour afficher des métriques.

Les utilisateurs Viewer qui ne se sont pas connectés à Tableau Server ou Tableau Cloud dans un autre onglet seront invités à se connecter depuis la métrique intégrée elle-même. Pour réussir à se connecter depuis une métrique intégrée, le navigateur de l’utilisateur Viewer doit être configuré pour autoriser les témoins tiers.

Les métriques intégrées prennent en charge toutes les méthodes d’authentification pour Tableau Server et Tableau Cloud, à l’exception de l’authentification de confiance. Pour les métriques intégrées depuis Tableau Server, le serveur doit utiliser HTTPS pour sécuriser la communication.

Pour permettre une expérience d’authentification unique pour les métriques intégrées, votre administrateur Tableau doit configurer une relation de confiance entre Tableau Server et un serveur d’autorisation externe (Tableau Server uniquement) ou entre une application connectée Tableau et une page Web. Pour plus d’information, consultez Enregistrer EAS de manière à activer l’authentification unique pour le contenu intégré(Le lien s’ouvre dans une nouvelle fenêtre) dans l’aide de Tableau Server ou Configurer les applications connectées Tableau pour activer l’authentification unique pour le contenu intégré(Le lien s’ouvre dans une nouvelle fenêtre) dans l’aide de Tableau Cloud.

Structure des URL de métriques

Pour intégrer une métrique, vous spécifiez l’URL de la métrique et l’URL du code JavaScript utilisé pour afficher la métrique. Les URL de métriques suivent des modèles légèrement différents sur Tableau Cloud, les environnements Tableau Server avec un seul site et les environnements Tableau Server avec plusieurs sites. Si vous ne savez pas comment formater l’URL, copiez le code d’intégration. Il inclut à la fois l’URL de la métrique et l’URL du code JavaScript.

Les métriques doivent être hébergées sur Tableau Server ou Tableau Cloud. Vous ne pouvez pas intégrer une métrique à partir d’un fichier local.

Structure des URL de métriques

• Site Tableau Cloud : https://<pod>.online.tableau.com/#/site/<sitename>/metrics/<metric>
• Tableau Server avec un seul site (ou le site par défaut) : https://<servername>/#/metrics/<metric>
• Tableau Server avec plusieurs sites : https://<servername>/#/site/<sitename>/metrics/<metric>

Structure des URL de JavaScript

L’URL de la métrique change en fonction du site à partir duquel vous l’intégrez, mais l’URL du JavaScript qui affiche la métrique ne change pas, car il n’inclut pas le site.

• Site Tableau Cloud : https://<pod>.online.tableau.com/javascripts/api/tableau.metric.1.latest.min.js
• Tableau Server : https://<servername>/javascripts/api/tableau.metric.1.latest.min.js