La récupération des sections d'un enregistrement dans Zoho CRM peut être effectuée via l'interface utilisateur à l'aide du composant Mirror pour des données d'enregistrements liés en temps réel, ou de manière programmatique via l'API GraphQL pour interroger des champs spécifiques dans différents modules. Ce guide couvre les deux approches afin que vous puissiez choisir la méthode adaptée à votre cas d'usage.
---
*Beam Help est un support expert indépendant pour Zoho — pas le support officiel de Zoho.*
---
Pourquoi c'est important
Lorsque vous travaillez dans Zoho CRM, les enregistrements existent rarement de manière isolée — une affaire est liée à un contact, un dossier est rattaché à un client, et chaque enregistrement lié contient un contexte essentiel. [1] Sans une méthode structurée pour faire remonter ces données, les équipes perdent du temps à naviguer entre les modules pour trouver le dernier numéro de téléphone, l'adresse e-mail ou le statut du compte. [1] Que vous ayez besoin d'une solution visuelle sans code ou d'une requête API de niveau développeur, savoir comment récupérer efficacement les sections d'un enregistrement permet à votre équipe de rester concentrée et à vos données d'être précises.
---
Étape par étape
Option A — Utiliser le composant Mirror (interface utilisateur, sans code)
Étape 1. Comprendre ce que fait le composant Mirror. Il agit comme une fenêtre en direct sur un enregistrement lié, affichant les champs de cet enregistrement lié directement sur la page de détails de l'enregistrement que vous consultez actuellement — sans changer de module. [1]
Étape 2. Vérifiez l'éligibilité de votre centre de données. Selon la dernière annonce, le composant Mirror est disponible pour les centres de données JP, CA, SA, UAE et AU. [1] Si votre organisation utilise un autre centre de données, consultez les notes de version de Zoho CRM pour les mises à jour de disponibilité. [7]
Étape 3. Accédez à la page de détails de l'enregistrement sur lequel vous souhaitez faire apparaître les données liées — par exemple, un enregistrement Affaires lié à un Contact. [1]
Étape 4. Ouvrez l'éditeur de mise en page pour ce module (via Configuration → Modules et champs → [Module] → Mises en page) et ajoutez le composant Mirror à la mise en page. Configurez-le pour pointer vers le module lié (par ex., Contacts) et sélectionnez les champs spécifiques que vous souhaitez refléter, tels que le numéro de téléphone ou l'adresse e-mail. [1]
Étape 5. Enregistrez la mise en page et revenez à un enregistrement actif. Les champs reflétés afficheront désormais des valeurs en temps réel extraites directement de l'enregistrement lié, de sorte que votre équipe voit toujours les données les plus récentes sans quitter la page. [1]
---
Option B — Utiliser l'API GraphQL (récupération par développeur/programmatique)
Étape 1. Vérifiez l'accès à l'API. Les API GraphQL de Zoho CRM ne sont pas disponibles dans les éditions d'essai de quelque plan CRM que ce soit. Assurez-vous donc que votre organisation dispose d'une édition payante avant de continuer. [2]
Étape 2. Comprenez les deux types de requêtes racines disponibles. Le type Meta vous permet de récupérer des métadonnées à partir de sources telles que les Modules, les Utilisateurs, les Rôles, les Profils et les Widgets. Le type Records vous permet de récupérer les données de champs réels depuis n'importe quel module auquel votre profil a accès, avec filtrage et pagination pris en charge pour tous les modules. [2]
Étape 3. Construisez votre requête GraphQL. Pour récupérer les sections d'enregistrement (champs) de plusieurs modules en une seule requête, imbriquez les modules souhaités sous Records et spécifiez les noms de champs dans data. Par exemple, pour extraire simultanément AccountName depuis Accounts et Last_Name depuis Leads, votre requête ressemblerait à ceci : [2]
query {
Records {
Accounts {
_data {
Account_Name {
value
}
}
}
Leads {
_data {
Last_Name {
value
}
}
}
}
}Étape 4. Envoyez la requête à l'endpoint GraphQL de Zoho CRM en utilisant votre client HTTP préféré ou le SDK JavaScript. Le SDK fournit des exemples de code pour récupérer des enregistrements depuis des modules tels que Leads, et prend en charge plusieurs versions d'API (V6, V7, V8). [3]
Étape 5. Analysez la réponse. Les enregistrements de chaque module sont retournés sous leurs tableaux _data respectifs, chaque champ exposant une propriété value. [2] Mappez ces valeurs au modèle de données de votre application selon vos besoins.
---
Erreurs courantes
- Blocage en édition d'essai : Toute tentative d'utilisation de l'API GraphQL sur un compte d'essai échouera — l'API est explicitement indisponible dans les versions d'essai. [2] Passez d'abord à une édition payante.
- Restriction du composant Mirror selon le centre de données : Si le centre de données de votre organisation ne fait pas partie de JP, CA, SA, UAE ou AU, le composant Mirror peut ne pas encore être disponible. [1] Consultez la page des notes de version pour connaître le statut de déploiement de votre centre de données. [7]
- Champs de liaison vs. composant Mirror : Les champs de liaison standard établissent des relations entre les modules, mais ne peuvent pas faire remonter toutes les données contextuelles des champs dans l'enregistrement parent. [1] Ne confondez pas un champ de liaison avec le composant Mirror — ils servent des objectifs différents.
- Lacunes de visibilité sur mobile : Les champs de liste liée et les composants configurés dans la mise en page web peuvent ne pas apparaître automatiquement dans l'application mobile CRM. [4] Testez votre mise en page sur mobile après avoir effectué des modifications.
---
Ce qu'il faut vérifier
- Composant Mirror : Après avoir enregistré la mise en page, ouvrez un enregistrement actif et confirmez que les champs reflétés affichent les valeurs actuelles de l'enregistrement lié — et non des données obsolètes ou vides. [1]
- Requête GraphQL : Vérifiez que les noms API des champs utilisés dans votre requête (par ex.,
AccountName,LastName) correspondent exactement aux noms API définis dans la configuration de votre module CRM, car toute discordance retournera des valeurs nulles. [2] - Édition et centre de données : Confirmez que votre édition CRM (payante, pas d'essai) et votre centre de données sont pris en charge pour la méthode de récupération que vous avez choisie. [1][2]