Accès à Salesforce pour Data Foundation

Data Foundation rassemble dans un seul Common Finance Model les données de chaque système que vous connectez, dans autant d’instances que vous en avez. Salesforce fait partie des systèmes qu’il lit directement. Salesforce est une source CRM, et non un registre comptable : il fournit les clients, les produits et le pipeline commercial, jamais d’écritures de grand livre. Cette page s’adresse à l’administrateur Salesforce qui configure l’accès, et à l’utilisateur PlaidCloud qui le lui demande.

PlaidCloud ne fait que lire les données. Personne n’envoie de mot de passe ni de jeton de sécurité par e-mail.

Envoyer la demande d’accès

Dans l’onglet Foundation du projet, choisissez Créer une nouvelle connexion et sélectionnez Salesforce. Le formulaire affiche la demande complète. Cliquez sur Copier la demande pour la coller dans votre propre message, ou sur Envoyer la demande par e-mail pour l’ouvrir dans votre messagerie avec l’objet « Read-only Salesforce access for PlaidCloud (OAuth 2.0 client credentials) ».

Ce que l’administrateur Salesforce configure

1. Créez une External Client App sous Setup > Apps > External Client Apps > New, ou une Connected App si votre organisation en utilise encore :

   • Activez les paramètres OAuth, et cochez uniquement Enable Client Credentials Flow (ni flux de code d’autorisation, ni flux de mot de passe).
   • Portée OAuth : Manage user data via APIs (api).
   • Run As : un utilisateur d’intégration dédié (étape 2).

2. Donnez à l’utilisateur d’intégration un profil ou un jeu d’autorisations comprenant :

   • API Enabled
   • Read sur Account (y compris le champ numérique Account Number), Product2, Opportunity, OpportunityLineItem et Organization (pour la devise par défaut)
   • View All Data, ou un partage qui lui permet de voir chaque opportunité sur laquelle vous produisez des rapports

   Salesforce limite chaque ligne et chaque champ que PlaidCloud peut lire à ce que cet utilisateur peut voir.

3. Copiez la Consumer Key (ID client) et le Consumer Secret depuis l’application, ainsi que l’URL My Domain de l’organisation, par exemple https://yourcompany.my.salesforce.com.

Ce qu’il faut renvoyer

L’administrateur envoie	Saisi dans PlaidCloud comme
L’URL My Domain	URL My Domain
L’ID client (Consumer Key)	ID client
Le secret client (Consumer Secret), via le formulaire de connexion sécurisé et non par e-mail	Secret client

Sous Entité, saisissez dans Nom l’entité à laquelle appartient le pipeline de l’organisation Salesforce : une organisation n’a aucune entité à lister. Une organisation correspond à une entité ; deux organisations correspondent donc à deux connexions.

Vérifier l’accès

De retour dans PlaidCloud, cliquez sur Tester la connexion. Chaque jeu de données s’affiche comme Lisible, Autorisation manquante ou Erreur :

Jeu de données	Ce qu’il lit dans Salesforce
Clients	Account
Produits	Product2
Pipeline	Opportunity et OpportunityLineItem, avec les numéros de compte

Les trois sont facultatifs. Lorsque l’un d’eux affiche Autorisation manquante, demandez à l’administrateur d’ajouter l’accès en lecture à cet objet pour l’utilisateur d’intégration, puis testez à nouveau.

Les montants du pipeline sont exprimés dans la devise de l’opportunité. Une organisation qui n’utilise qu’une seule devise n’a pas ce champ ; PlaidCloud utilise alors la devise par défaut de l’organisation issue d’Organization, et à défaut la devise de l’entité.

Voir aussi

• Data Foundation
• Se connecter à Salesforce