Cet article explique le fonctionnement du connecteur Salesforce Tableau CRM pour DataGalaxy.
Ce connecteur est disponible dans les modes suivants :
| Mode Desktop ✅ | Mode SaaS Online ❌ |
Présentation du connecteur
Le connecteur permet de récupérer les métadonnées des Dashboards, des Lenses et des Datasets via l’API Salesforce. Les objets récupérés et leurs correspondances dans DataGalaxy sont détaillés dans le tableau suivant :
| Objet Salesforces Tableau CRM | Objet DataGalaxy | Commentaires |
|---|---|---|
| App | Application | Chaque APP partagée dans l'outil Salesforce Tableau CRM est importée en tant qu'application dans une application racine (à nommer lors du paramétrage) dans le module Usage. |
| Lense | Rapport | Les dashboards et lenses sont importés en tant qu'enfants de l'App, conservant ainsi l'arborescence définie dans l'outil. |
| Dashboard | Tableau de bord | |
| Page | Composant Usage | Les pages des dashboards sont importées en tant que composants de type "Onglet" du tableau de bord. |
| Widget | Composant Usage | Chaque widget (graphique, tableau,...) du dashboard est importé en tant que composant de la page associée. |
| Dataset | Data Set | Chaque dataset est importé ainsi que ses champs dates, les dimensions et les mesures (en tant que champs du dataset). Des liens sont créés pour associer les datasets utilisés dans un dashboard ou un lens |
Etape 1 : Installation
- Télécharger le connecteur DataGalaxy depuis le portail (voir ici)
- Extraire l'archive du connecteur dans le répertoire de votre choix
- Télécharger le plug-in Salesforce Tableau CRM depuis le portail et le copier dans le répertoire /lib du connecteur
Etape 2 : Exécution du connecteur Salesforce Tableau CRM
- Après avoir démarré le connecteur, accéder aux connecteurs des Usages :
- S'il a été correctement installé, le plug-in Salesforce Tableau CRM apparaît dans la liste
- Les informations suivantes sont demandées :
| Paramètre | Obligatoire | Description |
| URL de l'API | Oui | L’URL de l’API, exemple : https://eu25.salesforce.com/ |
| Utilisateur | Oui | Adresse mail de connexion à Salesforce de l'utilisateur |
| Mot de passe | Oui | Mot de passe de connexion à Salesforce de l'utilisateur |
| Token | Oui | Identifiant du jeton d'accès initial associé à l'utilisateur. La documentation suivante explique comment en générer un pour le recevoir par mail : Reset Your Security Token |
| Identifiant client | Oui | La documentation Salesforce suivante explique comment générer une "Connected APP" afin d'obtenir l'identifiant et le secret: Enable OAuth Settings for API Integration |
| Secret client | Oui | |
| Nom de l'application racine | Oui | Nom de l'application "parent" dans le module Usage de DataGalaxy, qui sera utilisée pour stocker l’ensemble des rapports, tableaux de bord et dataset de l'outil Salesforce Tableau CRM. Si l'application n'existe pas, elle sera créée lors de l'import. |
| Périmètre | Oui | Choix du périmètre d'import. Par défaut pour la version beta, une seule option est disponible et obligatoire (Usage). |
Note : en mode CLI, les 3 secrets "Mot de passe", "Token" et "Secret client" doivent être passés via l'argument --password, grâce au format json de cette manière :
--password "{'password':'my_password','token':'mytoken','client_secret':'my_client_secret'}"
Informations techniques
Le connecteur utilise la version 51.0 de l'API de Salesforce (https://developer.salesforce.com/docs/atlas.en-us.230.0.bi_dev_guide_rest.meta/bi_dev_guide_rest/bi_resources_lenses_id.htm )
Releases
| Date | Plugin Version | DataGalaxy release | Desktop Connector version (minimum) | Description |
| 23/08/2024 | 3.0.1 | v3.69.0 | 5.2.3 | Updated the logger to show more information when using verbose mode |
| 06/08/2024 | 3.0.0 | v3.65.0 | 5.0.5 | Migrated from java 11 to java 17 + CVE fixes |