|
Klassieke bestandstypen zijn vanaf januari 2021 niet meer beschikbaar voor gebruik. U kunt uw klassieke bestanden omzetten of een PDF downloaden. Meer informatie

Workiva-ondersteuningscentrum

Verbinding met Salesforce

Verbinding met Salesforce

  • Laatst bijgewerkt op

Met de Salesforce®-connector kunt u opdrachten gebruiken om met Salesforce te communiceren als onderdeel van een keten. Met deze connector kunt u bijvoorbeeld het volgende doen:

  • 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
  • Bliksemonderneming
  • Bliksem Onbeperkt
Opmerking: Deze connector is gebouwd door Workiva en maakt verbinding met een systeem van derden. Hoewel ons supportteam u kan helpen bij het configureren van deze connector binnen uw werkruimte, kunnen we geen problemen oplossen of anderszins ondersteuning bieden bij problemen die buiten het Workiva-platform ontstaan.

Vereisten

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

U kunt uw verbinding met Salesforce vervolgens beveiligen met behulp van een van de volgende methoden:

  • Salesforce OAuth-authenticatie met behulp van 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 het geheim van Salesforce nodig, evenals de OAuth -scope van de verbonden app.

OAuth-authenticatie vereist bovendien het gebruik van een met Salesforce verbonden app. Om dit in Salesforce te creëren, , stel de app in en configureer de volgende vereiste instellingen:

  • Voer voor Callback URLeen van de volgende opties in die overeenkomt met uw AppSpot:
    • VS, Centraal-Amerika, Zuid-Amerika: https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
    • APAC: https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
    • Canada: https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
    • EMEA: https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
  • Onder Geselecteerde OAuth-scopes, voeg Verzoeken namens u uitvoeren op elk moment (refresh_token, offline_access) en ten minste één andere scopetoe .
     

basisverificatie

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

Voor basisauthenticatie is een integratiegebruiker met API-toegangsrechten vereist, evenals rechten met betrekking tot alle 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.
  1. Selecteer onder Administratieve machtigingende optie API ingeschakeld.
  2. Om de connector een opdracht te laten uitvoeren, heeft de gebruiker minimaal Leesrechten nodig voor de bijbehorende gegevens. 
  3. Om bulkupdates uit te voeren op Salesforce-objecten, heeft de gebruiker bewerkingsrechten ( Edit ) nodig voor het object.
     

Authenticatie van clientreferenties

Om verbinding te maken met Workiva, heb je de client-ID en het geheim van Salesforce nodig.

Authenticatie met clientreferenties vereist het gebruik van een met Salesforce verbonden app. Om dit in Salesforce te creëren, stelt u de app in met behulp van de clientreferentiestroom.

 

Configureer de Salesforce-connector voor OAuth-authenticatie.

Met OAuth-authenticatie kunt u toegang krijgen tot Salesforce met behulp van een client-ID en een clientgeheim. In tegenstelling tot de inlogmethode met clientreferenties, omvat OAuth-authenticatie een vernieuwingstoken en vereist een scope.

