Connector naar Salesforce

Met de Salesforce®-connector kunt u commando's gebruiken voor interactie met Salesforce als onderdeel van een keten. Met deze connector kunt u bijvoorbeeld:

Gegevens uploaden, extraheren en verwijderen in Salesforce via SOQL en bulkbewerkingen
Salesforce-objecten maken en beheren
Records bijwerken en aanmaken in Salesforce

De connector werkt met alle versies van Salesforce Sales Cloud:

Salesforce Essentials®
Salesforce Net Zero Cloud
Lightning® Professional
Lightning Onderneming
Bliksem Onbeperkt

Opmerking: Deze connector is gebouwd door Workiva en maakt verbinding met een systeem van derden. Hoewel ons Support team kan helpen bij het configureren van deze connector binnen uw workspace, kunnen wij geen problemen oplossen of op een andere manier helpen met problemen die hun oorsprong vinden buiten het Workiva platform.

Vereisten

Om de connector beschikbaar te maken voor gebruik in uw organisatie, moet een beveiligingsbeheerder van org deze eerst inschakelen.

Vervolgens kunt u uw verbinding met Salesforce beveiligen met een van de volgende methoden:

Salesforce OAuth-authenticatie, met een client-ID, geheim en bereik
Basisverificatie, met een gebruikersnaam en wachtwoord
Clientgegevens, waarbij alleen een client-ID en geheim worden gebruikt

Salesforce OAuth-authenticatie

Om verbinding te maken met Workiva, hebt u de client ID en secret van Salesforce nodig, evenals de OAuth scope van de verbonden app.

Voor OAuth-authenticatie is bovendien het gebruik van een met Salesforce verbonden app vereist. Om deze in Salesforce te maken, stelt u de app in en configureert u de volgende vereiste instellingen:

Voer voor Callback URL een van de volgende in die overeenkomt met uw AppSpot:
- PROD - https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
- EMEA - https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
- APAC - https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
Onder Geselecteerde OAuth Scopes, omvat Voer op elk moment namens u verzoeken uit (refresh_token, offline_access) en ten minste één andere scope.

basisverificatie

Om verbinding te maken met Workiva, hebt u de gebruikersnaam van de integratiegebruiker, het wachtwoord en het beveiligingstoken van Salesforce nodig.

Basisauthenticatie vereist een integratiegebruiker met API-machtigingen, naast machtigingen voor taken die de connector zal uitvoeren.

Opmerking: Om de machtigingen van de integratiegebruiker in Salesforce in te stellen, selecteert u Beheer, Gebruikers beheren, Profielen, en selecteert u hun profiel.

Selecteer onder Administratieve machtigingen API ingeschakeld.
Om de connector in staat te stellen een opdracht uit te voeren, heeft de gebruiker ten minste Read rechten op de gerelateerde gegevens nodig.
Om bulkupdates van Salesforce-objecten uit te voeren, heeft de gebruiker Edit rechten op het object nodig.

Verificatie van cliëntgegevens

Om verbinding te maken met Workiva, hebt u de client ID en secret van Salesforce nodig.

Voor authenticatie met klantgegevens is het gebruik van een met Salesforce verbonden app vereist. Om deze in Salesforce te maken, stelt u de app in met behulp van de client credentials flow.

De Salesforce-connector instellen voor OAuth-verificatie

Met OAuth-verificatie kunt u toegang krijgen tot Salesforce met behulp van een client-ID en een geheim. In tegenstelling tot de aanmeldingsmethode met clientreferenties, bevat OAuth-authenticatie een verversingstoken en is er een bereik nodig.

Deze methode wordt aanbevolen voor langer lopende opdrachten die anders zouden uitlopen met de methode van de cliëntreferenties.

Ga naar Chain Builder, klik op Connectionscompare_arrows, en vervolgens op Create rechtsboven.
Selecteer onder Connector Connection, Salesforce en de standaard CloudRunner.
Voer onder Basisinfo een unieke naam en beschrijving in om de connector te helpen identificeren.

