Le Mirror Component de Zoho CRM vous permet d'afficher les champs d'un enregistrement lié directement sur la page que vous consultez — sans changer d'onglet. Combiné à l'API GraphQL, vous disposez à la fois d'un chemin basé sur l'interface utilisateur et d'un chemin orienté développeur pour récupérer les données d'un seul enregistrement lié.
Pourquoi c'est important
Dans Zoho CRM, les enregistrements sont rarement isolés. Une affaire est liée à un contact ; un dossier est rattaché à un compte. Historiquement, consulter le numéro de téléphone ou l'adresse e-mail d'un contact lié tout en travaillant dans une affaire impliquait de quitter la page, de retrouver le contact, puis de revenir — interrompant ainsi votre flux de travail. [1] Que vous soyez un commercial ayant besoin d'un contexte immédiat ou un développeur interrogeant des données liées par programmation, connaître la bonne méthode de récupération vous fait gagner un temps précieux.
---
Étape par étape
Option A — Mirror Component (interface utilisateur, sans code)
Étape 1. Comprenez ce que fait le Mirror Component. Il agit comme une fenêtre en direct intégrée dans la page de détail d'un enregistrement, reflétant en temps réel les champs d'un enregistrement lié. Par exemple, un commercial travaillant dans une affaire peut voir le numéro de téléphone ou l'adresse e-mail actuels du contact lié sans jamais quitter cet enregistrement d'affaire. [1]
Étape 2. Vérifiez que votre centre de données est pris en charge. Au moment de la rédaction, le Mirror Component est disponible pour les centres de données JP, CA, SA, UAE et AU. Si votre organisation se trouve sur un autre DC, consultez la page des notes de version de Zoho CRM pour connaître le statut de déploiement le plus récent avant de continuer. [1]
Étape 3. Accédez à l'enregistrement sur lequel vous souhaitez afficher les données liées — par exemple, ouvrez un enregistrement Affaire. Le Mirror Component est ajouté au niveau de la page de détail de l'enregistrement, vous devez donc vous trouver dans la vue d'enregistrement du bon module. [1]
Étape 4. Accédez aux paramètres de mise en page ou de personnalisation des composants pour ce module. Ajoutez le Mirror Component à la mise en page, puis configurez le module lié (par ex., Contacts) et les champs spécifiques (par ex., téléphone, e-mail) que vous souhaitez refléter. Une fois enregistrés, ces champs afficheront des données en direct extraites de l'enregistrement lié à chaque chargement de la page. [1]
Étape 5. Vérifiez que le composant fonctionne en ouvrant un enregistrement qui possède une relation de recherche renseignée. Les champs reflétés doivent afficher les valeurs actuelles de l'enregistrement lié sans aucune actualisation manuelle. [1]
---
Option B — API GraphQL (chemin développeur)
Étape 1. Confirmez l'éligibilité. L'API GraphQL de Zoho CRM n'est pas disponible sur les éditions d'essai de tout plan CRM ; assurez-vous donc que votre organisation est sur un niveau payant avant de développer contre elle. [7]
Étape 2. Comprenez la structure de la requête. L'API GraphQL expose deux types racines : Meta (pour les métadonnées de module/utilisateur/rôle) et Records (pour les données réelles des modules). Vous utiliserez le type Records pour récupérer les champs d'un module lié. [7]
Étape 3. Rédigez une requête ciblant le module spécifique contenant votre enregistrement lié. Par exemple, pour récupérer le champ AccountName du module Accounts ainsi qu'un LastName de Leads en un seul aller-retour, structurez votre requête sous la racine Records et spécifiez uniquement les champs dont vous avez besoin dans _data. [7]
query {
Records {
Accounts {
_data {
Account_Name {
value
}
}
}
}
}Étape 4. Filtrez la requête sur un seul enregistrement en passant l'ID d'enregistrement concerné comme paramètre de filtre dans la requête. L'API GraphQL prend en charge le filtrage et la pagination sur tous les modules accessibles, ce qui vous permet de limiter la réponse à exactement un enregistrement lié plutôt que de récupérer une liste entière. [7]
Étape 5. Analysez le champ value de l'objet de réponse. Chaque champ du tableau _data retourne une clé value contenant les données réelles, ce qui facilite l'extraction et l'affichage dans votre application ou votre fonction Zoho. [7]
---
Erreurs courantes
- Disponibilité du Mirror Component selon le DC. Si votre centre de données ne figure pas encore dans la liste prise en charge (JP, CA, SA, UAE, AU), l'option du composant n'apparaîtra pas dans votre éditeur de mise en page. Consultez le fil de publication de la communauté pour les annonces d'extension plutôt que de supposer qu'il s'agit d'une erreur de configuration. [1]
- GraphQL sur les comptes d'essai. Toute tentative d'appel de l'endpoint GraphQL sur une organisation en version d'essai échouera. Utilisez l'API REST comme solution de repli, ou mettez d'abord à niveau le compte. [7]
- Champ de recherche requis pour le Mirror Component. Le Mirror Component repose sur une relation de recherche existante entre les modules. Si aucun champ de recherche ne relie les deux modules, le composant n'a rien à refléter — vous devez d'abord établir la relation. [1]
- Données en temps réel vs. données en cache. Le Mirror Component reflète les données en temps réel ; ainsi, toute valeur obsolète que vous observez est probablement due au cache du navigateur plutôt qu'à un problème de synchronisation CRM. Un rechargement forcé résout généralement ce problème. [1]
---
Points à vérifier
- Éligibilité du DC confirmée — vérifiez que votre centre de données CRM figure dans la liste prise en charge avant de passer du temps à configurer la mise en page du Mirror Component. [1]
- Relation de recherche existante — assurez-vous qu'un champ de recherche relie déjà les deux modules concernés ; sans cela, ni le Mirror Component ni une requête GraphQL filtrée ne retourneront l'enregistrement lié. [1]
- Vérification de l'édition GraphQL — si vous utilisez le chemin API, confirmez que l'organisation est sur une édition CRM payante afin que l'endpoint GraphQL soit accessible. [7]
---
*Beam Help est une ressource d'assistance experte indépendante pour les produits Zoho et ne constitue pas le support officiel de Zoho. Croisez toujours les informations avec la dernière documentation Zoho CRM correspondant à votre édition et à votre centre de données spécifiques.*