Connecter Tableau Server à Salesforce Data Cloud
Remarque : Data Cloud s’appelait auparavant Customer Data Platform.
Tableau Server (version 2023.3 et versions ultérieures)
Le connecteur Salesforce Data Cloud a été publié dans la version 2023.2 de Tableau Desktop et Tableau Prep, en juin 2023 pour Tableau Cloud et dans la version 2023.3 de Tableau Server. Ce connecteur connecte de manière transparente Tableau à Data Cloud et est disponible pour Tableau Desktop, Tableau Cloud, Tableau Server et Tableau Prep. Par rapport au connecteur Customer Data Platform précédent, le connecteur Salesforce Data Cloud est plus simple à configurer, reconnaît les espaces de données, présente des étiquettes d’objet plus claires et est optimisé par des requêtes accélérées. Voir les étapes ci-dessous.
Remarque : le connecteur Customer Data Platform est obsolète depuis Tableau Server 2023.3 et ne peut pas être utilisé pour de nouvelles connexions depuis Tableau Server 2024.2. Les classeurs, sources de données et autres ressources existantes qui utilisent le connecteur Customer Data Platform continueront de fonctionner jusqu’à ce que le connecteur soit complètement supprimé, généralement 1 à 2 versions après la déclaration d’obsolescence. Afin que les ressources existantes continuent de fonctionner, Tableau recommande vivement aux clients de modifier les ressources existantes de manière à utiliser le connecteur Salesforce Data Cloud.
Étape 1 : Créer une application connectée à Salesforce
Le connecteur Salesforce Data Cloud nécessite la création d’une application connectée dans Salesforce.
Le connecteur Salesforce Data Cloud et le connecteur Salesforce partagent la même application connectée. De ce fait, si vous utilisez déjà le connecteur Salesforce, il vous suffit d’ajouter les trois portées Customer Data Platform répertoriées à l’étape 7 à votre application connectée existante.
- Connectez-vous à votre compte développeur Salesforce.com, cliquez sur votre nom d’utilisateur dans le coin supérieur droit, puis sélectionnez Setup (Configurer).
- Dans la colonne de navigation de gauche, sous Apps, sélectionnez App Manager.
- Dans la section Connected Apps (Applications connectées), cliquez sur New Connected App (Nouvelle application connectée).
- Dans Basic Information (Informations de base), donnez un nom à l’application, appuyez sur la touche Tabulation du champ API pour qu’il s’auto-remplisse au format correct, et entrez un e-mail de contact pour l’application.
- Dans la section API [Activer les paramètres OAuth] sélectionnez Enable OAuth Settings (Activer les paramètres OAuth).
- Dans les nouveaux paramètres OAuth qui s’affichent, dans Callback URL (URL de rappel), entrez le nom de domaine qualifié complet de votre serveur en utilisant le protocole
https
et ajoutez le texte suivant à l’URL :auth/add_oauth_token
.
Par exemple :https://www.your_tableau_server.com/auth/add_oauth_token
- Déplacez les éléments suivants de Available OAuth Scopes (Portées OAuth disponibles) vers Selected OAuth Scopes (Portées OAuth sélectionnées) :
- Accéder au service d’URL d’identité (identifiant, profil, e-mail, adresse, téléphone)
- Gérer les données des utilisateurs via des API (api)
- Émettre des requêtes à tout moment (refresh_token, accès hors ligne)
- Effectuer des requêtes SQL ANSI sur les données de Customer Data Platform (cdp_query_api)
- Gérer les données de profil Customer Data Platform (cdp_profile_api)
- Gérer les données de l’API Ingestion de Customer Data Platform (cdp_ingest_api)
- Cliquez sur Enregistrer.
Après que vous avez enregistré l’application, Salesforce remplit la section API avec les ID suivants que vous utiliserez pour configurer Tableau Server :
- Clé client
- Code secret client
- URL de rappel
Étape 2 : Configurer Tableau Server pour Salesforce.com OAuth
Une fois que votre application connectée est créée dans Salesforce et que vous avez la clé client, le secret client et l’URL de rappel, vous pouvez configurer Tableau Server pour les connexions et les sorties de données Salesforce et Einstein Discovery.
- Sur l’ordinateur Tableau Server, à l’invite de commande, exécutez les commandes suivantes :
tsm configuration set -k oauth.salesforce.client_id -v <your_customer_key>
tsm configuration set -k oauth.salesforce.client_secret -v <your_customer_secret>
tsm configuration set -k oauth.salesforce.redirect_uri -v <your_redirect_URL>
- (Facultatif) Pour modifier le serveur de connexion par défaut, entrez la commande suivante :
tsm configuration set -k oauth.salesforce.server_base_url -v <URL>
- Entrez la commande suivante pour appliquer les modifications :
tsm pending-changes apply
Si les modifications en attente nécessitent un redémarrage du serveur, la commande pending-changes apply affichera une invite pour vous informer d’un redémarrage imminent. Cette invite s’affiche même si le serveur est arrêté, mais dans ce cas, il n’y a pas de redémarrage. Vous pouvez supprimer l’invite à l’aide de l’option--ignore-prompt
, mais cela ne modifiera pas le comportement de redémarrage. Si les modifications ne nécessitent pas de redémarrage, les modifications sont appliquées sans invite. Pour plus d’informations, consultez tsm pending-changes apply.
Configurer OAuth personnalisé pour un site
Pour les instructions de configuration, consultez la rubrique Connexions OAuth.
Tableau Server (2023.1 et versions antérieure)
Avertissement : Customer Data Platform est obsolète depuis octobre 2023 et n’est plus disponible dans Tableau Server 2024.2 et versions ultérieures. Afin que les ressources continuent de fonctionner, Tableau recommande vivement aux clients de modifier les ressources existantes de manière à utiliser le connecteur Salesforce Data Cloud.
Cette section décrit comment se connecter à Salesforce Customer Data Platform depuis Tableau Server via l’authentification OAuth.
Vous devez suivre les étapes décrites dans cette section pour pouvoir utiliser les données Salesforce Customer Data Platform dans Tableau Server.
Étape 1 : Configurer le connecteur
- Téléchargez le connecteur Salesforce Customer Data Platform le plus récent (fichier Salesforce_CDP.taco) depuis le site Connecteurs Tableau Exchange.
- Déplacez le fichier .taco vers le dossier du connecteur Tableau :
- Windows :
C:\Users[Windows User]\Documents\My Tableau Repository\Connectors
- Linux :
/opt/tableau/connectors
OU/var/opt/tableau_server/data/tabsvc/vizqlserver/Connectors/
- Redémarrez Tableau Server.
Étape 2 : Installation du pilote Customer Data Platform JDBC
Remarque : Tableau version 2023.1 pour Server est uniquement compatible avec la version 18 et supérieure du pilote JDBC.
- Téléchargez le pilote JDBC le plus récent (fichier Salesforce-CDP-jdbc-[version].jar) depuis le site Salesforce CDP GitHub : https://github.com/forcedotcom/Salesforce-CDP-jdbc/releases
- Déplacez le fichier téléchargé Salesforce-CDP-jdbc-[ version ].jar vers l’emplacement suivant :
- Windows :
C:\Program Files\Tableau\Drivers
- Linux :
/opt/tableau/tableau_driver/jdbc
Étape 3 : Créer une application connectée à Salesforce
Après avoir créé les portées d’API, utilisez la procédure ci-dessous pour créer une application connectée à Salesforce afin de gérer la délégation OAuth à partir de Tableau Server.
Connectez-vous à votre compte Salesforce Customer Data Platform en tant qu’administrateur, cliquez sur votre Nom d’utilisateur dans le coin supérieur droit, puis sélectionnez Setup (Configurer).
Dans le volet gauche, sous Apps, sélectionnez App Manager.
Dans la section Connected Apps (Applications connectées), cliquez sur New Connected App (Nouvelle application connectée).
Dans Basic Information (Informations de base), donnez un nom à l’application, par exemple Exemple.com. Appuyez sur la touche Tabulation du champ API pour qu’il s’auto-remplisse au format correct, et entrez une adresse e-mail de contact pour l’application.
Dans la section API [Enable OAuth Settings] (API [Activer les paramètres OAuth]), sélectionnez Enable OAuth Settings (Activer les paramètres OAuth), puis procédez comme suit :
Dans les nouveaux paramètres OAuth qui s’affichent, dans Callback URL (URL de rappel), entrez le nom de domaine qualifié complet de votre Tableau Server, en utilisant le protocole
https
et ajoutez le texte suivant à l’URL :/auth/add_oauth_token
.Par exemple :
https://example.com/auth/add_oauth_token
Déplacez les éléments suivants de Available OAuth Scopes (Portées OAuth disponibles) vers Selected OAuth Scopes (Portées OAuth sélectionnées) :
- Gérer les données des utilisateurs via des API (api)
- Exécuter des demandes en votre nom à n’importe quel moment (refresh_token, offline_access)
- Gérer les données de profil Customer Data Cloud (cdp_profile_api)
- Effectuer des requêtes SQL ANSI sur les données de Customer Data Platform (cdp_query_api)
Une fois que vous avez terminé, cliquez sur Enregistrer.
Accédez à votre liste App Manager, accédez à votre application connectée, cliquez sur la flèche déroulante, puis sélectionnez Ma,age (Gérer).
Une fois que vous avez enregistré l’application, la section API (Enable OAuth Settings) (API (Activer les paramètres API)) se remplit automatiquement avec les ID suivants que vous utiliserez pour configurer Tableau Server :
- Clé client
- Code secret client
- URL de rappel
Remarque : enregistrez votre clé client, votre clé secrète et votre URL de rappel pour les utiliser ultérieurement.
Utiliser OAuth avec Customer Data Platform
Envisagez de configurer un client OAuth personnalisé pour 1) remplacer un client OAuth s’il est configuré pour le serveur ou 2) activer la prise en charge de la connexion sécurisée aux données qui nécessitent des clients OAuth uniques.
Une fois que l’application connectée est créée dans Salesforce et que vous avez la clé consommateur, le secret consommateur et l’URL de rappel, vous pouvez configurer Tableau Server pour les connexions Oauth à Customer Data Platform. Pour commencer, rassemblez les informations suivantes.
- Clé consommateur : la clé consommateur, également appelée ID client dans Tableau, est générée à partir de la procédure à la fin de l’étape 4. Utilisez cette valeur pour
[your_consumer_key]
dans la commande tsm suivante. - Secret consommateur : le secret consommateur, également appelé secret client dans Tableau, est généré à partir de la procédure à la fin de l’étape 4. Utilisez cette valeur pour
[your_consumer_secret]
dans la commande tsm suivante. - URL de rappel : l’URL de rappel, également appelée URL de redirection dans Tableau, est votre URL Tableau Server
https://example.com
avec "/auth/add_oauth_token
" en annexe. Utilisez cette valeur pour[your_callback_url]
dans la commande tsm suivante. - ID de configuration : il s’agit de la valeur du paramètre
oauth.config.id
de la commande tsm suivante :customer_360_audience
Utiliser les commandes TSM pour la configuration OAuth
Exécutez les commandes tsm suivantes pour configurer OAuth.
tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"customer_360_audience\", \"oauth.config.client_id\":\"[your_consumer_key]\", \"oauth.config.client_secret\":\"[your_consumer_secret]\", \"oauth.config.redirect_uri\":\"[your_callback_url]\"}]" --force-keys
tsm pending-changes apply
Configuration de plusieurs connecteurs
Si vous avez plusieurs connecteurs à configurer, vous devez tous les inclure dans une seule commande. Par exemple :
tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"custom_360_audience\", \"oauth.config.client_id\":\"[your_consumer_key]\", \"oauth.config.client_secret\":\"[your_consumer_secret]\", \"oauth.config.redirect_uri\":\"[your_callback_url]\"}, {\"oauth.config.id\":\"dremio\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"azure_sql_dw\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"azure_sqldb\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}]" --force-keys
tsm pending-changes apply
Étape 1 : Enregistrer l’ID client et le secret client OAuth
Suivez la procédure décrite ci-dessous pour enregistrer le client OAuth personnalisé sur votre site.
- Connectez-vous à Tableau Server à l’aide de vos informations d’identification d’administrateur de site et accédez à la page Paramètres.
- Sous Registre des clients Oauth, sélectionnez le bouton Ajouter un client OAuth.
- Dans Type de connexion, sélectionnez Customer Data Platform.
- Pour le fournisseur OAuth, sélectionnez IdP personnalisé.
- Saisissez l’ID client.
- Saisissez le secret client.
- Saisissez l’URL de redirection.
- Dans Choisir le fichier de configuration OAuth, sélectionnez le bouton Choisir un fichier pour télécharger le fichier de configuration.
- Sélectionnez le bouton Ajouter un client OAuth pour terminer le processus d’enregistrement.
- Sélectionnez le bouton Enregistrer en bas ou en haut de la page Paramètres pour enregistrer les modifications.
Étape 2 : Valider et mettre à jour les informations d’identification enregistrées
Pour garantir un accès ininterrompu aux données, vous (et les utilisateurs de votre site) devez supprimer toutes les informations d’identification enregistrées précédemment et les ajouter à nouveau.
- Accédez à votre page Paramètres de Mon compte.
- Sous Informations d’identification enregistrées pour les sources de données, sélectionnez Supprimer à côté des informations d’identification enregistrées existantes.
- À côté du même connecteur, sélectionnez Ajouter.
- Suivez les invites pour vous connecter au connecteur Customer Data Platform.
- Sélectionnez Enregistrer .
Étape 3 : Informer les utilisateurs de mettre à jour leurs informations d’identification enregistrées
Assurez-vous de demander aux utilisateurs de votre site de mettre à jour leurs informations d’identification enregistrées pour le connecteur Customer Data Platform. Les utilisateurs du site peuvent utiliser la procédure décrite dans Gérer les informations d’identification enregistrées pour les connexions de données pour mettre à jour leurs informations d’identification enregistrées.
Voir également
- Aide de Salesforce : Configurer Tableau dans Customer Data Platform
- Aide de Salesforce : Activer Customer Data Platform dans Tableau
- Aide de Salesforce : Utilisation des données de Customer Data Platform dans Tableau