Konfigurere Salesforce i en kopiaktivitet
Denne artikkelen beskriver hvordan du bruker kopieringsaktiviteten i datasamlebåndet til å kopiere data fra og til Salesforce.
Støttet konfigurasjon
Hvis du vil ha konfigurasjonen av hver fane under kopieringsaktivitet, kan du gå til følgende inndelinger.
Generelt
Se veiledningen for generelle innstillinger for å konfigurere fanen Generelle innstillinger.
Kilde
Følgende egenskaper støttes for Salesforce under Kilde-fanen for en kopiaktivitet.
Følgende egenskaper er nødvendige:
- Tilkobling: Velg en Salesforce-tilkobling fra tilkoblingslisten. Hvis det ikke finnes noen tilkobling, oppretter du en ny Salesforce-tilkobling ved å velge Ny.
- Bruk spørring: Velg fra objekt-API-, rapport- eller SOQL-spørring.
Hvis du velger Objekt-API:
- Objekt-API: Angi Salesforce-objektnavnet du vil hente data fra. Velg navnet fra rullegardinlisten.
Hvis du velger Rapport:
Rapport-ID: Angi ID-en for Salesforce-rapporten du vil hente data fra. Det støttes ikke i målet. Det finnes begrensninger når du bruker rapporter.
Hvis du velger SOQL-spørring:
SOQL-spørring: Bruk den egendefinerte spørringen til å lese data. Du kan bare bruke Salesforce Object Query Language (SOQL)-spørring med begrensninger for å forstå masse-API 2.0-spørring. Hvis du ikke angir SOQL-spørring, hentes alle dataene for Salesforce-objektet som er angitt i objekt-API eller rapport-ID .
Under Avansert kan du angi følgende felt:
- Inkluder slettede objekter: Angi om du vil spørre etter eksisterende poster (ikke merket), eller spørre alle poster, inkludert de slettede (valgte).
- Flere kolonner: Legg til flere datakolonner for å lagre kildefilens relative bane eller statiske verdi. Uttrykket støttes for sistnevnte.
Mål
Følgende egenskaper støttes for Salesforce under Mål-fanen for en kopiaktivitet.
Følgende egenskaper er nødvendige:
- Tilkobling: Velg en Salesforce-tilkobling fra tilkoblingslisten. Hvis det ikke finnes noen tilkobling, oppretter du en ny Salesforce-tilkobling ved å velge Ny.
- Objekt-API: Angi Salesforce-objektnavnet du vil skrive data til. Velg navnet fra rullegardinlisten.
Under Avansert kan du angi følgende felt:
Skrivevirkemåte: Angi skrivevirkemåten for operasjonen. Tillatte verdier er Insert og Upsert. Du kan velge en virkemåte fra rullegardinlisten.
Hvis du velger Upsert:
Eksternt ID-felt: Navnet på det eksterne ID-feltet for oppstartsoperasjonen. Det angitte feltet må defineres som eksternt ID-felt i Salesforce-objektet. Den kan ikke ha NULL-verdier i tilsvarende inndata.
Ignorer nullverdier: Angi om nullverdier skal ignoreres fra inndata under en skriveoperasjon.
- Når det er valgt: La dataene i målobjektet være uendret når du utfører en upsert- eller oppdateringsoperasjon. Sett inn en definert standardverdi når du utfører en innsettingsoperasjon.
- Når det ikke er merket av: Oppdater dataene i målobjektet til NULL når du utfører en upsert- eller oppdateringsoperasjon. Sett inn en NULL-verdi når du utfører en innsettingsoperasjon.
Skrive bunkestørrelse: Angi radantallet for data skrevet til Salesforce i hver gruppe. Foreslå å angi denne verdien fra 10 000 til 200 000. For få rader i hver gruppe reduserer kopieringsytelsen. For mange rader i hver gruppe kan føre til tidsavbrudd for API.
Maks samtidige tilkoblinger: Den øvre grensen for samtidige tilkoblinger som ble opprettet i datalageret under aktivitetskjøringen. Angi en verdi bare når du vil begrense samtidige tilkoblinger.
Tilordning
Se Konfigurere tilordninger under tilordningsfanen for fanen Tilordning.
Innstillinger
For konfigurasjon av innstillinger-fanen går du til Konfigurer de andre innstillingene under innstillinger-fanen.
Tabellsammendrag
Tabellene nedenfor inneholder mer informasjon om kopieringsaktiviteten i Salesforce.
Kildeinformasjon
| Name | Beskrivelse | Verdi | Kreves | JSON-skriptegenskap |
|---|---|---|---|---|
| Forbindelse | Tilkoblingen til kildedatalageret. | <Salesforce-tilkoblingen> | Ja | forbindelse |
| Tilkoblingstype | Tilkoblingstypen. Velg Salesforce-objekter. | SalesforceObject | Ja | / |
| Bruk spørring | Måten å lese data fra Salesforce på. | • Objekt-API • Rapport • SOQL-spørring |
Ja | / |
| For objekt-API | ||||
| Objekt-API | Angi Salesforce-objektnavnet du vil hente data fra. | < objektnavnet ditt > | Ja | objectApiName |
| For rapport | ||||
| Rapport-ID | ID-en for Salesforce-rapporten du vil hente data fra. Det støttes ikke i målet. Det finnes begrensninger når du bruker rapporter. | <rapport-ID-en> | Ja | reportId |
| For SOQL-spørring | ||||
| SOQL-spørring | Bruk den egendefinerte spørringen til å lese data. Du kan bare bruke Salesforce Object Query Language (SOQL)-spørring med begrensninger for å forstå masse-API 2.0-spørring. Hvis du ikke angir SOQL-spørring, hentes alle dataene for Salesforce-objektet som er angitt i objekt-API eller rapport-ID . | < SOQL-spørringen > | Ja | spørring |
| Inkluder slettede objekter | Angir om du vil spørre etter eksisterende poster eller spørre etter alle poster, inkludert de slettede. | merket eller umerket (standard) | No | includeDeletedObjects: sann eller usann (standard) |
| Flere kolonner | Legg til flere datakolonner for å lagre kildefilens relative bane eller statiske verdi. Uttrykket støttes for sistnevnte. | • Navn •Verdi |
No | additionalColumns: •navn •verdi |
Målinformasjon
| Name | Beskrivelse | Verdi | Kreves | JSON-skriptegenskap |
|---|---|---|---|---|
| Forbindelse | Tilkoblingen til måldatalageret. | <Salesforce-tilkoblingen> | Ja | forbindelse |
| Objekt-API | Angi Salesforce-objektnavnet du vil skrive data til. | < objektnavnet ditt > | Ja | objectApiName |
| Skrivevirkemåte | Skrivevirkemåten for operasjonen. Tillatte verdier er Insert og Upsert. Du kan velge en virkemåte fra rullegardinlisten. | •Sette inn • Oppsett |
Nei (standard er Sett inn) | writeBehavior: sett inn upsert |
| Eksternt ID-felt | Navnet på det eksterne ID-feltet for oppstartsoperasjonen. Det angitte feltet må defineres som eksternt ID-felt i Salesforce-objektet. Den kan ikke ha NULL-verdier i tilsvarende inndata. | < det eksterne ID-feltet > | Ja for «Upsert» | externalIdFieldName |
| Ignorer nullverdier | Angir om nullverdier skal ignoreres fra inndata under en skriveoperasjon. | merket eller umerket (standard) | No | ignoreNullValues: sann eller usann (standard) |
| Skrive bunkestørrelse | Radantallet med data skrevet til Salesforce i hver gruppe. Foreslå å angi denne verdien fra 10 000 til 200 000. For få rader i hver gruppe reduserer kopieringsytelsen. For mange rader i hver gruppe kan føre til tidsavbrudd for API. | <antall rader> (heltall) |
Nei (standard er 100 000) | writeBatchSize |
| Maksimalt antall samtidige tilkoblinger | Den øvre grensen for samtidige tilkoblinger som ble opprettet i datalageret under aktivitetskjøringen. Angi en verdi bare når du vil begrense samtidige tilkoblinger. | <maks samtidige tilkoblinger> | No | maxConcurrentConnections |
Salesforce Bulk API 2.0-grenser
Vi bruker Salesforce Bulk API 2.0 til å spørre etter og innta data. I masse-API 2.0 opprettes grupper automatisk. Du kan sende inn opptil 15 000 grupper per rullerende 24-timers periode. Hvis grupper overskrider grensen, oppstår det feil.
I bulk-API 2.0 bruker bare inntak av jobber grupper. Spørringsjobber gjør ikke det. Hvis du vil ha mer informasjon, kan du se Hvordan forespørsler behandles i utviklerveiledningen for masse-API 2.0.
Hvis du vil ha mer informasjon, kan du se delen Generelle grenser i Salesforce-utviklergrenser.