Connessioni esterne Salesforce

Nota

A partire dal rilascio Summer '27, la chiamata login() API SOAP nelle versioni API SOAP da 31.0 a 64.0 non sarà più supportata e non sarà più disponibile. Per ulteriori informazioni, vedere Chiamata SOAP API login() nell'API SOAP Versioni da 31.0 a 64.0 ritirata.

SOAP non sarà più supportato nei connettori esterni a partire dal rilascio Summer '26.

Tutti i nuovi connettori esterni devono utilizzare OAuth con ID client e impostazioni Segreto client per l'autenticazione. Le impostazioni Nome utente e Password non vengono più utilizzate. I connettori esistenti con queste impostazioni possono essere utilizzati se l'API SOAP login() è abilitata nelle autorizzazioni dell'organizzazione. I connettori esistenti non possono essere aggiornati da SOAP a OAuth, è necessario creare una nuova connessione.

L'accesso API limitato non è supportato per l'output Salesforce e i connettori esterni. Abilitare l'autorizzazione Utilizza qualsiasi client API per l'utente che crea il connettore. Per ulteriori informazioni, vedere Gestione dell'accesso API.

Per inviare tramite push i dati da CRM Analytics a un'organizzazione Salesforce, utilizzare una connessione Salesforce Output.

Impostazione di un'app client esterna per OAuth

Le app client esterne (ECA) forniscono Single Sign-On (SSO) e utilizzano protocolli OAuth per autorizzare le connessioni esterne.

Nota

Si consiglia di creare un account utente Salesforce separato che non sia assegnato a una persona per impostare una connessione. L'account di una persona può essere disattivato quando l'utente lascia l'organizzazione, il che interrompe il funzionamento di tutte le connessioni create con l'account.

1. Per creare un'ECA per la propria organizzazione, dalla pagina di impostazione di Salesforce, immettere Esterno nella casella Ricerca veloce e quindi selezionare Gestione app client esterne.
2. Fare clic su Nuova app client esterna.
3. Immettere le informazioni di base.
   1. Immettere il nome dell'ECA da visualizzare nel Gestore app client esterno.
   2. Immettere il nome API da utilizzare quando si fa riferimento all'applicazione da un programma. Per impostazione predefinita, questo campo utilizza una versione del nome dell'app con caratteri di sottolineatura al posto degli spazi.
   3. Immettere l'indirizzo email del referente che Salesforce dovrà utilizzare per contattare l'utente o il suo team di assistenza.
   4. Selezionare Locale come Stato distribuzione.
4. Fare clic su Abilita OAuth per configurare la policy OAuth.
5. Specificare le impostazioni dell'applicazione.
   1. Immettere l'URL di richiamata. L'URL di richiamata è l'URL dell'app in cui si incorpora il codice e l'URL può accettare l'autenticazione restituita da Salesforce ECA. Un esempio di URL di richiamata è https://<3p-domain>/callback.html.
   2. Per gli ambiti OAUTH, selezionare Gestisci dati utente tramite API (api) e Accedi alle risorse API REST Analytics (wave_api). Se sono presenti altre esigenze OAuth, selezionare altri ambiti in base alle esigenze. Per ulteriori informazioni, vedere Token e ambiti OAuth
6. Per Abilitazione flusso, selezionare Abilita flusso credenziali client. Questo flusso consente interazioni da server a server. Per ulteriori informazioni, vedere Flusso credenziali client OAuth 2.0 per l'integrazione da server a server
7. Per sicurezza, disabilitare l'estensione Richiedi chiave dimostrativa per Code Exchange (PKCE) per i flussi di autorizzazione supportati.
8. Fai clic su Crea.
9. Nella scheda Policy, fare clic su Modifica. Per i flussi OAuth e le ottimizzazioni dell'app client esterna, assicurarsi che Abilita flusso credenziali client sia abilitato. Immettere un'email utente per Esegui come. Questo utente deve essere un utente esecuzione valido.
10. Nella scheda Impostazioni, fare clic su Chiave e segreto per copiare e salvare i valori. Sono necessari il valore della chiave consumatore per l'ID client e il valore del segreto consumatore per il segreto client.

