Salesforce-Verbindung

Warning: generating the following values requires developer- or administrator-level permissions in Salesforce.
:::Die Salesforce API-Authentifizierung 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 Zugriffstoken zu erhalten, 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 Folgendes hinzu: a. alle für Ihre Anwendung erforderlichen Bereiche, aber achten Sie darauf, refresh_token einzuschließen. 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 generierten "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 dem obigen Schritt 9
11. Führen Sie diesen Connector aus, und speichern Sie den refresh_token, der 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 einen access_token enthält, der 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-Variablen für die 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 hier{target=_blank}).
• Beispiel: Connector [Bestellung] Alle Bestellungen mit Status abrufen

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 Verkaufschance zurück. Erfordert Access Token und Opportunity ID. * Change Stage * Aktualisiert die Stufe der angegebenen Opportunity auf den angegebenen Wert* [Order]-Funktionen: * Get All Orders of Status * Gibt eine Liste aller Aufträge mit einem bestimmten Status zurück. * Count Orders of Status * Gibt die Anzahl aller Aufträge mit einem bestimmten Status zurück. * Get Order Number from ID * Gibt eine Bestellnummer aus einer angegebenen Bestell-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 bei 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. 1. 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!