Il Mirror Component di Zoho CRM ti permette di visualizzare i campi di un record correlato direttamente nella pagina che stai già consultando — senza dover cambiare scheda. Combinato con l'API GraphQL, hai a disposizione sia un percorso basato sull'interfaccia utente sia uno orientato agli sviluppatori per recuperare i dati di un singolo record correlato.
Perché è importante
In Zoho CRM, i record raramente esistono in modo isolato. Un'opportunità è collegata a un contatto; un caso è associato a un account. In passato, visualizzare il numero di telefono o l'email di un contatto collegato mentre si lavora all'interno di un'opportunità significava navigare altrove, trovare il contatto e poi tornare — interrompendo il flusso di lavoro. [1] Che tu sia un rappresentante commerciale che ha bisogno di contesto immediato o uno sviluppatore che interroga dati correlati in modo programmatico, conoscere il metodo di recupero corretto fa risparmiare tempo reale.
---
Procedura passo dopo passo
Opzione A — Mirror Component (interfaccia utente, senza codice)
Passaggio 1. Comprendi cosa fa il Mirror Component. Funziona come una finestra live incorporata nella pagina di dettaglio di un record, che riflette in tempo reale i campi di un record correlato. Ad esempio, un rappresentante commerciale che lavora all'interno di un'opportunità può vedere il numero di telefono o l'indirizzo email attuale del contatto collegato senza mai lasciare quel record. [1]
Passaggio 2. Verifica che il tuo data centre sia supportato. Al momento della stesura, il Mirror Component è disponibile per i data centre JP, CA, SA, UAE e AU. Se la tua organizzazione si trova su un DC diverso, consulta la pagina delle note di rilascio di Zoho CRM per lo stato di distribuzione più recente prima di procedere. [1]
Passaggio 3. Naviga al record in cui desideri che appaiano i dati correlati — ad esempio, apri un record Opportunità. Il Mirror Component viene aggiunto a livello di pagina di dettaglio del record, quindi devi trovarti nella vista record del modulo corretto. [1]
Passaggio 4. Accedi alle impostazioni di layout della pagina o di personalizzazione dei componenti per quel modulo. Aggiungi il Mirror Component al layout, quindi configura quale modulo correlato (ad es. Contatti) e quali campi specifici (ad es. telefono, email) desideri riflettere. Una volta salvato, quei campi visualizzeranno dati live estratti dal record collegato ogni volta che la pagina viene caricata. [1]
Passaggio 5. Verifica che il componente funzioni aprendo un record che ha una relazione di lookup popolata. I campi rispecchiati dovrebbero mostrare i valori attuali del record correlato senza alcun aggiornamento manuale. [1]
---
Opzione B — API GraphQL (percorso per sviluppatori)
Passaggio 1. Verifica l'idoneità. L'API GraphQL di Zoho CRM non è disponibile nelle edizioni di prova di nessun piano CRM, quindi assicurati che la tua organizzazione sia su un livello a pagamento prima di sviluppare su di essa. [7]
Passaggio 2. Comprendi la struttura della query. L'API GraphQL espone due tipi radice: Meta (per i metadati di moduli/utenti/ruoli) e Records (per i dati effettivi dei moduli). Utilizzerai il tipo Records per recuperare i campi da un modulo correlato. [7]
Passaggio 3. Scrivi una query che punti al modulo specifico contenente il tuo record correlato. Ad esempio, per recuperare AccountName dal modulo Accounts insieme a LastName da Leads in un unico round-trip, struttura la tua query sotto la radice Records e specifica solo i campi necessari all'interno di _data. [7]
query {
Records {
Accounts {
_data {
Account_Name {
value
}
}
}
}
}Passaggio 4. Filtra la query su un singolo record passando l'ID del record pertinente come parametro di filtro all'interno della query. L'API GraphQL supporta il filtraggio e la paginazione su tutti i moduli accessibili, quindi puoi limitare la risposta a esattamente un record correlato anziché recuperare un intero elenco. [7]
Passaggio 5. Analizza il campo value dall'oggetto di risposta. Ogni campo nell'array _data restituisce una chiave value contenente i dati effettivi, rendendo semplice estrarli e visualizzarli nella tua applicazione o nella funzione Zoho. [7]
---
Errori comuni
- Disponibilità DC del Mirror Component. Se il tuo data centre non è ancora nell'elenco supportato (JP, CA, SA, UAE, AU), l'opzione del componente non apparirà nell'editor di layout. Controlla il thread di rilascio della community per gli annunci di espansione anziché presumere che si tratti di un errore di configurazione. [1]
- GraphQL sugli account di prova. Il tentativo di chiamare l'endpoint GraphQL su un'organizzazione di prova fallirà. Utilizza l'API REST come alternativa oppure aggiorna prima l'account. [7]
- Campo lookup necessario per il Mirror Component. Il Mirror Component si basa su una relazione di lookup esistente tra i moduli. Se nessun campo lookup collega i due moduli, non c'è nulla da rispecchiare per il componente — devi prima stabilire la relazione. [1]
- Dati in tempo reale vs. dati in cache. Il Mirror Component riflette i dati in tempo reale, il che significa che eventuali valori obsoleti che vedi sono probabilmente un problema di cache del browser piuttosto che un problema di sincronizzazione CRM. Un aggiornamento forzato di solito risolve il problema. [1]
---
Cosa verificare
- Idoneità DC confermata — verifica che il data centre CRM sia nell'elenco supportato prima di dedicare tempo alla configurazione del layout del Mirror Component. [1]
- Relazione di lookup esistente — assicurati che un campo lookup colleghi già i due moduli coinvolti; senza di esso, né il Mirror Component né una query GraphQL filtrata restituiranno il record correlato. [1]
- Verifica dell'edizione GraphQL — se utilizzi il percorso API, conferma che l'organizzazione sia su un'edizione CRM a pagamento affinché l'endpoint GraphQL sia accessibile. [7]
---
*Beam Help è una risorsa di supporto esperto indipendente per i prodotti Zoho e non è il supporto ufficiale Zoho. Fai sempre riferimento alla documentazione più recente di Zoho CRM per la tua edizione e il tuo data centre specifici.*