|
Klassiska filtyper är inte längre tillgängliga för användning från och med januari 2021. Du kan överföra dina klassiska filer eller ladda ner en PDF. Läs mer

Workiva supportcenter

Koppling till Salesforce

Koppling till Salesforce

  • Senast uppdaterad

Med Salesforce® Connector kan du använda kommandon för att interagera med Salesforce som en del av en kedja. Med den här kontakten kan du t.ex:

  • Ladda upp, extrahera och radera data i Salesforce via SOQL och bulkoperationer
  • Skapa och hantera Salesforce-objekt
  • Uppdatera och skapa poster i Salesforce

Anslutningen interagerar med alla versioner av Salesforce Sales Cloud:

  • Salesforce Essentials® (grundläggande information om Salesforce)
  • Salesforce Net Zero Cloud
  • Lightning® Professionell
  • Lightning Enterprise
  • Blixtar utan gränser
Obs: Denna kontakt är byggd av Workiva och ansluts till ett system från tredje part. Vår support kan hjälpa till att konfigurera den här anslutningen i din arbetsyta, men vi kan inte felsöka eller på annat sätt hjälpa till med problem som uppstår utanför Workiva-plattformen.

Krav

För att göra kontakten tillgänglig för användning i din organisation måste en org säkerhetsadministratör först aktivera den.

Du kan sedan säkra din anslutning till Salesforce med hjälp av någon av följande metoder:

  • Salesforce OAuth-autentisering med hjälp av ett klient-ID, en hemlighet och ett scope
  • Grundläggande autentisering med användarnamn och lösenord
  • Klientuppgifter, endast med hjälp av ett klient-ID och en hemlighet

Salesforce OAuth-autentisering

För att ansluta till Workiva behöver du klient-ID och hemlighet från Salesforce samt den anslutna appens OAuth-scope.

OAuth-autentisering kräver dessutom användning av en ansluten Salesforce-app. För att skapa detta i Salesforce, , konfigurera appen och konfigurera följande obligatoriska inställningar:

  • För Återuppringnings-URLanger du något av följande som matchar din AppSpot:
    • USA, Centralamerika, Sydamerika: https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
    • Asien-Stillahavsområdet: https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
    • Kanada: https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
    • EMEA: https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
  • Under Selected OAuth Scopes, ingår Utför förfrågningar för din räkning när som helst (refresh_token, offline_access) och minst ett annat scope.
     

Grundläggande autentisering

För att ansluta till Workiva behöver du integrationsanvändarens användarnamn, lösenord och säkerhetstoken från Salesforce.

Grundläggande autentisering kräver en integrationsanvändare med API-aktiverade behörigheter, utöver behörigheter relaterade till alla uppgifter som connectorn ska utföra.

Obs: Om du vill ange integrationsanvändarens behörighet i Salesforce väljer du Administer, Manage Users, Profiles, och väljer användarens profil.
  1. Under Administrativa behörigheterväljer du API aktiverat.
  2. För att kontakten ska kunna utföra ett kommando måste användaren ha minst Läs behörighet till dess relaterade data. 
  3. För att utföra massuppdateringar av Salesforce-objekt måste användaren ha Redigera behörighet till objektet.
     

Autentisering av klientlegitimation

För att ansluta till Workiva behöver du klient-ID och hemlighet från Salesforce.

Autentisering av klientuppgifter kräver användning av en ansluten Salesforce-app. För att skapa detta i Salesforce, konfigurera appen med hjälp av klientuppgifterflödet.

 

Konfigurera Salesforce-anslutningen för OAuth-autentisering

Med OAuth-autentisering kan du få åtkomst till Salesforce med hjälp av ett klient-ID och en hemlighet. Till skillnad från inloggningsmetoden med klientreferenser innehåller OAuth-autentisering en uppdateringstoken och kräver ett scope.

