Salesforce-Zugriff für Data Foundation
Data Foundation führt die Daten aller Systeme, die Sie verbinden, in beliebig vielen Instanzen in einem Common Finance Model zusammen. Salesforce ist eines der Systeme, die es direkt liest. Salesforce ist eine CRM-Quelle, kein Hauptbuch: Es liefert Kunden, Produkte und die Vertriebspipeline, nie Hauptbuchbuchungen. Diese Seite richtet sich an den Salesforce-Administrator, der den Zugriff einrichtet, und an den PlaidCloud-Benutzer, der ihn darum bittet.
PlaidCloud liest Daten ausschließlich. Niemand sendet ein Kennwort oder ein Sicherheitstoken per E-Mail.
Zugriffsanfrage senden
Abschnitt betitelt „Zugriffsanfrage senden“Wählen Sie auf der Registerkarte Foundation des Projekts die Option Neue Verbindung erstellen und dann Salesforce. Das Formular zeigt die vollständige Anfrage. Klicken Sie auf Anfrage kopieren, um sie in Ihre eigene Nachricht einzufügen, oder auf Anfrage per E-Mail senden, um sie in Ihrem E-Mail-Programm mit dem Betreff „Read-only Salesforce access for PlaidCloud (OAuth 2.0 client credentials)“ zu öffnen.
Was der Salesforce-Administrator einrichtet
Abschnitt betitelt „Was der Salesforce-Administrator einrichtet“-
Erstellen Sie eine External Client App unter Setup > Apps > External Client Apps > New oder eine Connected App, falls Ihre Org noch welche hat:
- Aktivieren Sie die OAuth-Einstellungen und setzen Sie nur das Häkchen bei Enable Client Credentials Flow (kein Authorization-Code- und kein Kennwort-Flow).
- OAuth-Bereich: Manage user data via APIs (
api). - Run As: ein dedizierter Integrationsbenutzer (Schritt 2).
-
Geben Sie dem Integrationsbenutzer ein Profil oder einen Berechtigungssatz mit:
- API Enabled
- Lesezugriff auf Account (einschließlich des Felds Account Number), Product2, Opportunity, OpportunityLineItem und Organization (für die Standardwährung)
- View All Data oder Freigaben, mit denen er jede Opportunity sieht, über die Sie berichten
Salesforce beschränkt jede Zeile und jedes Feld, das PlaidCloud lesen kann, auf das, was dieser Benutzer sehen kann.
-
Kopieren Sie den Consumer Key (Client-ID) und das Consumer Secret aus der App sowie die My-Domain-URL der Org, zum Beispiel
https://yourcompany.my.salesforce.com.
Was zurückzusenden ist
Abschnitt betitelt „Was zurückzusenden ist“| Der Administrator sendet | Eingabe in PlaidCloud als |
|---|---|
| Die My-Domain-URL | My-Domain-URL |
| Die Client-ID (Consumer Key) | Client-ID |
| Das Client-Secret (Consumer Secret), über das sichere Verbindungsformular, nicht per E-Mail | Client-Secret |
Geben Sie unter Entität in Name die Entität ein, zu der die Pipeline der Salesforce-Org gehört: Eine Org hat keine Entitäten, die sich auflisten ließen. Eine Org ist eine Entität, zwei Orgs sind also zwei Verbindungen.
Zugriff prüfen
Abschnitt betitelt „Zugriff prüfen“Klicken Sie in PlaidCloud auf Verbindung testen. Jedes Dataset wird als Lesbar, Fehlende Berechtigung oder Fehler angezeigt:
| Dataset | Was es in Salesforce liest |
|---|---|
| Kunden | Account |
| Produkte | Product2 |
| Pipeline | Opportunity und OpportunityLineItem, mit den Kontonummern |
Alle drei sind optional. Zeigt eines Fehlende Berechtigung, bitten Sie den Administrator, dem Integrationsbenutzer den Lesezugriff auf dieses Objekt hinzuzufügen, und testen Sie erneut.
Pipeline-Beträge stehen in der Währung der Opportunity. Eine Org mit nur einer Währung hat kein solches Feld, daher verwendet PlaidCloud die Standardwährung der Org aus Organization und andernfalls die Währung der Entität.