Recuperare le liste correlate in Zoho CRM ti permette di visualizzare i record collegati — come contatti, trattative o ordini di lavoro — direttamente dalla pagina di dettaglio di un record padre, e anche in modo programmatico tramite l'API REST.
Perché è importante
Quando il tuo team gestisce relazioni complesse tra moduli (ad esempio, Partner → Ordini di Lavoro → Clienti), la possibilità di visualizzare e manipolare le liste correlate è essenziale per evitare silos di dati e doppie registrazioni. [1] Che tu stia costruendo un portale clienti, automatizzando flussi di lavoro o semplicemente navigando tra i record quotidianamente, capire come funzionano le liste correlate in Zoho CRM fa risparmiare molto tempo. La funzionalità Mirror Component e le liste correlate con lookup multi-selezione sono due degli strumenti più potenti — e a volte fraintesi — in questo ambito. [^1,3]
---
Procedura passo dopo passo
Passaggio 1. Comprendi i due approcci principali.
Zoho CRM offre due modi principali per lavorare con le liste correlate: tramite l'interfaccia utente (nella pagina di dettaglio di un record) e tramite l'API REST (in modo programmatico). Il percorso da scegliere dipende dal fatto che tu abbia bisogno di visibilità in tempo reale per gli utenti o di operazioni automatizzate sui dati per le integrazioni. [1]
Passaggio 2. Usa il Mirror Component per i dati correlati in tempo reale nell'interfaccia utente.
Il Mirror Component è una funzionalità della pagina di dettaglio di un record che presenta i dati correlati rilevanti senza richiedere all'utente di navigare altrove. Una volta abilitato, mantiene tutto ciò di cui un utente ha bisogno in un'unica vista. [^1,3] Per abilitarlo:
- Vai al modulo in cui desideri aggiungere il Mirror Component.
- Apri Impostazioni → Personalizzazione → Moduli e Campi, quindi seleziona il modulo pertinente.
- Nell'editor di layout, cerca l'opzione Mirror Component e aggiungila al layout della pagina di dettaglio.
- Configura i dati del modulo correlato da rispecchiare — ad esempio, visualizzare i dettagli degli Ordini di Lavoro su un record Partner. [1]
> Nota (al momento della stesura): Il Mirror Component è disponibile in più data center, tra cui JP, CA, SA, UAE e AU DC. [^1,3]
Passaggio 3. Configura i campi di lookup per definire la relazione.
Prima che una lista correlata venga visualizzata, i moduli devono essere collegati tramite un campo Lookup o un campo Lookup multi-selezione. Ad esempio, per collegare Partner → Ordini di Lavoro → Clienti, occorre creare campi lookup nel modulo Ordini di Lavoro che puntino sia al modulo Partner che al modulo Clienti. [1] Per farlo:
- Vai a Impostazioni → Personalizzazione → Moduli e Campi.
- Seleziona il modulo figlio (ad es., Ordini di Lavoro).
- Aggiungi un campo Lookup e puntalo al modulo padre (ad es., Partner).
- Salva e distribuisci il layout. La lista correlata apparirà ora automaticamente nella pagina di dettaglio del record padre. [1]
Passaggio 4. Recupera i record delle liste correlate tramite l'API REST.
Se hai bisogno di estrarre i dati delle liste correlate in modo programmatico, l'API REST di Zoho CRM lo supporta. Per una relazione di lookup standard, puoi utilizzare l'endpoint Get Related Records, strutturato attorno al modulo e all'ID del record padre. Il pattern URL del CRM per un record segue il formato https://crm.zoho.{dc}/crm/tab/{Module}/{RecordId}, che rispecchia il modo in cui l'API organizza i riferimenti a moduli e record. [2]
Per le liste correlate con Lookup multi-selezione in particolare, esistono due metodi supportati tramite API: [^1,3]
- Insert Records API — crea e associa record in un'unica chiamata.
- Modulo di collegamento — utilizza il modulo di collegamento intermediario che Zoho CRM genera automaticamente per i lookup multi-selezione per associare record esistenti.
Scegli l'approccio con il modulo di collegamento quando hai bisogno di associare record già esistenti in entrambi i moduli senza ricrearli. [^1,3]
Passaggio 5. Verifica la configurazione del data center per le chiamate API.
Quando costruisci richieste API o link diretti ai record del CRM, assicurati che l'URL base rifletta il data center corretto. Per il DC .com, la base è https://crm.zoho.com; per gli altri, segue il pattern https://crm.zoho.{dc}. [2] I data center non corrispondenti sono una causa comune di chiamate API fallite.
---
Errori comuni
- Campo lookup mancante: Una lista correlata non apparirà nella pagina di dettaglio di un record a meno che non sia stato configurato correttamente un campo lookup tra i due moduli. Verifica che il campo sia aggiunto al layout attivo. [1]
- Confusione con il lookup multi-selezione: Molti utenti tentano di associare record con lookup multi-selezione utilizzando solo l'Insert Records API, ma il metodo con il modulo di collegamento è spesso necessario per associare record preesistenti. Entrambi i metodi sono validi ma servono casi d'uso diversi. [^1,3]
- Data center errato negli URL API: Se la tua organizzazione si trova su un data center non
.com(ad es., AU, EU, IN), inserirecrm.zoho.comin modo fisso nelle chiamate API o nei link del portale causerà errori. Parametrizza sempre il DC. [2] - Disponibilità del Mirror Component: Se non riesci a trovare il Mirror Component nell'editor di layout, verifica che il data center della tua organizzazione sia tra quelli supportati prima di aprire un ticket di assistenza. [^1,3]
---
Cosa verificare
- Il campo lookup è presente e distribuito nel layout del modulo figlio, e la lista correlata risultante è visibile nella pagina di dettaglio del record padre.
- L'endpoint API e il data center corrispondono alla regione CRM della tua organizzazione (controlla in Impostazioni → Dettagli Azienda in caso di dubbi). [2]
- Il modulo di collegamento del lookup multi-selezione esiste nel tuo elenco di moduli se stai utilizzando l'API per associare record in una relazione MxN. [^1,3]
---
*Beam Help è una risorsa di supporto esperto indipendente per i prodotti Zoho — non siamo il supporto ufficiale Zoho. Per problemi di fatturazione o a livello di account, contatta direttamente Zoho.*