Den här metoden rekommenderas för kommandon som körs under längre tid och som annars skulle bli tidsbegränsade om man använde metoden med klientautentiseringsuppgifter.

  1. Från Kedjebyggareklickar du på compare_arrowsAnslutningar i den vänstra sidofältet och sedan på compare_arrowsSkapa längst upp till höger.
  2. Under Connector Connection väljer du Salesforce och standard CloudRunner.
  3. Under Basic Info anger du ett unikt namn och en beskrivning som hjälper dig att identifiera kontakten.

  4. Under Egenskaperanger du den Salesforce-instans eller anpassade domän som du vill ansluta till:

    Egenskap Information
    Instans

    Ange den Salesforce-instans som du vill ansluta till. Om din organisation använder en anpassad Salesforce-domän, lämna det här fältet tomt.

    Obs: I din URL till Salesforce representerar tecknen före salesforce.com- t.ex. na73- instansen.
    Anpassad domän

    Ange den anpassade Salesforce-domänen att ansluta till, om den används.

    Obs: Om du vill visa din anpassade domän i Salesforce väljer du Company Settings, My Domain. En anpassad domän slutar vanligtvis med .my.salesforce.com.
  5. För Autentiseringstyp väljer du Salesforce OAuth.

  6. Ange klient-ID, hemlighet och omfattning under Autentiseringoch klicka sedan på Anslut.
    2024-06-10_11-51-18.png

    Obs: När anslutningen till Salesforce lyckas fylls anslutningens Uppdateringstoken och Åtkomsttokeni automatiskt. Om det gick inte att ansluta klickar du på Stoppa och väntar på att ansluta igen.
    Obs: Alla känsliga uppgifter krypteras automatiskt och lagras med AES-256-kryptering.
  7. Välj de miljöer som ska användas med anslutningen och klicka på Save.
  8. Testa anslutningen genom att skapa och köra en kedja med -anslutningens List Reports -kommando, och kontrollera att den returnerar en giltig utdata.

Konfigurera Salesforce-anslutningen för grundläggande autentisering

Med grundläggande autentisering kan du logga in i Salesforce med hjälp av en integrationsanvändares användarnamn och lösenord.

  1. Från Kedjebyggareklickar du på compare_arrowsAnslutningar i den vänstra sidofältet och sedan på compare_arrowsSkapa längst upp till höger.
  2. Under Connector Connection väljer du Salesforce och standard CloudRunner.
  3. Under Basic Info anger du ett unikt namn och en beskrivning som hjälper dig att identifiera kontakten.

  4. Under Egenskaperanger du den Salesforce-instans eller anpassade domän som du vill ansluta till:

    Egenskap Information
    Instans

    Ange den Salesforce-instans som du vill ansluta till. Om din organisation använder en anpassad Salesforce-domän, lämna den tom.

    Obs: I din URL till Salesforce representerar tecknen före salesforce.com- t.ex. na73- instansen.
    Anpassad domän

    Ange den anpassade Salesforce-domänen att ansluta till, om den används.

    Obs: Om du vill visa din anpassade domän i Salesforce väljer du Company Settings, My Domain. En anpassad domän slutar vanligtvis med .my.salesforce.com.
  5. För Autentiseringstyp väljer du Basic Auth.

  6. Under Authentication anger du integrationsanvändarens användarnamn, lösenord och säkerhetstoken.2024-06-10_11-41-07.png

    Obs: Alla känsliga uppgifter krypteras automatiskt och lagras med Advanced Encryption Standard (AES)-256-kryptering.
  7. Välj de miljöer som ska användas med anslutningen och klicka på Save.
  8. Testa anslutningen genom att skapa och köra en kedja med -anslutningens List Reports -kommando, och kontrollera att den returnerar en giltig utdata.
     

Konfigurera Salesforce-anslutningen för kundautentiseringsuppgifter

Autentisering med klientuppgifter gör att du kan få åtkomst till Salesforce med hjälp av ett klient-ID och en hemlighet. Detta skiljer sig från OAuth-inloggningsmetoden genom att det inte krävs något scope, och du behöver inte autentisera dig i Salesforce via knappen Connect. 