Creazione della connessione

1. Nella scheda Connessioni del Gestore dati, fare clic su Nuova connessione.
2. Selezionare Salesforce External Connector (Connettore Salesforce esterno) e fare clic su Avanti.
3. Specificare le impostazioni del connettore.
4. Per verificare le impostazioni, fare clic su Salva e testa. Se la connessione non riesce, CRM Analytics mostra i possibili motivi.

È necessario specificare un valore per tutte le impostazioni, se non diversamente indicato.

https://mycompany.my.salesforce.com/services/Soap/u/54.0

Filtraggio dei dati sincronizzati in CRM Analytics

Utilizzare i filtri per escludere i dati non necessari o sensibili dalla sincronizzazione con i filtri di CRM Analytics. I filtri velocizzano la sincronizzazione dei dati inserendo in CRM Analytics solo i dati necessari.

Nota Se si prevede di escludere i dati in futuro, utilizzare un filtro del procedimento anziché un filtro di sincronizzazione dei dati.

1. Nel Gestore dati, fare clic sulla scheda Connessioni.
2. Selezionare la connessione associata all'oggetto da filtrare.
3. Fare clic sul nome dell'oggetto da filtrare.
4. Fare clic su Filtro sincronizzazione dei dati.
5. Immettere il filtro.
6. Fare clic su Salva.

Per il connettore Salesforce External, immettere un filtro utilizzando un'espressione con clausola SOQL WHERE come descritto in SOQL and SOSL Reference. Ad esempio, "(FiscalQuarter = 2 OR FiscalQuarter = 3) AND Amount > 1000 AND Amount <= 20000".

Considerazioni sul connettore Salesforce External

Quando si utilizza il connettore Salesforce External, tenere presenti le considerazioni che seguono.

• I nomi degli oggetti connessi devono iniziare con una lettera e contenere solo lettere, numeri e caratteri di sottolineatura. I nomi non possono terminare con un carattere di sottolineatura.
• Un nome di campo può contenere solo caratteri alfanumerici, punti, sottolineature o trattini. Se il nome di un campo contiene altri caratteri, ad esempio spazi o parentesi, la sincronizzazione non riesce.
• Il connettore può sincronizzare fino a 100 milioni di righe o fino a 50 GB per oggetto per impostazione predefinita, a seconda del limite che viene raggiunto per primo. I limiti possono essere aumentati fino a un massimo di 2000 milioni di righe o 1000 GB con una richiesta all'assistenza Salesforce. Quando si utilizza il connettore, i dati dell'organizzazione Salesforce Government Cloud sono protetti in transito con crittografia avanzata e possono sincronizzare fino a 10 milioni di righe o 5 GB per ogni oggetto connesso, a seconda del limite che viene raggiunto per primo.
• Per migliorare il tempo di sincronizzazione dei dati, utilizzare la sincronizzazione incrementale (beta).
• Le impostazioni di protezione dell'utente con cui ci si connette determinano gli oggetti e i campi disponibili per la sincronizzazione nell'organizzazione esterna.
• È possibile sincronizzare gli oggetti standard disponibili nelle versioni API 34.0 e successive.
• È possibile utilizzare il tipo di API BULKV2 solo con l'API versione 50.0 e successive.
• Per risolvere i problemi di connettività tra le organizzazioni Salesforce, rivedere le restrizioni degli indirizzi IP dell'organizzazione e valutare la possibilità di disabilitare l'impostazione "Blocca le sessioni all'indirizzo IP da cui hanno avuto origine" in entrambe le organizzazioni. È anche possibile cercare articoli Knowledge e problemi noti per ulteriori informazioni.
• Quando si importano campi che contengono una valuta, il valore importato non viene convertito. Prendiamo l'esempio di un'organizzazione che registra i valori in sterline britanniche che si importano in un'organizzazione locale che registra i valori in dollari USA. Il valore 10 (GBP) viene importato nell'organizzazione locale come valore 10.