|
Klassiske filtyper er ikke lenger tilgjengelige for bruk fra og med januar 2021. Du kan overføre klassiske filer eller laste ned en PDF-fil. Finn ut mer

Workiva kundestøttesenter

Kobling til Salesforce

Kobling til Salesforce

  • Sist oppdatert

Med Salesforce® Connector kan du bruke kommandoer til å samhandle med Salesforce som en del av en kjede. Med denne kontakten kan du for eksempel

  • Last opp, hent ut og slett data i Salesforce via SOQL og bulkoperasjoner
  • Opprett og administrer Salesforce-objekter
  • Oppdatere og opprette poster i Salesforce

Koblingen samhandler med alle versjoner av Salesforce Sales Cloud:

  • Salesforce Essentials®
  • Salesforce Net Zero Cloud
  • Lightning® Professional
  • Lightning Enterprise
  • Lyn uten grenser
Merk: Denne kontakten er bygget av Workiva og kobles til et tredjepartssystem. Supportteamet vårt kan hjelpe deg med å konfigurere denne koblingen i arbeidsområdet ditt, men vi kan ikke feilsøke eller på annen måte hjelpe deg med problemer som oppstår utenfor Workiva-plattformen.

Krav

For å gjøre kontakten tilgjengelig for bruk i organisasjonen din, må en sikkerhetsadministrator i org først aktivere den.

Du kan deretter sikre tilkoblingen til Salesforce ved hjelp av en av følgende metoder:

  • Salesforce OAuth-autentisering ved hjelp av en klient-ID, hemmelighet og omfang
  • Grunnleggende autentisering med brukernavn og passord
  • Klientlegitimasjon, med kun en klient-ID og hemmelighet

Salesforce OAuth-autentisering

For å koble deg til Workiva trenger du klient-ID og hemmelighet fra Salesforce, samt den tilkoblede appens OAuth-scope.

OAuth-autentisering krever i tillegg bruk av en Salesforce-tilkoblet app. For å opprette denne i Salesforce, setter du opp appen og konfigurerer følgende nødvendige innstillinger:

  • For Callback URL, skriv inn en av følgende som samsvarer med 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
  • Under Selected OAuth Scopes, inkluderer du Utfør forespørsler på dine vegne når som helst (refresh_token, offline_access) og minst ett annet scope.

Grunnleggende autentisering

For å koble deg til Workiva trenger du integrasjonsbrukerens brukernavn, passord og sikkerhetstoken fra Salesforce.

Grunnleggende autentisering krever en integrasjonsbruker med API-aktiverte tillatelser, i tillegg til tillatelser knyttet til eventuelle oppgaver som koblingen skal utføre.

Merk: For å angi integrasjonsbrukerens tillatelser i Salesforce velger du Administer, Manage Users, Profiles, og velger profilen deres.
  1. Under Administrative tillatelser velger du API Enabled.
  2. For at kontakten skal kunne utføre en kommando, må brukeren ha minst Lesetillatelser til de relaterte dataene. 
  3. For å kunne utføre masseoppdateringer av Salesforce-objekter må brukeren ha Edit -tillatelser til objektet.

Autentisering av klientlegitimasjon

For å koble deg til Workiva trenger du klient-ID og hemmelighet fra Salesforce.

Autentisering av klientlegitimasjon krever bruk av en Salesforce-tilkoblet app. For å opprette dette i Salesforce, konfigurerer du appen ved hjelp av klientlegitimasjonsflyt.

Konfigurer Salesforce-tilkoblingen for OAuth-autentisering

OAuth-autentisering gir deg tilgang til Salesforce ved hjelp av en klient-ID og en hemmelighet. I motsetning til påloggingsmetoden med klientlegitimasjon inkluderer OAuth-autentisering et oppdateringstoken og krever et scope.

