Salesforce-Verbindung

::: (info) () Um die App herunterzuladen, besuchen Sie: Bibliothek:::

Einführung

Salesforce ist eine Cloud-basierte CRM-Softwareplattform, die in verschiedenen Anwendungen von der Verfolgung von Vertriebskontakten bis hin zur Auftrags- und Bestandsverwaltung eingesetzt wird.

Zweck

Dieses Dokument beschreibt den Salesforce REST API Connector, der sich in der Tulip Library befindet. Einmal konfiguriert, können diese Connector-Funktionen verwendet werden, um Salesforce-Daten aus einer Tulip-Anwendung abzurufen, abzufragen und zu ändern.

API-Dokumentation

Die Dokumentation für die Salesforce REST API finden Sie hier. Beachten Sie, dass einige in diesem Artikel enthaltene Connector-Funktionen Abfragen mit SOQL (Salesforce Object Query Language) durchführen, deren vollständige Syntax hier dokumentiert ist.

:::(Info) (API-Variationen) Hinweis: Salesforce unterstützt eine Reihe von APIs mit einer Vielzahl von Methoden, deren vollständige Liste hier zu finden ist.
Dieser Artikel und die Connectors, auf die er sich bezieht, sind für die Verwendung der Salesforce REST API konzipiert .
:::

Erstmaliges Einrichten

