Salesforce Konnektor
Der Salesforce Konnektor stellt die Schnittstelle zwischen Syncler und Salesforce CRM bereit.
Er ermöglicht die bidirektionale Synchronisation von Daten über die Salesforce Webservice API (SOAP).
Mit diesem Konnektor können Datensätze wie Kontakte, Leads, Accounts oder Opportunities gelesen, geschrieben und aktualisiert werden.
Voraussetzungen
Zur Nutzung des Konnektors wird ein Salesforce-Benutzer mit Webservice-Zugriff benötigt.
Der Benutzer muss über ausreichende Berechtigungen für die jeweiligen Objekte und Felder verfügen, die in der Synchronisation verwendet werden.
Einrichtung
1. Neues System anlegen
- Erstellen Sie in Syncler ein neues System mit dem Typ „Salesforce“.
- Geben Sie Name und Beschreibung an.
2. Verbindung konfigurieren
Tragen Sie die folgenden Zugangsdaten in den Systemeinstellungen ein:
| Einstellung | Beschreibung |
|---|---|
| Webservice Benutzername | Der Benutzername des Salesforce-Kontos, das für die Synchronisation verwendet wird. Der Benutzer benötigt die entsprechenden Berechtigungen für den Zugriff auf alle relevanten Entitäten. |
| Webservice Passwort | Das Passwort des oben genannten Benutzers. |
| Sicherheitstoken | Das Sicherheitstoken des Benutzers. Es wird über „Mein Sicherheitstoken zurücksetzen“ in den Benutzer-Einstellungen in Salesforce generiert. Das Token ändert sich automatisch bei jeder Passwortänderung. |
| Login Server URL | URL der Salesforce-Umgebung: • Produktivumgebung: https://login.salesforce.com/services/Soap/u/57.0• Sandbox/Test: https://test.salesforce.com/services/Soap/u/57.0 |
| Dublettenwarnungen ignorieren | Wenn aktiv, werden Dublettenwarnungen von Salesforce bei der Anlage neuer Datensätze ignoriert. Die Dublettenregel in Salesforce muss in diesem Fall auf „warnen“ und nicht auf „blockieren“ gestellt sein. |
| OAuth verwenden | Wenn OAuth aktiviert wird, läuft die Anmeldung über ClientId und ClientSecret. Dazu muss eine externen Client-Anwendung im Salesforce erstellt werden. Bei OAuth ist als Login Server URL die "Meine Domäne" (falls vorhanden) zu verwenden. |
| ClientId | Verbraucherschlüssel der externen Client-Anwendung |
| ClientSecret | Verbrauchergeheimnis der externen Client-Anwendung |
Tipp:
Es wird empfohlen, den für die Synchronisation verwendeten Benutzer so zu konfigurieren,
dass das Passwort nicht automatisch abläuft (z. B. über einen Berechtigungssatz in Salesforce).
Funktionen
Schema ermitteln
Das Schema der verfügbaren Salesforce-Objekte wird über die API automatisch abgerufen.
Dabei werden alle Standard- und benutzerdefinierten Felder geladen, die für den angegebenen Benutzer sichtbar sind.
Lesen von Daten
- Datensätze können nach ID oder über Filterbedingungen (z. B.
WHERE-Klauseln) abgerufen werden. - Das Lesen kann über Universal Syncs oder objektspezifische Sync-Vorlagen erfolgen.
Schreiben von Daten
- Datensätze können erstellt, geändert oder gelöscht werden.
- Bei aktivierter Option „Dublettenwarnungen ignorieren“ werden Dublettenmeldungen in Salesforce übersprungen, sofern diese als Warnung konfiguriert sind.
Lesen von Abfragen
- Abfragen können über SOQL (Salesforce Object Query Language) definiert werden.
- Ergebnisse können als Basis für weitere Verarbeitungsschritte oder Datentransformationen verwendet werden.
Besonderheiten
Sicherheitstoken:
Das Sicherheitstoken ist ein zusätzlicher Authentifizierungsparameter, der bei jeder Passwortänderung neu generiert werden muss.
Bewahren Sie das Token sicher auf und stellen Sie sicher, dass es in Syncler aktuell ist.Dublettenwarnungen:
Wenn Salesforce eine Dublette erkennt, kann dies zu einem Warnhinweis oder einer Blockade führen.
Mit der Option „Dublettenwarnungen ignorieren“ werden Warnungen automatisch übersprungen, um Synchronisationsabbrüche zu vermeiden.Datei Upload:
Dateien können als Anhang über das Schemaobjekt Attachment abgelegt werden. Der Dateiinhalt wird dabei als Base64 dem Feld "body" zugewiesen.Dateien können als Salesforce File über das Schemaobjekt ContentVersion abgelegt werden. Der Dateiinhalt wird dabei als Base64 dem Feld "VersionData" zugewiesen.
Erstellen einer externen Client-Anwendung
Eine neue externe Client-Anwendung kann in Salesforce unter „Setup“ -> „Manager der externen Client-Anwendung“ -> „Neue externe Client-Anwendung“ erstellt werden.
Nach Erstellung kann bei Auswahl der externen Client-Anwendung die ClientId und das ClientSecret unter „Einstellungen“ -> „OAuth-Einstellungen“ -> „Verbraucherschlüssel und -geheimnis“ gefunden werden
| Einstellungen | Inhalt |
|---|---|
| Name der externen Client-Anwendung | Syncler |
| API Name | Syncler |
| Kontakt-E-Mail | Frei wählbar |
| Verteilungsstatus | Lokal (bei einmaliger Einrichtung) Im Paket (falls Verwendung in Unlocked Package) |
| Oauth aktivieren | True |
| Rückmeldungs-URL | https://admin.syncler.com/oauth-callback.html (theoretisch irrelevant) |
| OAuth Scopes | Benutzerdaten über APIs verwalten (api) |
| Flow-Aktivierung | Flow für Client-Anmeldeinformationen aktivieren |
| Sicherheit | Default: Geheimnis für Webserver-Flow erforderlich, Geheimnis für Aktualisierungstoken-Flow erforderlich, Erweiterung "Proof Key for Code Exchange (PKCE)" für unterstützte Autorisierungs-Flows anfordern |
| Richtlinien (kann erst nach Speichern editiert werden) |
|
| Startseite | OAuth |
| Zulässige Benutzer | Alle benutzer können sich selbst authorisieren |
| OAuth-Start-URL | https://login.salesforce.com/services/oauth2/authorize oder https://deinedomain.my.salesforce.com/services/oauth2/authorize (theoretisch irrelevant) |
| Flow für Client-Anmeldeinformationen aktivieren | True |
| Ausführen als (Benutzername) | Benutzername des Integrations-Benutzers |