Voer onder Eigenschappen de Salesforce-instantie of het aangepaste domein in waarmee u verbinding wilt maken:

Eigendom	Details
Instantie	Voer de Salesforce-instantie in waarmee u verbinding wilt maken. Laat leeg als uw organisatie een aangepast Salesforce-domein gebruikt. Opmerking: In uw Salesforce URL vertegenwoordigen de tekens voor `salesforce.com`-zoals `na73`- de instantie.
Aangepast domein	Voer het aangepaste Salesforce-domein in waarmee verbinding moet worden gemaakt, indien gebruikt. Opmerking: Als u uw aangepaste domein in Salesforce wilt weergeven, selecteert u Bedrijfsinstellingen, Mijn domein. Een aangepast domein eindigt meestal op `.my.salesforce.com`.

Selecteer voor Authenticatietype Salesforce OAuth.
Voer de client-ID, het geheim en het bereik in onder Authentication en klik vervolgens op Connect.
Opmerking: Als de verbinding met Salesforce geslaagd is, worden de Refresh Token en Access Token van de connector automatisch ingevuld. Als de verbinding mislukt, klikt u op Stop en wacht u tot u opnieuw verbinding kunt maken.

Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met AES-256 codering.
Selecteer de omgevingen die u met de verbinding wilt gebruiken en klik op Opslaan.
Om de verbinding te testen, maakt een ketting aan en voert deze uit met de connector's List Reports opdracht, en controleer of deze een geldige uitvoer oplevert.

De Salesforce-connector instellen voor basisverificatie

Met basisverificatie kunt u inloggen bij Salesforce met de gebruikersnaam en het wachtwoord van een integratiegebruiker.

Ga naar Chain Builder, klik op Connectionscompare_arrows, en vervolgens op Create rechtsboven.
Selecteer onder Connector Connection, Salesforce en de standaard CloudRunner.
Voer onder Basisinfo een unieke naam en beschrijving in om de connector te helpen identificeren.

Voer onder Eigenschappen de Salesforce-instantie of het aangepaste domein in waarmee u verbinding wilt maken:

Eigendom	Details
Instantie	Voer de Salesforce-instantie in waarmee u verbinding wilt maken. Laat leeg als uw organisatie een aangepast Salesforce-domein gebruikt. Opmerking: In uw Salesforce URL vertegenwoordigen de tekens voor `salesforce.com`-zoals `na73`- de instantie.
Aangepast domein	Voer het aangepaste Salesforce-domein in waarmee verbinding moet worden gemaakt, indien gebruikt. Opmerking: Als u uw aangepaste domein in Salesforce wilt weergeven, selecteert u Bedrijfsinstellingen, Mijn domein. Een aangepast domein eindigt meestal op `.my.salesforce.com`.

Selecteer voor Authenticatietype Basic Auth.
Voer onder Authenticatie de gebruikersnaam, het wachtwoord en het beveiligingstoken van de integratiegebruiker in.
Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met Advanced Encryption Standard (AES)-256 codering.
Selecteer de omgevingen die u met de verbinding wilt gebruiken en klik op Opslaan.
Om de verbinding te testen, maakt een ketting aan en voert deze uit met de connector's List Reports opdracht, en controleer of deze een geldige uitvoer oplevert.

De Salesforce-connector instellen voor klantgegevens

Met authenticatie op basis van klantgegevens krijgt u toegang tot Salesforce met behulp van een klant-ID en een geheim. Dit verschilt van de OAuth aanmeldingsmethode in die zin dat er geen scope nodig is, en u zich niet bij Salesforce hoeft te verifiëren via de knop Connect.

Waarschuwing: Deze verificatiemethode bevat geen verversingstoken. Hierdoor is het niet geschikt voor langlopende commando's en kan het leiden tot time-outs in bepaalde ketens.

