Intégrer avec Tableau

Le connecteur OData de Samsara vous permet d'apporter des ensembles de données Samsara et des rapports personnalisés que vous avez créés dans Samsara dans Tableau pour les utiliser dans des visualisations de données avancées et des analyses supplémentaires.

Exigences

Tableau : Licence Explorer ou Creator sur l'alias de courriel que vous utilisez avec Tableau.

Samsara : Accès à l'API avec des autorisations de lecture

Déploiement

Samsara a construit l'intégration et aidera avec les déploiements si nécessaire. Suivez les étapes ci-dessous pour commencer. S'il y a des problèmes, veuillez contacter l'assistance Samsara.

Générez le jeton d'API à partir de Samsara :
1. Connectez-vous à votre tableau de bord Samsara.
2. Sélectionnez l'icône Paramètres ( ) au bas de votre Flotte menu puis cliquez sur applications.
3. Cliquer sur Code Bêta dans le coin supérieur droit.
4. Pour le code d'entrée, tapez tableau-beta, puis cliquez sur Installer.
5. Acceptez les termes et conditions, puis Générez le jeton.
6. Copiez le jeton d'API généré.
  
  Ce jeton d'API sera utilisé pour authentifier le connecteur Tableau. Si vous perdez le jeton, vous ne pouvez pas le récupérer et vous devrez régénérer un nouveau jeton.
Générez l'URL OData et les identifiants.
Connectez-vous à Tableau.

URL OData et Identifiants

Les rapports et la portée de la plage de données sont générés dans OData via l'URL de connexion, et non via un sélecteur de date comme d'autres protocoles de connexion.

Pour générer une URL OData, effectuez le flux de travail suivant :

Collectez les informations suivantes :
- La région de votre organisation.
  
  Vous pouvez l'identifier en vérifiant le domaine dans l'URL de votre tableau de bord (par exemple, cloud.samsara.com, cloud.ca.samsara.com, ou cloud.eu.samsara.com).
- La plage de dates pour les données avec lesquelles vous souhaitez travailler.
  
  Assurez-vous que la plage se situe dans le maximum autorisé pour l'ensemble de données ; sinon, l'extraction ne s'exécutera pas.
- Votre identifiant d’organisation.
- Votre jeton d'API.
  
  Si vous n'en avez pas encore, voir Déploiement.
Créez la connexion URL en utilisant ce modèle comme référence :

https://<connector_domain>/data-connectors/odata/v4/<start_date>/<end_date>/
1. Remplacez <connector_domain> par le domaine du connecteur de données régional attribué à votre organisation :
  - data-connector.samsara.com
  - data-connector.ca.samsara.com
  - data-connector.eu.samsara.com
2. Remplacez <start_date> par la date de début de la plage de dates, au format AAAA-MM-JJ.
3. Remplacez <end_date> par la date de fin de la plage de dates, au format AAAA-MM-JJ.
Par exemple, une organisation à qui est attribué le domaine du connecteur de données régional de l'UE avec une plage de dates du 1er janvier 2025 au 31 janvier 2025, utiliserait l'URL suivante : https://data-connector.eu.samsara.com/data-connectors/odata/v4/2025-01-01/2025-01-31/.

Les paramètres doivent être modifiés dans l'URL, la date ne peut pas être modifiée après coup.

Samsara recommande une plage de dates maximale d'un an sur tout ensemble de données. Pour plus d’informations, consultez Performances et plages de dates.
Conservez votre identifiant d’organisation et votre jeton d'API pour les utiliser comme identifiants lorsque vous Se connecter à Tableau.

Votre nom d'utilisateur est votre identifiant d’organisation. Votre mot de passe est votre jeton d'API.

Performances et plages de dates

Les limites de plage de temps des ensembles de données sont en place pour les connecteurs Power BI et Tableau. Samsara recommande une plage maximale d'un an sur tout ensemble de données. Les extractions de données particulièrement grandes et complexes, telles que celles listées dans le tableau suivant, peuvent expirer si vous faites des demandes plus longues que la plage maximale suggérée. Lors de la saisie d'une plage de données dans votre URL, tenez compte des éléments suivants :

Ensemble de données	Plage de dates maximale recommandée
Activités des actifs	6 mois
Diagnostics des actifs	6 mois
Actifs	1 an
Conducteurs	1 an
Inspections du véhicule	3 mois
Soumissions de formulaires	6 mois
Journaux des heures de service	3 mois
Segments non assignés des heures de service	3 mois
Infractions des heures de service	3 mois
Événements de ralenti	3 mois
Problèmes	6 mois
Sauts d'odomètre	6 mois
Événements de marche arrière	1 semaine
Événements liés à la sécurité	6 mois
Intervalles d'excès de vitesse	3 mois
Journaux de tachygraphe	3 mois
Formation	6 mois
Trajets	3 mois

La sélection de la date se fait par les paramètres d'URL, et non par un sélecteur de date dans l'interface utilisateur. Pour plus d'informations sur la façon de générer votre portée de plage de dates, voir URL OData et Identifiants.

Si vous utilisez un rapport personnalisé comme source de données, la plage de dates URL que vous fournissez lors de la génération de votre URL OData remplace la plage que vous avez définie dans le rapport personnalisé. Vous ne pourrez voir que les données pour la plage de dates que vous avez définie dans l'URL OData. Cette plage de dates peut toujours expirer si vous demandez une plage de dates plus grande que le jeu de données ne peut prendre en charge.

Se connecter à Tableau

Après avoir généré le jeton d'API, généré votre URL OData et obtenu vos identifiants, vous pouvez vous connecter à Tableau.

Exécutez l'application de bureau Tableau.
1. Dans le menu Connecter, sélectionnez Plus... > OData.
2. Dans le formulaire, saisissez votre URL OData que vous avez créée et vos identifiants puis Se connecter.
3. À partir de la liste des tables disponibles, construisez votre rapport.
  
  Vous pouvez glisser-déposer les tables sélectionnées dans le volet de droite pour créer un modèle de données.
4. Une fois terminé, cliquez sur Feuille 1 en bas pour extraire les données de Samsara.
  
  Cela peut prendre du temps en fonction de la quantité de tables et de données sélectionnées.
  
  Après la création de la base de données d'extraction, vous pouvez maintenant utiliser les sources à gauche pour construire un rapport.
Exécuter dans Tableau Cloud
1. Allez à https://online.tableau.com/.
  
  Vous pouvez utiliser la source OData de Samsara dans vos classeurs actuels, ou en créer un autre à partir de zéro.
2. Sélectionnez l'icône de cylindre pour ajouter une nouvelle source de données Samsara.
3. Dans la fenêtre contextuelle Connecter aux données, cliquez sur Connecteurs, puis sélectionnez OData.
4. Dans le formulaire, saisissez votre URL OData que vous avez créée et vos identifiants puis Se connecter.
  
  N'oubliez pas de sélectionner le Nom d'utilisateur et mot de passe comme méthode d'authentification.
5. Sélectionnez les tables et configurez toutes les relations entre elles comme avec toute autre source de données Tableau.
  
  La liste des tables est extraite du Connecteur et affichée sur le côté gauche.
6. Une fois terminé, cliquez sur Feuille 1 en bas pour extraire les données de Samsara.
  
  Cela peut prendre du temps en fonction de la quantité de tables et de données sélectionnées.