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, med endast 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 Salesforce-ansluten app. För att skapa detta i Salesforce, konfigurerar du appen och konfigurerar följande nödvändiga inställningar:
- För Callback URL, ange ett av följande som matchar din 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
- PROD -
- 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.
- Under Administrativa behörigheter, välj API Enabled.
- För att kontakten ska kunna utföra ett kommando måste användaren ha minst Läs behörighet till dess relaterade data.
- 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 med klientuppgifter kräver användning av en Salesforce-ansluten app. För att skapa detta i Salesforce, konfigurerar du appen med hjälp av flödet för klientuppgifter.
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.
- Från Chain Builder, klicka på Connections , och sedan Create längst upp till höger.
- Under Connector Connection väljer du Salesforce och standard CloudRunner.
- Under Basic Info anger du ett unikt namn och en beskrivning som hjälper dig att identifiera kontakten.
- Under Properties anger 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. - För Autentiseringstyp väljer du Salesforce OAuth.
- Ange klient-ID, hemlighet och omfattning under Authentication och klicka sedan på Connect.
Obs: När anslutningen till Salesforce lyckas fylls kontaktens Refresh Token och Access Token automatiskt i. 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.
- Välj de miljöer som ska användas med anslutningen och klicka på Save.
- 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.
- Från Chain Builder, klicka på Connections , och sedan Create längst upp till höger.
- Under Connector Connection väljer du Salesforce och standard CloudRunner.
- Under Basic Info anger du ett unikt namn och en beskrivning som hjälper dig att identifiera kontakten.
- Under Properties anger 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. - För Autentiseringstyp väljer du Basic Auth.
- Under Authentication anger du integrationsanvändarens användarnamn, lösenord och säkerhetstoken.
Obs: Alla känsliga uppgifter krypteras automatiskt och lagras med Advanced Encryption Standard (AES)-256-kryptering.
- Välj de miljöer som ska användas med anslutningen och klicka på Save.
- 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.
- Från Chain Builder, klicka på Connections , och sedan Create längst upp till höger.
- Under Connector Connection väljer du Salesforce och standard CloudRunner.
- Under Basic Info anger du ett unikt namn och en beskrivning som hjälper dig att identifiera kontakten.
- Under Properties anger 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. - Välj Client Credentials för Authentication Type.
- Under Authentication anger du klient-ID och hemlighet.
Obs: Alla känsliga uppgifter krypteras automatiskt och lagras med AES-256-kryptering.
- Välj de miljöer som ska användas med anslutningen och klicka på Save.
- 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 URL:en för återuppringning är:
- 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
- PROD -
- 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.
- Kontrollera att URL:en för återuppringning är:
Om anslutningen förlorar sin anslutning till Salesforce-appen:
- Från Chains, klicka på Connections , markera kopplingen och klicka på Edit.
- Under OAuth klickar du på Återställ.
- 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.