Connecter Tableau à ActivityInfo via le connecteur d'API REST

Introduction

Ce tutoriel explique comment utiliser le connecteur d'API REST de Tableau pour lier Tableau à ActivityInfo et récupérer vos données pour analyse.

Prérequis

• Un compte ActivityInfo avec les autorisations pour au moins une base de données et un formulaire.
• Une clé API personnelle générée à partir de votre profil ActivityInfo.
• Tableau Desktop (v2023.3 ou version ultérieure) installé sur macOS ou Windows.

Étape 1 : Générer votre Clé API ActivityInfo

• Connectez-vous à votre compte ActivityInfo.
• Cliquez sur l'icône de votre profil (coin supérieur droit) et sélectionnez Paramètres du compte.

• Sélectionnez Jetons API dans le panneau de navigation et cliquez sur Ajouter.

• Donnez une étiquette au jeton (par exemple, « Connecteur Tableau »).
• Sélectionnez l'option Lecture seule (puisque Tableau n'a besoin que de récupérer des données) et cliquez sur Générer.

• Copiez immédiatement le jeton et conservez-le dans un endroit sûr (comme un gestionnaire de mots de passe).

Remarque : Pour des raisons de sécurité, vous ne pourrez plus voir le jeton une fois que vous aurez quitté cette page. Si un jeton est compromis, révoquez-le immédiatement et générez-en un nouveau.

Étape 2 : Localiser votre Formulaire et l'URL de l'API de requête

Tableau se connecte à ActivityInfo au niveau du formulaire ou du sous-formulaire. Pour continuer, vous avez besoin de l'URL de l'API de requête spécifique à votre formulaire ou sous-formulaire cible.

• Allez à votre base de données ActivityInfo.

• Ouvrez le formulaire ou le sous-formulaire que vous souhaitez connecter, cliquez sur Exporter, et sélectionnez Requête JSON.

• Choisissez si vous souhaitez interroger le formulaire entier ou des colonnes sélectionnées, puis cliquez sur Copier l'URL.

Étape 3 : Télécharger et installer le connecteur d'API REST

Téléchargez le connecteur d'API REST JDBC (fichier .jar) depuis Tableau Exchange. Une fois téléchargé, déplacez le fichier dans le répertoire approprié pour votre système d'exploitation.

Windows

• Allez à : C:\Program Files\Tableau\Drivers
• Si le dossier n'existe pas, créez-le manuellement.
• Copiez le fichier .jar dans ce dossier.

MacOS

• Allez à : /Users/<votre-nom-d'utilisateur>/Library/Tableau/Drivers
• Si le dossier n'existe pas, créez-le manuellement.
• Copiez le fichier .jar dans ce dossier.

Étape 4 : Connecter Tableau à ActivityInfo

• Redémarrez Tableau pour vous assurer que le nouveau pilote est reconnu.
• Sous Connecter >> À un serveur, sélectionnez API REST ou Connecteur d'API REST par Tableau.

• Dans la fenêtre de configuration de l'API REST, saisissez les détails suivants :

• URL de l'API REST : Collez l'URL de l'API de requête de l'Étape 2.

• Format de réponse : Sélectionnez JSON ou CSV.

• Authentification : Sélectionnez Jeton d'authentification.

• Mot de passe : Collez la Clé API de l'Étape 1.

• Cliquez sur Se connecter.

• Tableau va maintenant extraire les données du formulaire.

• Cliquez sur le nom de la feuille dans le coin inférieur gauche et sélectionnez l'icône Afficher les données (qui ressemble à un petit tableau/grille), pour voir les données de votre formulaire ActivityInfo organisées dans un tableau.

• Vous pouvez connecter plusieurs formulaires, sous-formulaires et construire les relations entre les tableaux dans Tableau.

Dépannage

Même avec les bonnes configurations, la connexion entre Tableau et ActivityInfo peut échouer en raison d'erreurs d'authentification ou de problèmes de pilote. Le tableau ci-dessous couvre certains problèmes courants que vous pourriez rencontrer et comment les résoudre.