Ti trovi qui:
Considerazioni sugli oggetti esterni di Salesforce Maps
Esaminare i limiti e le dipendenze chiave prima di tracciare i record di oggetti esterni in Salesforce Maps. Questo argomento tratta il comportamento delle query, i vincoli di georeferenziazione e crittografia e i compromessi in termini di prestazioni quando l'organizzazione recupera i dati tramite Salesforce Connect.
Come Salesforce Maps recupera i dati degli oggetti esterni
Gli oggetti esterni consentono agli amministratori Salesforce di accedere ai dati esterni a un'organizzazione Salesforce in tempo reale tramite Salesforce Connect. È possibile tracciare oggetti esterni in Salesforce Maps, ma esistono importanti limitazioni quando la fonte di dati esterna utilizza connessioni OData 2.0, OData 4.0 o tra organizzazioni.
Quando si tracciano oggetti esterni, Maps recupera i dati tramite Salesforce Connect, che effettua chiamate ai sistemi esterni. Questa integrazione in tempo reale introduce vincoli specifici che non si applicano agli oggetti Salesforce standard.
Limitazioni di SOQL e query
Gli oggetti esterni hanno diverse restrizioni di query che influiscono sul modo in cui Salesforce Maps può recuperare e visualizzare i dati:
- Query sulle relazioni: Le query che riguardano relazioni tra oggetti esterni e oggetti standard potrebbero non supportare tutte le operazioni SOQL. Verificare che le relazioni tra gli oggetti esterni supportino i campi da tracciare.
- Funzioni di aggregazione: Le funzioni COUNT, SUM, AVG, MIN e MAX non sono supportate nella maggior parte delle fonti di dati esterne. Le funzioni delle mappe basate sull'aggregazione potrebbero non funzionare con gli oggetti esterni.
- Operatori di filtro: Non tutti gli operatori di filtro SOQL sono disponibili per gli oggetti esterni. Gli operatori specifici supportati dipendono dalla versione e dalla configurazione OData della fonte di dati esterna.
- Clausola LIMITE: Le fonti di dati esterne possono imporre i propri limiti record indipendentemente dalle clausole SOQL LIMIT di Salesforce. Controllare la documentazione della fonte di dati esterna per verificare la presenza di restrizioni specifiche.
Requisiti dei campi di georeferenziazione e indirizzo
La georeferenziazione degli oggetti esterni richiede una particolare attenzione:
- Campi indirizzo: Gli oggetti esterni devono avere campi indirizzo esposti tramite la fonte di dati esterna. Se i campi indirizzo non sono disponibili direttamente, è necessario configurare una relazione di ricerca con un oggetto standard o personalizzato che contiene l'indirizzo.
- Limite API di georeferenziazione: Ogni volta che Maps traccia oggetti esterni, può attivare operazioni di georeferenziazione che vengono conteggiate nei limiti di georeferenziazione dell'organizzazione. Monitorare l'utilizzo della georeferenziazione quando si utilizzano serie di dati esterne di grandi dimensioni.
- Ricerche indirette: Se si tracciano record che non hanno indirizzi, assicurarsi che la relazione tra l'oggetto esterno e l'oggetto contenente l'indirizzo sia configurata correttamente come ricerca indiretta.
Limitazioni di Shield Platform Encryption
Se l'organizzazione utilizza Shield Platform Encryption, tenere presenti i seguenti vincoli aggiuntivi quando si tracciano oggetti esterni:
- Campi crittografati: Gli oggetti esterni non supportano Shield Platform Encryption direttamente. Tuttavia, se si utilizzano ricerche indirette per oggetti standard che contengono campi crittografati, alcune operazioni di filtro e ricerca potrebbero non funzionare come previsto.
- Limitazioni di ricerca: I campi crittografati sugli oggetti standard correlati non possono essere utilizzati nelle query di ricerca quando vi si accede tramite relazioni tra oggetti esterni.
- Limitazioni dell'operatore: Gli operatori di confronto (LIKE, CONTAINS, ecc.) potrebbero non funzionare sui campi crittografati a cui si fa riferimento tramite relazioni con oggetti esterni.
Considerazioni sulle prestazioni
Il tracciamento di oggetti esterni può influire sulle prestazioni di Maps a causa del recupero dei dati in tempo reale:
- Limite dei callout esterni: Ogni richiesta di recupero dei dati degli oggetti esterni viene conteggiata nei limiti di callout dell'organizzazione. Serie di dati di grandi dimensioni o aggiornamenti frequenti delle mappe possono consumare rapidamente i callout.
- Tempo di risposta: Le prestazioni delle mappe dipendono dal tempo di risposta della fonte di dati esterna. I sistemi esterni lenti determineranno un caricamento e un tracciamento ritardati della mappa.
- Volume dei dati: Il tracciamento di grandi volumi di record di oggetti esterni può essere più lento rispetto al tracciamento di oggetti standard. Valutare la possibilità di utilizzare i filtri per ridurre il numero di record recuperati e tracciati.
- Limitazioni del caching: A differenza degli oggetti standard, i dati degli oggetti esterni vengono recuperati in tempo reale su ogni richiesta. I meccanismi di caching di Salesforce che migliorano le prestazioni degli oggetti standard non si applicano ai dati esterni.
Comportamento dei livelli con oggetti esterni
Quando si creano livelli di dati o livelli indicatori con oggetti esterni:
- Creazione del livello: È possibile creare livelli di dati basati su oggetti esterni, ma valgono tutte le limitazioni delle query descritte sopra.
- Clic per creare: La funzionalità Clic per creare può avere limitazioni quando si utilizzano oggetti esterni come oggetto di destinazione. Verificare che la fonte di dati esterna supporti le operazioni di inserimento necessarie.
- Aggiornamenti della serie di dati live: Le modifiche apportate ai dati esterni nel sistema di origine potrebbero non essere visualizzate immediatamente nei livelli Maps a causa di intervalli di caching o aggiornamento della fonte di dati.
- Livelli con codice colore: La codifica a colori basata sui valori dei campi degli oggetti esterni funziona come gli oggetti standard, ma le prestazioni possono essere più lente con serie di dati esterne di grandi dimensioni.
Comportamento di ricerca e filtro
La funzionalità di ricerca presenta limitazioni specifiche per gli oggetti esterni:
- Ricerca POI: La ricerca dei punti di interesse (POI) può essere più lenta con gli oggetti esterni a causa del recupero dei dati in tempo reale.
- Ricerca testuale: Le funzionalità di ricerca full-text dipendono dal supporto della fonte di dati esterna per le operazioni di ricerca testuale.
- Persistenza dei filtri: I filtri applicati ai livelli di oggetti esterni potrebbero dover essere rivalutati su ogni caricamento della mappa, potenzialmente influenzando il tempo di caricamento.
Risoluzione dei problemi degli oggetti esterni
In caso di problemi di tracciamento degli oggetti esterni, verificare quanto segue:
| Sintomo | Causa e soluzione possibili |
|---|---|
| Gli oggetti esterni non vengono visualizzati sulla mappa | Verificare che la fonte di dati esterna sia connessa e accessibile. Controllare che i campi indirizzo siano mappati correttamente, direttamente nell'oggetto esterno o tramite una relazione di ricerca indiretta. |
| Errore di query SOQL non supportato | La query utilizza un'operazione SOQL non supportata dalla fonte di dati esterna. Semplificare la query o rimuovere gli operatori non supportati. Testare la query nella Developer Console per identificare l'operazione non supportata specifica. |
| La mappa viene caricata lentamente o scade | La fonte di dati esterna potrebbe rispondere lentamente o restituire troppi record. Aggiungere filtri per ridurre le dimensioni della serie di dati o controllare le prestazioni del sistema esterno. |
| Le opzioni di filtro non funzionano come previsto | Alcuni operatori di filtro potrebbero non essere supportati dalla fonte di dati esterna. Controllare la documentazione dell'adattatore OData per verificare la presenza di operatori supportati o verificare che gli oggetti correlati non contengano campi crittografati che impediscono l'applicazione di filtri. |
| Errori del limite di chiamate | Il tracciamento di oggetti esterni consuma chiamate API. Monitorare i limiti di callout dell'organizzazione e ridurre la frequenza degli aggiornamenti delle mappe o il numero di oggetti esterni tracciati. |
Procedure consigliate per gli oggetti esterni
Seguire queste procedure consigliate quando si utilizzano oggetti esterni in Salesforce Maps:
- Testare prima le query: Utilizzare la Developer Console per testare le query SOQL sugli oggetti esterni prima di configurarle in Maps.
- Utilizzare i filtri in modo strategico: Applicare filtri per limitare il numero di record esterni recuperati e tracciati.
- Limite di monitoraggio: Tenere traccia dei limiti di chiamata e dell'utilizzo dell'API di georeferenziazione quando si utilizzano dati esterni.
- Fonti di dati dei documenti: Gestire la documentazione sulle fonti di dati esterne, incluse le limitazioni, le pianificazioni degli aggiornamenti e le operazioni supportate.
- Piano per latenza: Impostare le aspettative degli utenti in modo che le mappe con oggetti esterni possano caricarsi più lentamente rispetto alle mappe con solo oggetti standard.
- Verificare le relazioni: Assicurarsi che le relazioni di ricerca indiretta siano configurate correttamente prima di tentare di tracciare oggetti esterni privi di indirizzi propri.
