Comment récupérer des variables dans Zoho

La récupération de variables dans Zoho implique de comprendre deux concepts distincts mais liés : les variables à portée applicative dans Zoho Creator et les variables système Zoho prédéfinies disponibles dans les scripts Deluge à travers les différents services.

Pourquoi c'est important

Si vous développez des applications multi-formulaires ou automatisez des workflows, vous aurez souvent besoin qu'une valeur unique — comme un paramètre de configuration ou une date — soit accessible partout sans avoir à la redéfinir à chaque fois. Savoir comment déclarer et récupérer correctement les variables permet d'éviter les flux défaillants, les données obsolètes et les erreurs de script difficiles à déboguer. Cela est particulièrement pertinent lorsque vous travaillez avec des formulaires Zoho Creator ou que vous rédigez des scripts Deluge dans n'importe quel service Zoho.

> Remarque : Beam Help est un support expert indépendant pour Zoho — nous ne sommes pas le support officiel de Zoho.

---

Étape par étape

Étape 1. Comprendre les deux types de variables que vous pourriez avoir besoin de récupérer.

Avant d'écrire du code, clarifiez le type de variable avec lequel vous travaillez. Zoho Creator propose des Variables à portée applicative — déclarées une seule fois et utilisables dans toute votre application Creator, à l'image des fonctions réutilisables. Par ailleurs, Deluge fournit des Variables Zoho intégrées, qui sont des variables prédéfinies au niveau système disponibles dans différents services Zoho. ^[1][4]

---

Étape 2. Récupérer les variables à portée applicative dans Zoho Creator.

La fonctionnalité Variables de Zoho Creator vous permet de définir une variable au niveau de l'application, puis de la référencer depuis n'importe quel formulaire, workflow ou script au sein de cette même application. Pour utiliser une variable que vous avez déjà déclarée :

• Ouvrez le script Deluge concerné (par exemple, un workflow de formulaire ou une fonction).
• Référencez la variable par le nom que vous lui avez attribué lors de sa déclaration — aucune importation ni initialisation supplémentaire n'est nécessaire dans la même portée applicative.
• Ces variables étant centralisées, toute mise à jour de leur valeur est répercutée partout où elles sont référencées dans l'application. ^[1][2]

Cette approche centralisée facilite considérablement la gestion des données partagées entre différents formulaires et composants de l'application, sans dupliquer la logique. ^[2]

---

Étape 3. Récupérer les variables système Zoho intégrées dans Deluge.

Lorsque vous rédigez des scripts Deluge — que ce soit dans Zoho Creator, Zoho CRM ou un autre service — vous pouvez récupérer la date et l'heure actuelles à l'aide de deux variables Zoho prédéfinies :

• zoho.currentdate — renvoie la date du jour selon le format configuré dans les paramètres de votre service.
• zoho.currenttime — renvoie la date et l'heure actuelles, également formatées selon la configuration de votre service.

Ces variables peuvent être utilisées directement dans n'importe quelle expression Deluge sans déclaration préalable. ^[4]

Exemple d'utilisation dans un script Deluge :

today = zoho.currentdate;
now = zoho.currenttime;
info today;
info now;

Les deux variables tirent leur format des paramètres du service Zoho dans lequel le script s'exécute, de sorte que le résultat peut différer entre, par exemple, Zoho CRM et Zoho Creator. ^[4]

---

Étape 4. Reformater les variables de date/heure récupérées si nécessaire.

Le format de sortie par défaut de zoho.currentdate et zoho.currenttime convient à la journalisation de base, mais peut ne pas correspondre au format requis par votre logique métier ou votre interface utilisateur. Deluge propose des fonctions de formatage de date qui vous permettent de convertir ces valeurs dans n'importe quel format ou fuseau horaire après leur récupération. ^[4]

---

Étape 5. Surveiller le comportement des variables dans les flux déclenchés par e-mail.

Si vous récupérez des variables créées à partir d'un déclencheur e-mail (par exemple dans Zoho Flow), sachez que la variable n'est renseignée que lorsque les données entrantes correspondent à la structure utilisée lors de la première configuration du modèle. Si les valeurs des champs diffèrent des données du modèle d'origine, la variable peut ne pas être créée du tout, ce qui peut entraîner l'échec des étapes suivantes de votre flux. ^[3]

---

Erreurs courantes

• Incompatibilité de modèle dans les déclencheurs e-mail : Les variables extraites des déclencheurs e-mail dans Zoho Flow sont étroitement liées à la structure du modèle d'origine. Si l'e-mail entrant contient des valeurs de champs différentes (même simplement un nom différent), la variable peut ne pas être capturée, ce qui interrompt l'ensemble du flux. Veillez toujours à ce que votre modèle d'e-mail couvre toutes les variations attendues. ^[3]

• Dépendance au format des paramètres du service : zoho.currentdate et zoho.currenttime ne renvoient pas un format universel — le résultat dépend du format de date/heure configuré dans le service Zoho spécifique où le script s'exécute. Si vous déplacez des scripts entre des services, vérifiez les paramètres de format pour éviter des résultats inattendus. ^[4]

• Confusion de portée entre les variables Creator et les variables Deluge : Les variables à portée applicative dans Zoho Creator sont gérées via l'interface Creator et persistent au niveau de l'application. Les variables zoho.* de Deluge sont des valeurs système en lecture seule. Confondre ces deux concepts peut entraîner des erreurs lorsque vous tentez d'assigner une valeur à une variable système ou que vous vous attendez à ce qu'une variable applicative soit disponible en dehors de l'application dans laquelle elle a été déclarée. ^[1][4]

---

Ce qu'il faut vérifier

• Confirmer la portée de la variable : Vérifiez si votre variable est une variable Creator à portée applicative ou une variable système Deluge — la méthode de récupération diffère pour chacune. ^[1][4]
• Valider le format de sortie de la date/heure : Après avoir récupéré zoho.currentdate ou zoho.currenttime, journalisez la valeur et confirmez qu'elle correspond au format attendu par votre logique en aval, surtout si le script s'exécute dans plusieurs services Zoho. ^[4]
• Tester les modèles de déclencheurs e-mail avec des données variées : Si des variables proviennent de déclencheurs e-mail, envoyez des e-mails de test avec différentes valeurs de champs pour confirmer que la variable est correctement capturée dans chaque cas, et pas seulement avec les données d'exemple d'origine. ^[3]