Ga naar Chain Builder, klik op Connectionscompare_arrows, en vervolgens op Create rechtsboven.
Selecteer onder Connector Connection, Salesforce en de standaard CloudRunner.
Voer onder Basisinfo een unieke naam en beschrijving in om de connector te helpen identificeren.

Voer onder Eigenschappen de Salesforce-instantie of het aangepaste domein in waarmee u verbinding wilt maken:

Eigendom	Details
Instantie	Voer de Salesforce-instantie in waarmee u verbinding wilt maken. Laat leeg als uw organisatie een aangepast Salesforce-domein gebruikt. Opmerking: In uw Salesforce URL vertegenwoordigen de tekens voor `salesforce.com`-zoals `na73`- de instantie.
Aangepast domein	Voer het aangepaste Salesforce-domein in waarmee verbinding moet worden gemaakt, indien gebruikt. Opmerking: Als u uw aangepaste domein in Salesforce wilt weergeven, selecteert u Bedrijfsinstellingen, Mijn domein. Een aangepast domein eindigt meestal op `.my.salesforce.com`.

Selecteer voor Authenticatietype Client Credentials.
Voer onder Authentication de client ID en secret in.
Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met AES-256 codering.
Selecteer de omgevingen die u met de verbinding wilt gebruiken en klik op Opslaan.
Om de verbinding te testen, maakt een ketting aan en voert deze uit met de connector's List Reports opdracht, en controleer of deze een geldige uitvoer oplevert.

Probleemoplossing

Als de verbinding met Salesforce mislukt, kunt u verschillende configuratie-instellingen controleren, afhankelijk van het verificatietype.

OAuth2-authenticatie

Als de verbinding met de met Salesforce verbonden app mislukt wanneer u voor het eerst op Connect klikt, klik dan op Stop, en wacht tot u opnieuw verbinding kunt maken. Als de verbinding blijft mislukken met OAuth2-verificatie:

Controleer of de juiste Salesforce-instantie of het juiste aangepaste domein zijn ingevoerd voor de connector.
Controleer de client-ID en het geheim van de met Salesforce verbonden app die de connector gebruikt.
In de app Salesforce connected:
- Controleer of de callback URL is:
  - PROD - https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
  - EMEA - https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
  - APAC - https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
- Zorg ervoor dat de geselecteerde OAuth-scopes omvatten. Voer op elk moment namens u verzoeken uit (refresh_token, offline_access) en . Ten minste één andere scope.

Als de connector de verbinding met de Salesforce app verliest:

Ga naar Ketens, klik op Verbindingenvergelijk_pijlen, selecteer de verbinding en klik op Bewerken.
Klik onder OAuth op Reset.
Om de connector in te schakelen voor verbinding met Salesforce, klikt u op Toestaan.

basisverificatie

Als de verbinding mislukt met basisverificatie:

Controleer de aanmeldingsgegevens en het beveiligingstoken van de integratiegebruiker. Om een nieuw beveiligingstoken aan te vragen in Salesforce, meldt u zich aan als de integratiegebruiker en selecteert u Instellingen, Mijn persoonlijke gegevens en klikt u op Beveiligingstoken opnieuw instellen.
Controleer of de juiste Salesforce-instantie of het juiste aangepaste domein zijn ingevoerd voor de connector.
Zorg ervoor dat de integratiegebruiker machtigingen heeft voor API Enabled, naast machtigingen voor taken die de connector uitvoert.

Verificatie van cliëntgegevens

Als de verbinding mislukt met behulp van authenticatie via client geloofsbrieven:

Controleer of de juiste Salesforce-instantie of het juiste aangepaste domein zijn ingevoerd voor de connector.
Controleer de client-ID en het geheim van de met Salesforce verbonden app die de connector gebruikt.

Ondersteuning

Community

Workiva-ondersteuningscentrum