Il recupero delle sezioni di un record in Zoho CRM può essere effettuato tramite l'interfaccia utente utilizzando il Mirror Component per dati in tempo reale sui record correlati, oppure in modo programmatico tramite l'API GraphQL per interrogare campi specifici tra i moduli. Questa guida illustra entrambi gli approcci, così puoi scegliere il metodo più adatto al tuo caso d'uso.
---
*Beam Help è un servizio di supporto esperto indipendente per Zoho — non è il supporto ufficiale Zoho.*
---
Perché è importante
Lavorando in Zoho CRM, i record raramente esistono in isolamento — un'opportunità è collegata a un contatto, un caso è legato a un cliente e ogni record correlato contiene informazioni critiche. [1] Senza un metodo strutturato per accedere a questi dati, i team perdono tempo navigando tra i moduli per trovare l'ultimo numero di telefono, l'indirizzo email o lo stato dell'account. [1] Che tu abbia bisogno di una soluzione visiva senza codice o di una query API di livello sviluppatore, sapere come recuperare le sezioni di un record in modo efficiente mantiene il tuo team concentrato e i tuoi dati accurati.
---
Procedura passo dopo passo
Opzione A — Utilizzo del Mirror Component (interfaccia utente, senza codice)
Passaggio 1. Comprendi cosa fa il Mirror Component. Funziona come una finestra in tempo reale su un record correlato, visualizzando i campi di quel record collegato direttamente nella pagina dei dettagli del record che stai visualizzando — senza dover cambiare modulo. [1]
Passaggio 2. Verifica l'idoneità del tuo Data Centre. In base all'ultimo annuncio, il Mirror Component è disponibile per i data centre JP, CA, SA, UAE e AU. [1] Se la tua organizzazione si trova su un DC diverso, consulta le note di rilascio di Zoho CRM per aggiornamenti sulla disponibilità. [7]
Passaggio 3. Naviga alla pagina dei dettagli del record in cui desideri visualizzare i dati correlati — ad esempio, un record Deals collegato a un Contatto. [1]
Passaggio 4. Apri l'editor del layout di pagina per quel modulo (tramite Impostazioni → Moduli e Campi → [Modulo] → Layout) e aggiungi il Mirror Component al layout. Configuralo in modo che punti al modulo correlato (ad es., Contatti) e seleziona i campi specifici che desideri rispecchiare, come il numero di telefono o l'indirizzo email. [1]
Passaggio 5. Salva il layout e torna a un record attivo. I campi rispecchiati visualizzeranno ora i valori in tempo reale estratti direttamente dal record collegato, così il tuo team vedrà sempre i dati più aggiornati senza lasciare la pagina. [1]
---
Opzione B — Utilizzo dell'API GraphQL (recupero programmatico/per sviluppatori)
Passaggio 1. Verifica l'accesso all'API. Le API GraphQL di Zoho CRM non sono disponibili nelle edizioni di prova di nessun piano CRM, quindi assicurati che la tua organizzazione utilizzi un'edizione a pagamento prima di procedere. [2]
Passaggio 2. Comprendi i due tipi di query root disponibili. Il tipo Meta consente di recuperare metadati da fonti come Moduli, Utenti, Ruoli, Profili e Widget. Il tipo Records consente di recuperare i dati effettivi dei campi da qualsiasi modulo accessibile al tuo profilo, con filtri e paginazione supportati in tutti i moduli. [2]
Passaggio 3. Costruisci la tua query GraphQL. Per recuperare le sezioni di un record (campi) da più moduli in una singola richiesta, annida i moduli desiderati sotto Records e specifica i nomi dei campi all'interno di data. Ad esempio, per estrarre AccountName da Accounts e Last_Name da Leads contemporaneamente, la query sarà simile a questa: [2]
query {
Records {
Accounts {
_data {
Account_Name {
value
}
}
}
Leads {
_data {
Last_Name {
value
}
}
}
}
}Passaggio 4. Invia la query all'endpoint GraphQL di Zoho CRM utilizzando il client HTTP che preferisci o l'SDK JavaScript. L'SDK fornisce codice di esempio per il recupero di record da moduli come Leads e supporta più versioni API (V6, V7, V8). [3]
Passaggio 5. Analizza la risposta. I record di ciascun modulo vengono restituiti nei rispettivi array _data, con ogni campo che espone una proprietà value. [2] Mappa questi valori nel modello dati della tua applicazione secondo le necessità.
---
Errori comuni
- Blocco edizione di prova: Il tentativo di utilizzare l'API GraphQL su un account di prova fallirà completamente — l'API è esplicitamente non disponibile nelle versioni di prova. [2] Aggiorna prima a un'edizione a pagamento.
- Restrizione DC del Mirror Component: Se il data centre della tua organizzazione non è tra JP, CA, SA, UAE o AU, il Mirror Component potrebbe non essere ancora disponibile. [1] Consulta la pagina delle note di rilascio per lo stato di distribuzione del tuo DC. [7]
- Campi di lookup vs. Mirror Component: I campi di lookup standard stabiliscono relazioni tra moduli ma non possono visualizzare tutti i dati contestuali dei campi all'interno del record padre. [1] Non confondere un campo di lookup con il Mirror Component — hanno scopi diversi.
- Lacune di visibilità su mobile: I campi e i componenti dell'elenco correlato configurati nel layout web potrebbero non apparire automaticamente nell'app mobile CRM. [4] Testa il tuo layout su mobile dopo aver apportato modifiche.
---
Cosa verificare
- Mirror Component: Dopo aver salvato il layout, apri un record attivo e verifica che i campi rispecchiati mostrino i valori correnti del record collegato — non dati obsoleti o vuoti. [1]
- Query GraphQL: Verifica che i nomi API dei campi utilizzati nella query (ad es.,
AccountName,LastName) corrispondano esattamente ai nomi API definiti nella configurazione del modulo CRM, poiché le discrepanze restituiranno valori null. [2] - Edizione e DC: Conferma che sia la tua edizione CRM (a pagamento, non di prova) sia il tuo data centre siano supportati per il metodo di recupero scelto. [1][2]