Varning: Denna autentiseringsmetod innehåller inte en uppdateringstoken. På grund av detta är den inte lämplig för långa kommandon och kan leda till tidsavbrott i vissa kedjor.
  1. Från Kedjebyggareklickar du på compare_arrowsAnslutningar i den vänstra sidofältet och sedan på compare_arrowsSkapa längst upp till höger.
  2. Under Connector Connection väljer du Salesforce och standard CloudRunner.
  3. Under Basic Info anger du ett unikt namn och en beskrivning som hjälper dig att identifiera kontakten.

  4. Under Egenskaperanger du den Salesforce-instans eller anpassade domän som du vill ansluta till:

    Egenskap Information
    Instans

    Ange den Salesforce-instans som du vill ansluta till. Om din organisation använder en anpassad Salesforce-domän, lämna den tom.

    Obs: I din Salesforce-URL representerar tecknen före salesforce.com – till exempel na73– instansen.
    Anpassad domän

    Ange den anpassade Salesforce-domänen att ansluta till, om den används.

    Obs: Om du vill visa din anpassade domän i Salesforce väljer du Company Settings, My Domain. En anpassad domän slutar vanligtvis med .my.salesforce.com.
  5. Välj Client Credentials för Authentication Type.2024-06-10_12-32-47.png

  6. Under Authentication anger du klient-ID och hemlighet.

    Obs: Alla känsliga uppgifter krypteras automatiskt och lagras med AES-256-kryptering.
  7. Välj de miljöer som ska användas med anslutningen och klicka på Save.
  8. Testa anslutningen genom att skapa och köra en kedja med -anslutningens List Reports -kommando, och kontrollera att den returnerar en giltig utdata.

Felsökning

Om anslutningen till Salesforce går inte kan du kontrollera flera konfigurationsinställningar, beroende på autentiseringstyp.

 

OAuth2-autentisering

Om anslutningen till den Salesforce-anslutna appen gick inte när du först klickade på Anslut, klicka på Stoppa och vänta med att ansluta igen. Om anslutningen fortsätter att misslyckas med hjälp av OAuth2-autentisering:

  • Kontrollera att rätt Salesforce-instans eller anpassad domän har angetts för kontakten.
  • Kontrollera klient-ID och hemlighet för den Salesforce-anslutna app som kontakten använder.
  • I den anslutna Salesforce-appen:
    • Kontrollera att återuppringnings-URL:en är korrekt:
    • För USA, Centralamerika, Sydamerika: https://h.app.wdesk.com/s/wdata/oc/app/oauth/callback
    • För Asien-Stillahavsområdet: https://h.apac.wdesk.com/s/wdata/oc/app/oauth/callback
    • För Kanada: https://h.ca.wdesk.com/s/wdata/oc/app/oauth/callback
    • För EMEA: https://h.eu.wdesk.com/s/wdata/oc/app/oauth/callback
    • Se till att dess valda OAuth-scopes inkluderar Utför förfrågningar för din räkning när som helst (refresh_token, offline_access) och minst ett annat scope.

Om anslutningen förlorar sin anslutning till Salesforce-appen:

  1. Från Kedjebyggareklickar du på compare_arrowsAnslutningar i den vänstra sidofältet och klickar sedan på Redigera (pennikon) för anslutningen.
  2. Under OAuth klickar du på Återställ.
  3. Klicka på Allow för att göra det möjligt för kontakten att ansluta till Salesforce.
     

Grundläggande autentisering

Om anslutningen går inte att använda med grundläggande autentisering:

  • Verifiera integrationsanvändarens inloggningsuppgifter och säkerhetstoken. Om du vill begära en ny säkerhetstoken i Salesforce loggar du in som integrationsanvändare och väljer Inställningar, Min personliga information och klickar på Återställ säkerhetstoken.
  • Kontrollera att rätt Salesforce-instans eller anpassad domän har angetts för kontakten.
  • Se till att integrationsanvändaren har behörigheten API Enabled, utöver behörigheter relaterade till alla uppgifter som connectorn utför.
     

Autentisering av klientlegitimation

Om anslutningen inte går att använda med autentisering av klientuppgifter:

  • Kontrollera att rätt Salesforce-instans eller anpassad domän har angetts för kontakten.
  • Kontrollera klient-ID och hemlighet för den Salesforce-anslutna app som kontakten använder.
Med Salesforce® Connector kan du använda kommandon för att interagera med Salesforce som en del av en kedja. Med den ...