Denne metoden anbefales for kommandoer som kjører over lengre tid, og som ellers ville ha blitt tidsavbrutt ved bruk av klientlegitimasjonsmetoden.

  1. Fra Chain Builder klikker du på Connectionscompare_arrows, og deretter Create øverst til høyre.
  2. Under Connector Connection velger du Salesforce og standard CloudRunner.
  3. Under Basic Info angir du et unikt navn og en beskrivelse for å identifisere kontakten.
  4. Under Properties angir du Salesforce-forekomsten eller det egendefinerte domenet du vil koble til:
    Egenskap Detaljer
    Forekomst Angi Salesforce-forekomsten du vil koble til. Hvis organisasjonen bruker et egendefinert Salesforce-domene, lar du feltet stå tomt.
    Merk: I Salesforce-URL-en din representerer tegnene før salesforce.com- for eksempel na73-forekomsten.
    Tilpasset domene Angi det egendefinerte Salesforce-domenet du vil koble til, hvis det brukes.
    Merk: Hvis du vil vise det egendefinerte domenet ditt i Salesforce, velger du Company Settings, My Domain. Et egendefinert domene slutter vanligvis med .my.salesforce.com.
  5. For Autentiseringstype velger du Salesforce OAuth.
  6. Skriv inn klient-ID, hemmelighet og omfang under Authentication, og klikk deretter på Connect.2024-06-10_11-51-18.png
    Merk: Når tilkoblingen til Salesforce lykkes, fylles Refresh Token og Access Token automatisk inn i kontakten. Hvis tilkoblingen mislykkes, klikker du på Stop og venter på å koble til på nytt.
    Merk: Alle sensitive opplysninger krypteres automatisk og lagres med AES-256-kryptering.
  7. Velg miljøene som skal brukes med tilkoblingen, og klikk på Lagre.
  8. For å teste tilkoblingen kan du opprette og kjøre en kjede med -kontaktens List Reports -kommando, og kontrollere at den returnerer en gyldig utdata.

Konfigurer Salesforce-tilkoblingen for grunnleggende autentisering

Med grunnleggende autentisering kan du logge på Salesforce ved hjelp av brukernavnet og passordet til en integrasjonsbruker.

  1. Fra Chain Builder klikker du på Connectionscompare_arrows, og deretter Create øverst til høyre.
  2. Under Connector Connection velger du Salesforce og standard CloudRunner.
  3. Under Basic Info angir du et unikt navn og en beskrivelse for å identifisere kontakten.
  4. Under Properties angir du Salesforce-forekomsten eller det egendefinerte domenet du vil koble til:
    Egenskap Detaljer
    Forekomst Angi Salesforce-forekomsten du vil koble til. Hvis organisasjonen bruker et egendefinert Salesforce-domene, lar du feltet stå tomt.
    Merk: I Salesforce-URL-en din representerer tegnene før salesforce.com- for eksempel na73-forekomsten.
    Tilpasset domene Angi det egendefinerte Salesforce-domenet du vil koble til, hvis det brukes.
    Merk: Hvis du vil vise det egendefinerte domenet ditt i Salesforce, velger du Company Settings, My Domain. Et egendefinert domene slutter vanligvis med .my.salesforce.com.
  5. For Autentiseringstype velger du Basic Auth.
  6. Under Authentication skriver du inn integrasjonsbrukerens brukernavn, passord og sikkerhetstoken.2024-06-10_11-41-07.png
    Merk: Alle sensitive opplysninger krypteres automatisk og lagres med Advanced Encryption Standard (AES)-256-kryptering.
  7. Velg miljøene som skal brukes med tilkoblingen, og klikk på Lagre.
  8. For å teste tilkoblingen kan du opprette og kjøre en kjede med -kontaktens List Reports -kommando, og kontrollere at den returnerer en gyldig utdata.

Konfigurer Salesforce-tilkoblingen for klientlegitimasjon

Autentisering med klientlegitimasjon gir deg tilgang til Salesforce ved hjelp av en klient-ID og -hemmelighet. Denne metoden skiller seg fra OAuth-påloggingsmetoden ved at den ikke krever et scope, og du trenger ikke å autentisere deg i Salesforce via Connect -knappen. 