Deze methode wordt aanbevolen voor langlopende opdrachten die anders zouden verlopen bij gebruik van de clientreferenties.

  1. Klik in Chain Builderop compare_arrowsConnections in de linkerzijbalk en vervolgens op compare_arrowsCreate rechtsboven.
  2. Selecteer onder Connector Connectionde optie Salesforce en de standaard CloudRunner.
  3. Voer onder Basisinfoeen unieke naam en beschrijving in om de connector te identificeren.

  4. Voer onder Eigenschappenhet Salesforce-exemplaar of het aangepaste domein in waarmee u verbinding wilt maken:

    Eigendom Details
    Aanleg

    Voer het Salesforce-exemplaar in waarmee u verbinding wilt maken. Als uw organisatie een aangepast Salesforce-domein gebruikt, laat u dit veld leeg.

    Opmerking: In uw Salesforce-URL vertegenwoordigen de tekens vóór salesforce.com—zoals na73—het exemplaar.
    Aangepast domein

    Voer het aangepaste Salesforce-domein in waarmee u verbinding wilt maken, indien van toepassing.

    Opmerking: Om uw aangepaste domein in Salesforce te bekijken, selecteert u Bedrijfsinstellingen, Mijn domein. Een aangepast domein eindigt meestal met .my.salesforce.com.
  5. Selecteer bij 'Authenticatietype' de optie Salesforce OAuth.

  6. Voer de client-ID, het geheim en het bereik in onder Authenticatieen klik vervolgens op Verbinden.
    2024-06-10_11-51-18.png

    Opmerking: Wanneer de verbinding met Salesforce is geslaagd, worden de Vernieuwingstoken en Toegangstokenvan de connector automatisch ingevuld. Als de verbinding mislukt, klik dan op Stop en wacht tot de verbinding opnieuw tot stand is gebracht.
    Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met AES-256-codering.
  7. Selecteer de omgevingen die u met de verbinding wilt gebruiken en klik op Opslaan.
  8. Om de verbinding te testen, maak en voer een keten uit met het commando List Reports van de connector encontroleer of deze een geldige uitvoer retourneert.

Configureer de Salesforce-connector voor basisverificatie.

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

  1. Klik in Chain Builderop compare_arrowsConnections in de linkerzijbalk en vervolgens op compare_arrowsCreate rechtsboven.
  2. Selecteer onder Connector Connectionde optie Salesforce en de standaard CloudRunner.
  3. Voer onder Basisinfoeen unieke naam en beschrijving in om de connector te identificeren.

  4. Voer onder Eigenschappenhet Salesforce-exemplaar of het aangepaste domein in waarmee u verbinding wilt maken:

    Eigendom Details
    Aanleg

    Voer het Salesforce-exemplaar in waarmee u verbinding wilt maken. Als uw organisatie een aangepast Salesforce-domein gebruikt, laat dit veld dan leeg.

    Opmerking: In uw Salesforce-URL vertegenwoordigen de tekens vóór salesforce.com—zoals na73—het exemplaar.
    Aangepast domein

    Voer het aangepaste Salesforce-domein in waarmee u verbinding wilt maken, indien van toepassing.

    Opmerking: Om uw aangepaste domein in Salesforce te bekijken, selecteert u Bedrijfsinstellingen, Mijn domein. Een aangepast domein eindigt meestal met .my.salesforce.com.
  5. Selecteer bij 'Authenticatietype' de optie 'Basic Auth ]' .

  6. Voer onder Authenticatiede gebruikersnaam, het wachtwoord en het beveiligingstoken van de integratiegebruiker in.2024-06-10_11-41-07.png

    Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met behulp van de Advanced Encryption Standard (AES)-256-codering.
  7. Selecteer de omgevingen die u met de verbinding wilt gebruiken en klik op Opslaan.
  8. Om de verbinding te testen, maak en voer een keten uit met het commando List Reports van de connector encontroleer of deze een geldige uitvoer retourneert.
     

Configureer de Salesforce-connector voor clientreferenties.

Met clientreferentie-authenticatie kunt u Salesforce benaderen met een client-ID en -geheim. Dit verschilt van de OAuth-aanmeldingsmethode doordat er geen scope vereist is en u zich niet hoeft te authenticeren bij Salesforce via de Verbinden -knop. 

