Salesforcen määrittäminen kopiointitoiminnossa
Tässä artikkelissa kerrotaan, miten voit kopioida tietoja Salesforcesta ja Salesforceen tietoputken kopiointitoiminnon avulla.
Tuettu määritys
Jos haluat määrittää kunkin välilehden kopiointitoiminnon kohdassa, siirry seuraaviin osioihin.
Yleiset
Yleiset asetukset -välilehden määrittäminen on yleisissä asetuksissa.
Lähde
Seuraavia ominaisuuksia tuetaan Salesforcelle kopiointiaktiviteetin Lähde-välilehdellä .
Seuraavat ominaisuudet vaaditaan:
- Yhteys: Valitse Salesforce-yhteys yhteysluettelosta. Jos yhteyttä ei ole, luo uusi Salesforce-yhteys valitsemalla Uusi.
- Käytä kyselyä: Valitse objektin ohjelmointirajapinnasta, raportista tai SOQL-kyselystä.
Jos valitset Objektin ohjelmointirajapinnan:
- Objektin ohjelmointirajapinta: Määritä Salesforce-objektin nimi, josta tiedot haetaan. Valitse nimi avattavasta luettelosta.
Jos valitset Raportin:
Raporttitunnus: Määritä sen Salesforce-raportin tunnus, josta tiedot haetaan. Sitä ei tueta kohdesijainnissa. Raporttien käyttöön liittyy rajoituksia .
Jos valitset SOQL-kysely:
SOQL-kysely: Käytä mukautettua kyselyä tietojen lukemiseen. Voit käyttää vain Salesforce Object Query Language (SOQL) -kyselyä, jonka rajoituksissa on tietoja joukko-ohjelmointirajapinnan 2.0 kyselystä. Jos et määritä SOQL-kyselyä, noudetaan kaikki objektin ohjelmointirajapinnassa tai raporttitunnuksella määritetyn Salesforce-objektin tiedot.
Lisäasetukset-kohdassa voit määrittää seuraavat kentät:
- Sisällytä poistetut objektit: Määritä, haluatko tehdä kyselyn olemassa oleville tietueille (valitsematon) vai tehdä kyselyn kaikkiin tietueisiin, mukaan lukien poistetut (valittu).
- Lisäsarakkeet: Lisää tietosarakkeita lähdetiedostojen suhteellisen polun tai staattisen arvon tallentamiseksi. Lauseketta tuetaan jälkimmäisessä.
Kohde
Seuraavia ominaisuuksia tuetaan Salesforcelle kopiointiaktiviteetin Kohde-välilehdessä .
Seuraavat ominaisuudet vaaditaan:
- Yhteys: Valitse Salesforce-yhteys yhteysluettelosta. Jos yhteyttä ei ole, luo uusi Salesforce-yhteys valitsemalla Uusi.
- Objektin ohjelmointirajapinta: Määritä Salesforce-objektin nimi, jolla tiedot kirjoitettavat. Valitse nimi avattavasta luettelosta.
Lisäasetukset-kohdassa voit määrittää seuraavat kentät:
Kirjoitustoiminto: Määritä toiminnon kirjoitustoiminto. Sallittuja arvoja ovat Lisää ja Lisää. Voit valita toiminnan avattavasta luettelosta.
Jos valitset Upsert:
Ulkoinen tunnus -kenttä: Tämä on päivityslisäystoiminnon ulkoisen tunnuskentän nimi. Määritetty kenttä on määritettävä Ulkoiseksi tunnuskentäksi Salesforce-objektissa. Sen vastaavissa syötetiedoissa ei voi olla NULL-arvoja.
Ohita tyhjäarvot: Määritä, ohitettavako syötetietojen NULL-arvot kirjoitustoiminnon aikana.
- Kun se on valittuna, jätä kohdeobjektin tiedot muuttumatta, kun teet päivityslisäys- tai päivitystoiminnon. Lisää määritetty oletusarvo, kun teet lisäystoiminnon.
- Kun se ei ole valittuna: Päivitä kohdeobjektin tiedot arvoon NULL, kun teet päivityslisäyksen tai päivitystoiminnon. Lisää NULL-arvo, kun teet lisäystoiminnon.
Eräkoon kirjoittaminen: Määritä Salesforceen kussakin erässä kirjoitetun tiedon rivimäärä. Ehdota, että määrität tämän arvon arvoksi 10 000–200 000. Liian vähän rivejä kussakin erässä vähentää kopioinnin suorituskykyä. Jos kussakin erässä on liikaa rivejä, ohjelmointirajapinta aikakatkaistaan.
Samanaikaisten yhteyksien enimmäismäärä: Tietosäilöön vahvistettujen samanaikaisten yhteyksien yläraja aktiviteetin suorittamisen aikana. Määritä arvo vain, jos haluat rajoittaa samanaikaisia yhteyksiä.
Yhdistämismääritys
Katso Yhdistämismääritykset-välilehden määritys kohdassa Yhdistämismääritysten määrittäminen -välilehti.
Asetukset
Valitse Asetukset-välilehden määritys kohdassa Määritä muut asetuksesi Asetukset-välilehdessä.
Taulukon yhteenveto
Seuraavat taulukot sisältävät lisätietoja Salesforce-kopiointitoiminnosta.
Lähteen tiedot
| Name | Kuvaus | Arvo | Pakollinen | JSON-komentosarjaominaisuus |
|---|---|---|---|---|
| Yhteys | Yhteys lähdetietosäilöön. | <Salesforce-yhteytesi> | Kyllä | yhteys |
| Yhteystyyppi | Yhteystyyppisi. Valitse Salesforce-objektit. | SalesforceObject | Kyllä | / |
| Käytä kyselyä | Näin voit lukea tietoja Salesforcesta. | • Objektin ohjelmointirajapinta • Raportti • SOQL-kysely |
Kyllä | / |
| Objektin ohjelmointirajapinnalle | ||||
| Objektin ohjelmointirajapinta | Määritä Salesforce-objektin nimi, josta tiedot haetaan. | < objektin nimi > | Kyllä | objectApiName |
| Raporttia varten | ||||
| Raporttitunnus | Sen Salesforce-raportin tunnus, josta tiedot noudeaan. Sitä ei tueta kohdesijainnissa. Raporttien käyttöön liittyy rajoituksia . | <raporttitunnuksesi> | Kyllä | reportId |
| SOQL-kysely | ||||
| SOQL-kysely | Käytä mukautettua kyselyä tietojen lukemiseen. Voit käyttää vain Salesforce Object Query Language (SOQL) -kyselyä, jonka rajoituksissa on tietoja joukko-ohjelmointirajapinnan 2.0 kyselystä. Jos et määritä SOQL-kyselyä, noudetaan kaikki objektin ohjelmointirajapinnassa tai raporttitunnuksella määritetyn Salesforce-objektin tiedot. | < SOQL-kyselysi > | Kyllä | kysely |
| Poistaneiden objektien sisällyttäminen | Ilmaisee, haluatko tehdä kyselyn olemassa oleville tietueille vai tehdä kyselyn kaikkiin tietueisiin, myös poistettuihin. | valittuna tai valitsemattomana (oletus) | En | includeDeletedObjects: tosi tai epätosi (oletus) |
| Lisäsarakkeet | Lisää tietosarakkeita lähdetiedostojen suhteellisen polun tai staattisen arvon tallentamiseksi. Lauseketta tuetaan jälkimmäisessä. | • Nimi •Arvo |
En | additionalColumns: •Nimi •arvo |
Kohdetiedot
| Name | Kuvaus | Arvo | Pakollinen | JSON-komentosarjaominaisuus |
|---|---|---|---|---|
| Yhteys | Yhteytesi kohdetietosäilöön. | <Salesforce-yhteytesi> | Kyllä | yhteys |
| Objektin ohjelmointirajapinta | Määritä Salesforce-objektin nimi, jota varten tiedot kirjoitettavat. | < objektin nimi > | Kyllä | objectApiName |
| Kirjoituskäyttäytyminen | Toiminnon kirjoituskäyttäytyminen. Sallittuja arvoja ovat Lisää ja Lisää. Voit valita toiminnan avattavasta luettelosta. | •Insertti • Päivityslisäys |
Ei (oletusarvo on Lisää) | writeBehavior: Lisää päivityslisäys |
| Ulkoinen tunnus -kenttä | Päivityslisäystoiminnon ulkoisen tunnuskentän nimi. Määritetty kenttä on määritettävä Ulkoiseksi tunnuskentäksi Salesforce-objektissa. Sen vastaavissa syötetiedoissa ei voi olla NULL-arvoja. | < ulkoinen TUNNUS-kenttä > | Kyllä ("Upsert") | externalIdFieldName |
| Ohita tyhjäarvot | Ilmaisee, ohitettavako syötetietojen NULL-arvot kirjoitustoiminnon aikana. | valittuna tai valitsemattomana (oletus) | En | ignoreNullValues: tosi tai epätosi (oletus) |
| Erän koon kirjoittaminen | Salesforceen kustakin erästä kirjoitettujen tietojen rivimäärä. Ehdota, että määrität tämän arvon arvoksi 10 000–200 000. Liian vähän rivejä kussakin erässä vähentää kopioinnin suorituskykyä. Jos kussakin erässä on liikaa rivejä, ohjelmointirajapinta aikakatkaistaan. | <rivien määrä> (kokonaisluku) |
Ei (oletusarvo on 100 000) | writeBatchSize |
| Samanaikaisten yhteyksien enimmäismäärä | Tietosäilöön aktiviteetin suorittamisen aikana määritettyjen samanaikaisten yhteyksien yläraja. Määritä arvo vain, jos haluat rajoittaa samanaikaisia yhteyksiä. | <samanaikaisten yhteyksien enimmäismäärä> | En | maxConcurrentConnections |
Salesforce Bulk API 2.0 -rajoitukset
Salesforce Bulk API 2.0:n avulla voidaan tehdä kyselyjä ja käyttää tietoja. Joukko-ohjelmointirajapinnassa 2.0 erät luodaan automaattisesti puolestasi. Voit lähettää enintään 15 000 erää vieritysjaksoa kohden 24 tunnin jaksoa kohden. Jos erät ylittävät rajoituksen, kohtaat virheitä.
Joukko-ohjelmointirajapinnassa 2.0 vain sisäänottotyöt käyttävät eriä. Kyselytyöt eivät. Lisätietoja on kohdassa Miten pyyntöjä käsitellään joukko-ohjelmointirajapinnan 2.0 kehittäjäoppaassa.
Lisätietoja on Salesforce-kehittäjien rajat -osiossa.