Advarsel: Denne autentiseringsmetoden inkluderer ikke et oppdateringstoken. På grunn av dette egner den seg ikke for lange kommandoer, og kan føre til tidsavbrudd i visse kjeder.
  1. Fra Chain Builder klikker du på Connectionscompare_arrows, og deretter Create øverst til høyre.
  2. Under Connector Connection velger du Salesforce og standard CloudRunner.
  3. Under Basic Info angir du et unikt navn og en beskrivelse for å identifisere kontakten.
  4. Under Properties angir du Salesforce-forekomsten eller det egendefinerte domenet du vil koble til:
    Egenskap Detaljer
    Forekomst Angi Salesforce-forekomsten du vil koble til. Hvis organisasjonen bruker et egendefinert Salesforce-domene, lar du feltet stå tomt.
    Merk: I Salesforce-URL-en din representerer tegnene før salesforce.com- for eksempel na73-forekomsten.
    Tilpasset domene Angi det egendefinerte Salesforce-domenet du vil koble til, hvis det brukes.
    Merk: Hvis du vil vise det egendefinerte domenet ditt i Salesforce, velger du Company Settings, My Domain. Et egendefinert domene slutter vanligvis med .my.salesforce.com.
  5. For Autentiseringstype velger du Client Credentials.2024-06-10_12-32-47.png
  6. Under Authentication angir du klient-ID og hemmelighet.
    Merk: Alle sensitive opplysninger krypteres automatisk og lagres med AES-256-kryptering.
  7. Velg miljøene som skal brukes med tilkoblingen, og klikk på Lagre.
  8. For å teste tilkoblingen kan du opprette og kjøre en kjede med -kontaktens List Reports -kommando, og kontrollere at den returnerer en gyldig utdata.

Feilsøking

Hvis tilkoblingen til Salesforce mislykkes, kan du sjekke flere konfigurasjonsinnstillinger, avhengig av autentiseringstype.

OAuth2-godkjenning

Hvis tilkoblingen til den Salesforce-tilkoblede appen mislykkes når du først klikker på Connect, klikker du på Stop, og venter på å koble til på nytt. Hvis tilkoblingen fortsetter å mislykkes ved bruk av OAuth2-godkjenning:

  • Kontroller at riktig Salesforce-forekomst eller egendefinert domene er angitt for kontakten.
  • Kontroller klient-ID-en og hemmeligheten til den Salesforce-tilkoblede appen som kontakten bruker.
  • I den tilkoblede Salesforce-appen:
    • Bekreft at tilbakekallingsadressen er:
      • 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
    • Sørg for at de valgte OAuth-scopene inkluderer Utfør forespørsler på dine vegne når som helst (refresh_token, offline_access) og minst ett annet scope.

Hvis kontakten mister forbindelsen til Salesforce-appen:

  1. Fra Chains klikker du på Connectionscompare_arrows, velger koblingen og klikker på Edit.
  2. Under OAuth klikker du på Tilbakestill.
  3. For å aktivere koblingen til Salesforce klikker du på Tillat.

Grunnleggende autentisering

Hvis tilkoblingen mislykkes ved bruk av grunnleggende autentisering:

  • Bekreft integrasjonsbrukerens påloggingsinformasjon og sikkerhetstoken. For å be om et nytt sikkerhetstoken i Salesforce logger du på som integrasjonsbruker og velger Settings, My Personal Information, og klikker på Reset security token.
  • Kontroller at riktig Salesforce-forekomst eller egendefinert domene er angitt for kontakten.
  • Sørg for at integrasjonsbrukeren har API Enabled -tillatelser, i tillegg til tillatelser knyttet til alle oppgaver som koblingen utfører.

Autentisering av klientlegitimasjon

Hvis tilkoblingen mislykkes ved bruk av klientautentisering:

  • Kontroller at riktig Salesforce-forekomst eller egendefinert domene er angitt for kontakten.
  • Kontroller klient-ID-en og hemmeligheten til den Salesforce-tilkoblede appen som kontakten bruker.
Med Salesforce® Connector kan du bruke kommandoer til å samhandle med Salesforce som en del av en kjede. Med denne ko...