Olet tässä:
Ulkoiset Salesforce-yhteydet
Käytä ulkoista Salesforce-liitintä synkronoidaksesi dataa toisesta Salesforce-organisaatiosta CRM Analyticsiin. Ulkoiset liittimet vaativat OAuth 2.0 -todennusta palvelimien ja palvelimien väliseen viestintään.
SOAP API -versioiden 31.0–64.0 SOAP API login()-kutsua ei enää tueta tai käytettävissä Summer '27 -julkaisusta alkaen. Lisätietoja on kohdassa SOAP API login() -kutsu SOAP API -versioissa 31.0–64.0 poistetaan käytöstä.
SOAP-protokollaa ei enää tueta ulkoisissa liittimissä Summer ‘26 -julkaisusta alkaen.
Kaikkien uusien ulkoisten liittimiesi täytyy käyttää todennukseen OAuth-todennusta Client ID- ja Client Secret -asetuksilla. Käyttäjänimi- ja Salasana-asetuksia ei enää käytetä. Nykyisiä liittimiä näillä asetuksilla voidaan käyttää, jos SOAP API login() on käytössä organisaatiosi käyttöoikeuksissa. Olemassa olevia liittimiä ei voi päivittää SOAP:sta OAuth-todennukseen, sinun täytyy luoda uusi yhteys.
Rajoitettua API-käyttöoikeutta ei tueta Salesforcen output- ja ulkoisille liittimille. Ota Käytä mitä tahansa API-asiakasta -käyttöoikeus käyttöön liittimen luovalle käyttäjälle. Lisätietoja on kohdassa API-käyttöoikeuksien hallinta.
Jos haluat siirtää dataa CRM Analyticsista Salesforce-organisaatioon, käytä Salesforce-lähtöyhteyttä.
Ulkoisen asiakassovelluksen määrittäminen OAuthille
Ulkoiset asiakassovellukset (ECA) tarjoavat kertakirjautumisen (SSO) ja käyttävät OAuth-protokollia ulkoisten yhteyksien valtuuttamiseen.
- Jos haluat luoda organisaatiollesi ECA:n, kirjoita Salesforcen Määritykset-valikon Pikahaku-kenttään Ulkoinen ja valitse sitten Ulkoisten asiakassovellusten hallinta.
- Napsauta Uusi ulkoinen asiakassovellus.
- Syötä perustiedot.
- Syötä nimi, jonka ECA näytetään ulkoisten asiakkaiden sovellusten hallinnassa.
- Syötä API-nimi, jota käytetään viitattaessa sovellukseesi ohjelmasta. Tämä kenttä on oletusarvoisesti sovelluksen nimen versio, jossa välilyönnit ovat alaviivoina.
- Syötä sähköpostiosoite, jota Salesforce käyttää, jos meidän täytyy ottaa yhteyttä sinuun tai tukitiimiisi.
- Valitse jakelun osavaltioksi paikallinen.
- Napsauta Ota OAuth käyttöön määrittääksesi OAuth-käytännön.
- Syötä sovelluksen asetukset.
- Syötä callback-URL. callback-URL on sovelluksen URL-osoite, johon olet upottamassa koodia, ja URL-osoite voi hyväksyä Salesforce ECA:lta palautetun todennuksen. Esimerkki callback-URL-osoitteesta on
https://<3p-domain>/callback.html. - Valitse OAUTH-vaikutusalueiksi Hallitse käyttäjätietoja APIS-palvelun kautta (api) ja Käytä Analytics REST API -resursseja (wave_api). Jos sinulla on muita OAuth-tarpeita, valitse muita vaikutusalueita tarvittaessa. Lisätietoja on kohdassa OAuth-valtuudet ja vaikutusalueet
- Syötä callback-URL. callback-URL on sovelluksen URL-osoite, johon olet upottamassa koodia, ja URL-osoite voi hyväksyä Salesforce ECA:lta palautetun todennuksen. Esimerkki callback-URL-osoitteesta on
- Valitse kulun käyttöönotolle Ota asiakastunnusten kulku käyttöön. Tämä kulku sallii palvelimien välisten vuorovaikutusten. Lisätietoja on kohdassa OAuth 2.0 -asiakkaan tunnusten kulku palvelimien integrointiin.
- Poista tietoturvasyistä käytöstä Vaadi todennusavain koodin vaihtoon (PKCE) -laajennus tuetuille valtuutuskuluille.
- Napsauta Luo.
- Napsauta Käytännöt-välilehdestä Muokkaa. Varmista, että OAuth-kulut ja ulkoisten asiakassovellusten parannukset ovat käytössä Ota asiakastunnusten kulku käyttöön. Syötä käyttäjän sähköposti Suorita käyttäjänä. Tämän käyttäjän täytyy olla kelvollinen suorituskäyttäjä.
- Napsauta Asetukset-välilehdestä Kuluttajan avain ja salaisuus kopioidaksesi ja tallentaaksesi arvot. Tarvitset kuluttajan avaimen arvon asiakkaan tunnukselle ja kuluttajan salaisuuden arvon asiakkaan salaisuudelle.
Luo yhteys
- Napsauta Datan hallinta -sivun Yhteydet-välilehdestä Uusi yhteys.
- Valitse Salesforce External Connector ja napsauta Seuraava.
- Syötä liittimen asetukset.
- Vahvista asetuksesi napsauttamalla Tallenna ja testaa. Jos yhteys epäonnistuu, CRM Analytics näyttää mahdolliset syyt.
Jokainen asetus vaatii arvon, ellei toisin osoiteta.
| Yhteysasetus | Kuvaus |
|---|---|
| Yhteyden nimi | Käytä nimeämiskäytäntöä, jonka avulla voit tunnistaa eri yhteydet toisistaan. |
| Kehitysnimi | Yhteyden API-nimi. Tämä nimi ei voi sisältää välilyöntejä. API-nimeä käytetään resepteissäsi viittaamaan tämän yhteyden kautta noudettuun dataan. Et voi muuttaa kehitysnimeä yhteyden luomisen jälkeen. |
| Kuvaus | Liittimen kuvaus. |
| Authentication Type (Todennuksen tyyppi) | Tuettu todennustyyppi. Kelvollinen arvo on OAuth. |
| Käyttäjänimi | Ei enää tueta Summer '26 -julkaisun jälkeen. Käyttäjänimi, jota käytetään yhteyden muodostamiseen ulkoiseen Salesforce-organisaatioon. Pakollinen, jos todennuksen tyyppi on Salasana. |
| Password | Ei enää tueta Summer '26 -julkaisun jälkeen. Username-asetuksessa määritetyn käyttäjän salasana. Turvallisuusasetuksista riippuu, täytyykö käyttäjän suojausvaltuus liittää salasanan loppuun. Lisätietoja suojaustunnuksen hankkimisesta on kohdassa Suojaustunnuksesi palauttaminen. Pakollinen, jos todennuksen tyyppi on Salasana. |
| Asiakastunnus | Vaadittu OAuth-yhteytesi asiakastunnus. Tämä arvo on ulkoisen asiakassovelluksesi kuluttaja-avain. |
| Asiakassalaisuus | Vaadittu asiakassalaisuus OAuth-yhteydellesi. Tämä arvo on ulkoisen asiakassovelluksesi kuluttajasalaisuus. |
| API-tyyppi | Käytettävä API. Vaihtoehdot ovat SOAP API:lle SOAP tai BULKV2 (oletus) Salesforce Bulk API 2.0:lle. Käytä Salesforce Bulk API 2.0 -rajapintaa, jos kohtaat ongelmia, kun suuremmat dataobjektit aikakatkaistaan SOAP API:n avulla. |
| Service URL | Ei enää tueta Summer '26 -julkaisun jälkeen. Ulkoisen organisaation sisäänkirjautumissivun URL-osoite. Oletusarvo käyttää organisaatiosi yleistä Salesforce-sisäänkirjautumissivun URL-osoitetta. Jos haluat parantaa tietoturvaa, päivitä tämä kenttä käyttämään organisaatiosi oman toimialueen kirjautumis-URL-osoitetta. Käytä tuotanto-organisaatiossa formaattia:https://<OmaToimialuenimi.my .salesforce.com/services/Soap/Tunnus/Versionumero.0 Esimerkki: |
| Toimialueen URL | Vaadittu Oman toimialueen URL ulkoiselle Salesforce-organisaatiollesi. Avaa ulkoisessa Salesforce-organisaatiossa Määritykset-valikon Oma toimialue. URL-osoitteen muodon täytyy olla https://*.salesforce.com |
CRM Analyticsiin synkronoidun datan suodattaminen
Käytä suodattimia estääksesi tarpeettoman tai luottamuksellisen datan synkronoinnin CRM Analytics -suodattimiin. Suodattimet nopeuttavat datan synkronointia noutamalla vain tarvitsemasi tiedot CRM Analyticsiin.
- Napsauta Datan hallinta -sivulta Yhteydet-välilehteä.
- Valitse suodatukseen käytettävä objektin yhteys.
- Napsauta suodatettavan objektin nimeä.
- Napsauta Datan synkronoinnin suodatin.
- Syötä suodatin.
- Napsauta Tallenna.
Kun käytät Salesforce External -liitintä, syötä suodatin käyttämällä SOQL WHERE -lauseketta, kuten SOQL and SOSL Reference -oppaassa on kuvattu. Esimerkiksi "(FiscalQuarter = 2 OR
FiscalQuarter = 3) AND Amount > 1000 AND Amount <= 20000".
Salesforce External -liittimessä huomioitavia asioita
Pidä seuraavat toimintatavat mielessäsi, kun käytät Salesforce External -liitintä.
- Yhdistettyjen objektien nimien täytyy alkaa kirjaimella ja sisältää vain kirjaimia, numeroita tai alaviivoja. Nimi ei voi loppua alaviivaan.
- Kentän nimi voi sisältää vain aakkosnumeerisia merkkejä, pisteitä, alaviivoja tai väliviivoja. Jos kentän nimi sisältää muita merkkejä, kuten välilyöntejä tai hakasulkeita, synkronointi epäonnistuu.
- Liitin voi synkronoida oletusarvoisesti enintään 100 miljoonaa riviä tai 50 Gt per objekti, kumpi tahansa raja ylittyy ensin. Rajoituksia voidaan nostaa enintään 2 000 miljoonaan riviin tai 1 000 Gt:hen Salesforce-tukipyynnöstä. Kun käytät liitintä, Salesforce Government Cloud -organisaation data on suojattu siirron aikana edistyneellä salauksella, ja se voi synkronoida enintään 10 miljoonaa riviä tai 5 Gt kuhunkin yhdistettyyn objektiin, kumpi tahansa rajoitus saavutetaan ensin.
- Käytä asteittaista synkronointia (beta) parantaaksesi datan synkronointiaikoja.
- Yhteyden muodostamiseen käyttämäsi käyttäjän suojausasetukset määrittävät ulkoisessa organisaatiossa synkronoitavat objektit ja kentät.
- Voit synkronoida vakio-objekteja, jotka ovat käytettävissä API-versioissa 34.0 ja sitä uudemmissa.
- Voit käyttää API-tyyppiä BULKV2 vain API-versiolla 50.0 ja sitä uudemmissa.
- Jos haluat korjata Salesforce-organisaatioiden välisiä yhteysongelmia, tarkasta organisaatiosi IP-osoiterajoitukset ja harkitse "Lukitse istunnot niiden alkuperäiseen IP-osoitteeseen" -asetuksen poistamista käytöstä molemmissa organisaatioissa. Voit myös hakea Knowledge ja tunnettuja ongelmia saadaksesi lisätietoja.
- Kun tuot kenttiä, jotka sisältävät valuutan, tuotua arvoa ei muunneta. Esimerkki organisaatiosta, joka tallentaa arvot brittiläisillä punta, joita olet tuomassa paikalliseen organisaatioon, joka tallentaa arvot Yhdysvaltain dollareissa. Paikalliseen organisaatioon tuodaan arvo 10 (GBP), kun arvo on 10.