:::(Warning) (::: Salesforce API Authentication folgt den OAuth 2.0 Standards. Der folgende Prozess beschreibt, wie man ein Refresh-Token generiert, das dann von jeder Tulip App verwendet wird, um das Access-Token abzurufen, das für eine erfolgreiche Verbindung zu Salesforce benötigt wird.

1. Erstellen Sie eine Connected App in Salesforce. Navigieren Sie dazu zum Bereich "Setup" in Salesforce. Navigieren Sie dann zu PLATFORM TOOLS >> Apps >> Connected Apps >> Manage Connected Apps.
2. Erstellen Sie eine neue Connected App. Fügen Sie ein:
   a. alle Bereiche, die für Ihre Anwendung erforderlich sind, aber stellen Sie sicher, dass refresh_token enthalten ist. b. Wählen Sie OAuth-Einstellungen aktivieren und geben Sie die Callback-URL als https://login.salesforce.com/services/oauth2/success ein .
3. Wenn Sie fertig sind, klicken Sie auf Verbraucherdetails verwalten, um Ihren "Verbraucherschlüssel" und Ihr "Verbrauchergeheimnis" anzuzeigen. Diese werden später verwendet.
4. Öffnen Sienun in Tulip die Connector Funktion [Setup] Get Auth Code URL. Kopieren Sie den in Schritt 3 erzeugten "Consumer Key" und fügen Sie ihn als Abfrageparameter client_id ein.
5. "Führen Sie die Connector Funktion aus.
6. Beachten Sie, dass eine URL als "Output" des Connectors generiert wurde. Fügen Sie diese URL in Ihr Browserfenster ein.
7. Füllen Sie die Authentifizierungsaufforderung aus, die erscheint, um Tulip erfolgreich für die Interaktion mit Ihrer Salesforce-Instanz zu autorisieren.
8. Wenn dies erfolgreich war, sollte Ihr Browser auf eine neue Seite mit der Aufschrift Remote Access Application Authorization umleiten. Der Autorisierungscode kann in der URL dieser Seite gefunden werden.
   In der URL https://login.salesforce.com/services/oauth2/success?code=asdf1234 lautet der Autorisierungscode zum Beispiel asdf1234.
9. Speichern Sie diesen Autorisierungscode. Beachten Sie, dass der Code mit zwei Gleichheitszeichen enden muss: ==. Wenn der Code mit %3D%3D endet, entfernen Sie diese Zeichen und ersetzen sie durch ==.
10. Navigieren Sie zu der Funktion [Setup] Tulip Connector Token abrufen. Fügen Sie in die Abfrageparameter alle Informationen ein, die Sie oben gesammelt haben:
    • grant_type= authorization_code
    • redirect_uri= https://login.salesforce.com/services/oauth2/success
    • client_id= der Verbraucherschlüssel aus Schritt 3 oben
    • client_secret= das Kundengeheimnis aus Schritt 3 oben
    • code= der Autorisierungscode aus Schritt 9 oben
11. Führen Sie diesen Connector aus, und speichern Sie das refresh_token, das in der Antwort erscheint.
12. Navigieren Sie schließlich zu der [Auth] Get Access Token Connector Funktion. Füllen Sie die folgenden Abfrageparameter aus:
    • grant_type= authorization_code
    • client_id= der Verbraucherschlüssel aus Schritt 3 oben
    • client_secret= das Kundengeheimnis aus Schritt 3 oben
    • refresh_token= das Refresh Token aus Schritt 10 oben
13. Führen Sie den Connector aus. Beachten Sie, dass die Antwort ein access_token enthält, das als Ausgabe abgebildet wird. Speichern Sie den Connector, um das Refresh Token zu speichern.

Sobald diese Funktion in der Lage ist, ein access_token zu erzeugen, ist die Einrichtung abgeschlossen! Dieses access_token kann nun in jeder nachfolgenden Connector-Funktion so lange verwendet werden, wie es die in Schritt 2 konfigurierten Timeout-Einstellungen erlauben.

Tulip Verbindungsdetails

Damit Ihre Konnektoren mit Salesforce verbunden werden können, geben Sie die Subdomäne Ihrer Salesforce-Instanz als "Standard-Subdomäne" unter den Verbindungsdetails des Konnektors ein.
Wenn die Salesforce-Instanz zum Beispiel unter sample.my.salesforce.com zu finden ist, sollte die Standard-Subdomäne sample.my sein.

Beachten Sie, dass alle hier aufgeführten Connector-Funktionen für die Salesforce REST API v46.0 ausgelegt sind.

Connector-Funktionen

Es gibt zwei Haupttypen von Konnektoren: Konnektoren vom Objekttyp und vom Abfragetyp.
Beachten Sie, dass beide Konnektoren ein access_token benötigen, also stellen Sie sicher, dass Sie [Auth] Get Access Token in Ihrer Anwendung ausführen, bevor Sie dies tun! Es wird allgemein empfohlen, ein neues Access Token zu generieren, wenn die Anwendung oder der Prozess startet, und es in einer App-Variable für spätere Verwendung zu speichern.

Objekt-Typ Konnektoren

• Gibt alle Felder des betreffenden Objekts zurück.
• Verwenden Sie den Endpunkt ./services/data/v46.0/sobjects/<Object Name>/<Object ID>
• Beispiel: Connector [Opportunity] Alle Felder abrufen

Konnektoren vom Typ Abfrage

• Gibt nur die in der Abfrage angegebenen Felder zurück.
• Kann verknüpfte (z. B. den Kontonamen in Bezug auf eine Verkaufschance) oder aggregierte (z. B. eine Anzahl von Datensätzen) Informationen zurückgeben.
• Verwenden Sie den Endpunkt ./services/data/v46.0/query
• Erfordert das Schreiben einer Abfrage mit SOQL (Dokumentation here{target=_blank}).
• Beispiel: Connector [Bestellung] Alle Bestellungen mit Status abfragen

Enthaltene Connector-Funktionen

Die folgenden Connector-Funktionen sind in diesem Paket enthalten und sollen als Einführung in die Funktionen dienen, die über die Salesforce-API möglich sind: * [Setup] Get Auth Code URL & [Setup] Get Refresh Token * Wird nur bei der Ersteinrichtung verwendet. Siehe oben für weitere Informationen.* [Auth] Get Access Token * Wird verwendet, um ein Access Token zu generieren, das in allen nachfolgenden Connector-Funktionen enthalten sein muss.* [Opportunity] Funktionen:
* Get All Fields * Gibt alle Felder der abgefragten Opportunity zurück. Erfordert Access Token und Opportunity ID.* Change Stage * Aktualisiert die Stage der angegebenen Opportunity auf den angegebenen Wert.* [Order] functions: * Get All Orders of Status * Gibt eine Liste aller Orders eines bestimmten Status zurück.* Count Orders of Status * Gibt eine Zählung aller Orders eines bestimmten Status zurück.* Get Order Number from ID * Gibt eine Order Number aus einer bestimmten Order ID zurück.

Um diese Funktionen an Ihre Bedürfnisse anzupassen, beachten Sie bitte die folgenden Hinweise:

1. Um die objektartigen Connector-Funktionen zu ändern, ändern Sie einfach das in der URL angegebene Objekt. Fügen Sie nach Bedarf neue Ausgaben hinzu oder entfernen Sie sie. 2. Um Verbindungsfunktionen vom Typ Abfrage zu ändern, müssen alle Änderungen in der Abfrage vorgenommen werden. Diese ist in den Abfrageparametern mit dem Schlüssel q zu finden.
2. Tipp: Begrenzen Sie die Anzahl der Antworten einer Abfrage mit der Funktion LIMIT(Anzahl_der_Antworten)

Haben Sie gefunden, wonach Sie gesucht haben?

Sie können auch auf community.tulip.co Ihre Frage stellen oder sehen, ob andere mit einer ähnlichen Frage konfrontiert wurden!