Comment récupérer une variable spécifique dans Zoho CRM

La récupération d'une variable spécifique dans Zoho CRM vous permet de transmettre des valeurs dynamiques et d'exécution dans les requêtes et les composants — en gardant vos récupérations de données flexibles sans codifier les critères en dur.

Pourquoi c'est important

Lorsque vous créez des requêtes dans le Developer Hub de Zoho CRM, vous devez souvent filtrer ou paramétrer les résultats en fonction d'un contexte qui change à l'exécution — comme l'utilisateur actuel, un ID d'enregistrement sélectionné ou une plage de dates. Les variables résolvent ce problème en agissant comme des espaces réservés qui sont résolus lors de l'exécution réelle de la requête. Sans elles, vous auriez besoin d'une requête distincte pour chaque combinaison de filtre possible, ce qui devient rapidement ingérable. ^[6]

Étape par étape

Étape 1. Accédez à la section Requêtes en allant à Configuration → Developer Hub → Requêtes. La fenêtre Requêtes s'ouvrira, affichant toutes les requêtes existantes que vous avez configurées. ^[6]

Étape 2. Ouvrez la requête dans laquelle vous souhaitez utiliser une variable, ou cliquez pour en créer une nouvelle. Choisissez le type de source approprié — Module, COQL ou REST API — selon l'endroit où se trouvent vos données. Chaque type de source détermine comment et où les variables peuvent être insérées. ^[6]

Étape 3. Déclarez votre variable directement dans la définition de la requête. Les variables doivent être écrites entre double accolades en utilisant le format {{VARIABLE_NAME}}. Vous pouvez les placer dans les filtres de critères, les conditions des instructions COQL, les valeurs de champs ou les chemins et en-têtes des points de terminaison REST API — partout où une valeur dynamique est nécessaire. ^[6]

Étape 4. Enregistrez la requête. Une fois enregistrée, l'espace réservé de la variable est enregistré et prêt à être mappé. ^[6]

Étape 5. Associez la requête à un composant (par exemple, un élément Canvas ou un widget de tableau de bord). Lors de l'étape d'association, vous serez invité à mapper chaque variable déclarée au champ ou à la source d'entrée pertinente. Ce mappage est ce qui indique à Zoho CRM quelle valeur réelle substituer à {{VARIABLE_NAME}} au moment de l'exécution. ^[6]

Étape 6. Testez la requête en déclenchant le composant ou en exécutant la requête en contexte. Le système résoudra chaque espace réservé {{VARIABLE_NAME}} avec la valeur d'exécution mappée et retournera les résultats filtrés en conséquence. ^[6]

Extraction d'une valeur de variable à partir d'une structure de données imbriquée

Si votre variable contient des données structurées — par exemple, une charge utile JSON provenant d'une intégration externe comme Calendly — vous devrez peut-être analyser un champ spécifique avant de le mapper à un champ CRM. Un scénario courant est un numéro de téléphone enfoui dans un objet imbriqué tel que :

"questions_and_answers": {
  "question": "Phone number",
  "answer": "0612345678",
  "position": 0
}

Dans ce cas, la variable brute ne peut pas être mappée directement à un champ de téléphone CRM. Vous devriez d'abord extraire la clé answer de la charge utile — généralement en utilisant une étape de transformation dans votre flux d'intégration (comme une fonction Zoho Flow ou une fonction personnalisée) — avant de transmettre la valeur nettoyée au champ CRM. ^[2]

Pièges courants

• Syntaxe incorrecte : Les variables qui ne sont pas entourées de double accolades ({{VARIABLE_NAME}}) seront traitées comme des chaînes littérales plutôt que comme des espaces réservés dynamiques, ce qui entraînera des requêtes qui ne retournent aucun résultat ou génèrent des erreurs. Confirmez toujours le format exact. ^[6]
• Variables non mappées au moment de l'association : Si vous déclarez une variable dans une requête mais oubliez de la mapper lors de l'association de la requête à un composant, la valeur d'exécution sera vide et votre requête retournera probablement des résultats inattendus. Vérifiez que chaque variable a un mappage correspondant. ^[6]
• Valeurs JSON imbriquées : Lorsqu'une variable contient un objet complexe (comme une charge utile webhook Calendly), vous ne pouvez pas mapper une propriété imbriquée directement. Vous devez d'abord extraire la valeur spécifique en utilisant une transformation ou une fonction personnalisée avant qu'elle puisse remplir un champ CRM correctement. ^[2]
• Restrictions de type de source : Tous les placements de variables ne sont pas disponibles pour chaque type de source. Par exemple, les requêtes de source REST API permettent les variables dans les URL de points de terminaison et les en-têtes, tandis que les requêtes COQL les utilisent dans l'instruction de requête elle-même. Confirmez quels placements sont valides pour votre source choisie. ^[6]

Ce qu'il faut vérifier

• Vérifiez que chaque {{VARIABLE_NAME}} dans votre requête est correctement mappé à un champ ou à une source d'entrée lorsque la requête est associée à un composant. ^[6]
• Confirmez que la valeur de variable transmise à l'exécution est du type de données correct attendu par le champ CRM cible (par exemple, une chaîne simple pour un numéro de téléphone, pas un objet JSON). ^[2]
• Après l'exécution, examinez la réponse de la requête pour vous assurer que les données retournées correspondent au résultat filtré attendu — pas l'ensemble de données complet non filtré. ^[6]

---

*Beam Help est une ressource d'assistance expert indépendante pour les produits Zoho et n'est pas le support officiel de Zoho. Pour les problèmes au niveau de la plateforme, vérifiez toujours auprès de la documentation propre de Zoho.*