Risoluzione dei problemi con la funzione di assegnazione automatica in Maps

Prerequisiti:

• Assegnazione automatica

Georeferenziazione dei record

Per iniziare, esaminare i record per verificare se sono stati georeferenziati. In particolare, i record devono avere un valore valido di latitudine e longitudine. Ad esempio, eseguire una verifica su uno dei record Account esistenti:

1. Aprire uno dei record Salesforce Account.

2. Verificare che sia presente un valore nei campi Latitudine e Longitudine.

Nota: è possibile che i campi Latitudine e Longitudine siano nascosti nel layout di pagina corrente

Se i valori dei campi Latitudine e Longitudine di un record sono disponibili e validi, la funzione di assegnazione automatica dovrebbe funzionare correttamente.

Se i valori dei campi Latitudine e Longitudine dei record non sono disponibili, assicurarsi che siano georeferenziati. Si tratta semplicemente di tracciare il record in Salesforce Maps (vedere Tracciamento di un livello indicatore). Se si individua un record privo di georeferenziazione, vedere Creating a Base Object (Creazione di un oggetto base).

Configurazione dei campi Latitudine e Longitudine

È anche necessario verificare che i campi Latitudine e Longitudine dei record siano stati configurati correttamente. Ad esempio, nei record Account sono disponibili i campi Latitudine/Longitudine fatturazione e Latitudine/Longitudine spedizioni. A seconda del modo in cui si impostano gli Oggetti base in Salesforce Maps, è necessario verificare che la configurazione della funzione Assegnazione automatica punti ai campi corretti.

Ad esempio, poniamo che i record Account abbiano i valori di latitudine e longitudine memorizzati nei campi Latitudine/Longitudine spedizioni. Se l’assegnazione automatica punta ai campi Latitudine/Longitudine fatturazione, è possibile che il record non venga assegnato correttamente. Per risolvere questo problema, accedere al proprio piano di assegnazione.

1. Aprire Salesforce, Imposta.

2. Accedere a Pacchetti installati.

3. Fare clic su Configura accanto al pacchetto Salesforce Maps.

4. Selezionare Assegnazione automatica dalla barra laterale sinistra.

5. Creare o modificare il Piano di assegnazione.

6. Assicurarsi che i valori del campo Latitudine e del campo Longitudine siano validi e mappati nel modo corretto.

I campi Latitudine e Longitudine visualizzano un elenco di campi numerici disponibili sul record. È necessario che questi valori puntino ai campi corretti (sarebbe facile invertirli accidentalmente oppure puntarli ai campi errati).

Riassegnazione dei record

Supponiamo che sia stato assegnato un insieme di record. Potrebbe essere necessario riassegnarli a un altro utente. Nota: se è stata appena creata una nuova regola di assegnazione e si esegue il piano di assegnazione, è possibile che i titolari dei record rimangano invariati. Perché?

Il batch di assegnazione automatica ignora i record che sono già stati assegnati una volta. Questo comportamento mantiene efficiente l’organizzazione Salesforce, evitando che vengano eseguiti dei processi non necessari. Per far sì che i record vengano nuovamente assegnati, vedere Updating the Auto Assignment Fields(Aggiornamento dei campi di assegnazione automatica).

Acquisizione dei messaggi di errore correlati al piano di assegnazione automatica

Una volta avviata l’esecuzione del piano di assegnazione automatica, è possibile che si verifichino degli errori, per svariati motivi. Accedere al record di esecuzione del piano da Pacchetti installati -> Salesforce Maps-> Configura-> Assegnazione automatica, quindi fare clic sulla scheda Piani programmati. Da qui, individuare il piano di assegnazione automatica non riuscito e fare clic sul nome del piano per ottenere i messaggi di errore dettagliati. Seguono alcuni esempi di messaggi di errore che potrebbero essere visualizzati:

• No territory Intersects with the point (x, y) (Nessun territorio interseca il punto (x, y)): è un comportamento normale. Non è stato possibile trovare il record nel territorio indicato.
• Successfully Found an intersecting territory for the record, but an error occurred during the DML update (È stato trovato un territorio di intersezione per il record, ma si è verificato un errore durante l'aggiornamento DML): Potrebbe essere applicata una regola di convalida attiva al record che si sta cercando di assegnare. (Spesso gli amministratori Salesforce devono impedire a certi utenti di modificare la proprietà di alcuni record).
• Callout Error (Errore di chiamata): potrebbe esserci qualche problema di connettività con Salesforce Maps o con i nostri server.
• Invalid Latitude or Longitude (Latitudine o longitudine non valide): questo errore viene attivato quando nel piano di assegnazione si utilizzano i campi numerici personalizzati come latitudine e longitudine e se le coordinate di latitudine non rientrano nell’intervallo compreso tra -90 e +90, oppure se le coordinate di longitudine non rientrano nell’intervallo compreso tra -180 e +180.
• Codice di stato Bad Request (Richiesta errata) e messaggio di errore "Missing required property from request body","data":{"property":"/rules/1/shape/id"}: questo errore viene attivato quando non esistono geometrie (confini) nel livello forma mappato nella regola di assegnazione. Riesaminare i livelli forma utilizzati per le regole di assegnazione automatica in Maps.
• Nota: se l’utente assegnato nella regola viene disattivato, l’amministratore dovrà esaminare i piani di assegnazioni e disattivare le regole di assegnazione, oppure modificare l’utente.

Generatore livello forma

Per iniziare a lavorare con la funzione di assegnazione automatica, è necessario creare un livello forma. Si potrebbe trattare di un territorio in cui operano gli utenti, ad esempio. Assegnare al livello forma un nome descrittivo.

L’assegnazione automatica funziona anche con le forme disegnate, come quelle create con gli strumenti Quadrato, Cerchio e Poligono, oltre alle forme create con il Generatore livello forma.
 

Errori comuni

L’errore “Superamento del limite di tempo CPU Apex” di norma è causato dall’esecuzione di un piano di assegnazione che contiene un numero elevato di codici postali mentre si verifica il timeout, durante l’elaborazione delle geometrie della forma in base a tutte le regole incluse nel piano. Come procedura ottimale, un piano di assegnazione non dovrebbe contenere più di 10.000 codici postali. Se si verifica questo errore, provare innanzitutto a ridurre la dimensione del batch di assegnazione automatica. Per accedere a questa impostazione, andare a Imposta => Pacchetti installati => Configura accanto a Salesforce Maps => scheda Avanzate a sinistra => scheda Processo batch. Se questa procedura non risolve il problema, si consiglia di suddividere il piano di assegnazione in più piani di dimensione inferiore, oppure di utilizzare i codici postali al posto degli stati, ove applicabile.
 

Viene visualizzato il messaggio di errore “Numero eccessivo di righe di query: 50001” quando si raggiungono i governor e i limiti di esecuzione di 50.000 record acquisiti dalle query SOQL. Se si verifica questo errore, cercare di ridurre la dimensione del batch di assegnazione automatica. Se si verifica questo errore Imposta => Pacchetti installati => Configura accanto a Salesforce Maps => scheda Avanzate a sinistra => scheda Processo batch.