Waarschuwing: Deze authenticatiemethode bevat geen vernieuwingstoken. Hierdoor is het niet geschikt voor langlopende commando's en kan het in bepaalde reeksen tot time-outs leiden.
  1. Klik in Chain Builderop compare_arrowsConnections in de linkerzijbalk en vervolgens op compare_arrowsCreate rechtsboven.
  2. Selecteer onder Connector Connectionde optie Salesforce en de standaard CloudRunner.
  3. Voer onder Basisinfoeen unieke naam en beschrijving in om de connector te identificeren.

  4. Voer onder Eigenschappenhet Salesforce-exemplaar of het aangepaste domein in waarmee u verbinding wilt maken:

    Eigendom Details
    Aanleg

    Voer het Salesforce-exemplaar in waarmee u verbinding wilt maken. Als uw organisatie een aangepast Salesforce-domein gebruikt, laat dit veld dan leeg.

    Opmerking: In uw Salesforce-URL vertegenwoordigen de tekens vóór salesforce.com —zoals na73—het exemplaar.
    Aangepast domein

    Voer het aangepaste Salesforce-domein in waarmee u verbinding wilt maken, indien van toepassing.

    Opmerking: Om uw aangepaste domein in Salesforce te bekijken, selecteert u Bedrijfsinstellingen, Mijn domein. Een aangepast domein eindigt meestal met .my.salesforce.com.
  5. Selecteer bij 'Authenticatietype' de optie 'Clientreferenties ]' .2024-06-10_12-32-47.png

  6. Voer onder Authenticatiede client-ID en het geheim in.

    Opmerking: Alle gevoelige gegevens worden automatisch versleuteld en opgeslagen met AES-256-codering.
  7. Selecteer de omgevingen die u met de verbinding wilt gebruiken en klik op Opslaan.
  8. Om de verbinding te testen, maak en voer een keten uit met het commando List Reports van de connector encontroleer of deze een geldige uitvoer retourneert.

Probleemoplossing

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

 

OAuth2-authenticatie

Als de verbinding met de Salesforce-app mislukt wanneer u voor het eerst op Verbindenklikt, klikt u op Stoppenen wacht u tot de verbinding opnieuw tot stand is gebracht. Als de verbinding met OAuth2-authenticatie blijft mislukken:

  • Controleer of het juiste Salesforce-exemplaar of aangepaste domein is ingevoerd voor de connector.
  • Controleer de client-ID en het clientgeheim van de Salesforce-app waarmee de connector is verbonden.
  • In de Salesforce-app:
    • Controleer of de callback-URL correct is:
    • Voor de VS, Centraal-Amerika en Zuid-Amerika: https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
    • Voor APAC: https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
    • Voor Canada: https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
    • Voor EMEA: https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
    • Zorg ervoor dat de geselecteerde OAuth-scopes het volgende omvatten: Verzoeken namens u uitvoeren op elk moment (refresh_token, offline_access) en ten minste één andere scope.

Als de connector de verbinding met de Salesforce-app verliest:

  1. Klik in Chain Builderop compare_arrowsConnections in de linkerzijbalk en klik vervolgens op Edit (potloodpictogram) voor de verbinding.
  2. Klik onder OAuthop Reset.
  3. Om de connector verbinding te laten maken met Salesforce, klikt u op Toestaan​​ .
     

basisverificatie

Als de verbinding mislukt met behulp van basisverificatie:

  • Controleer de aanmeldingsgegevens en het beveiligingstoken van de gebruiker van de integratie. Om een ​​nieuw beveiligingstoken aan te vragen in Salesforce, meldt u zich aan als de integratiegebruiker en selecteert u Instellingen, Mijn persoonlijke gegevensen klikt u op Beveiligingstoken opnieuw instellen.
  • Controleer of het juiste Salesforce-exemplaar of aangepaste domein is ingevoerd voor de connector.
  • Zorg ervoor dat de integratiegebruiker de machtigingenAPI Enabled heeft, naast de machtigingen die betrekking hebben op alle taken die de connector uitvoert.
     

Authenticatie van clientreferenties

Als de verbinding mislukt bij gebruik van authenticatie met clientreferenties:

  • Controleer of het juiste Salesforce-exemplaar of aangepaste domein is ingevoerd voor de connector.
  • Controleer de client-ID en het clientgeheim van de Salesforce-app waarmee de connector is verbonden.
Met de Salesforce®-connector kunt u opdrachten gebruiken om met Salesforce te communiceren als onderdeel van een kete...