Cómo recuperar variables en Zoho

Recuperar variables en Zoho implica comprender dos conceptos distintos pero relacionados: las variables de ámbito de aplicación en Zoho Creator y las variables de sistema predefinidas de Zoho disponibles en los scripts de Deluge en distintos servicios.

Por qué esto es importante

Si estás creando aplicaciones con múltiples formularios o automatizando flujos de trabajo, a menudo necesitarás un único valor — como una configuración o una fecha — que sea accesible en todas partes sin tener que redefinirlo cada vez. Saber cómo declarar y recuperar variables correctamente evita flujos rotos, datos desactualizados y errores de scripting difíciles de depurar. Esto es especialmente relevante cuando se trabaja con formularios de Zoho Creator o se escriben scripts de Deluge en cualquier servicio de Zoho.

> Nota: Beam Help es soporte experto independiente para Zoho — no somos el soporte oficial de Zoho.

---

Paso a paso

Paso 1. Comprende los dos tipos de variables que puedes necesitar recuperar.

Antes de escribir cualquier código, aclara con qué tipo de variable estás trabajando. Zoho Creator ofrece Variables de ámbito de aplicación — declaradas una vez y utilizables en toda tu aplicación de Creator, de forma similar a cómo se reutilizan las funciones. Por otro lado, Deluge proporciona Variables de Zoho integradas, que son variables predefinidas a nivel de sistema disponibles en distintos servicios de Zoho. ^[1][4]

---

Paso 2. Recupera variables de ámbito de aplicación en Zoho Creator.

La función de Variables de Zoho Creator te permite definir una variable a nivel de aplicación y luego referenciarla desde cualquier formulario, flujo de trabajo o script dentro de esa misma aplicación. Para usar una variable que ya has declarado:

• Abre el script de Deluge correspondiente (por ejemplo, un flujo de trabajo de formulario o una función).
• Referencia la variable por el nombre que le asignaste durante la declaración — no se necesita ninguna importación o inicialización adicional dentro del mismo ámbito de aplicación.
• Dado que estas variables están centralizadas, cualquier actualización del valor de la variable se refleja en todos los lugares donde se referencia dentro de la aplicación. ^[1][2]

Este enfoque centralizado facilita considerablemente la gestión de datos compartidos entre distintos formularios y componentes de la aplicación sin duplicar la lógica. ^[2]

---

Paso 3. Recupera las variables de sistema integradas de Zoho en Deluge.

Al escribir scripts de Deluge — ya sea dentro de Zoho Creator, Zoho CRM u otro servicio — puedes recuperar la fecha y hora actuales usando dos variables predefinidas de Zoho:

• zoho.currentdate — devuelve la fecha de hoy según el formato configurado en los ajustes de tu servicio.
• zoho.currenttime — devuelve la fecha y hora actuales, también formateadas según la configuración de tu servicio.

Estas pueden insertarse directamente en cualquier expresión de Deluge sin ninguna declaración previa. ^[4]

Ejemplo de uso en un script de Deluge:

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

Ambas variables toman su formato de los ajustes del servicio de Zoho en el que se ejecuta el script, por lo que el resultado puede diferir entre, por ejemplo, Zoho CRM y Zoho Creator. ^[4]

---

Paso 4. Reformatea las variables de fecha/hora recuperadas si es necesario.

El resultado predeterminado de zoho.currentdate y zoho.currenttime es adecuado para registros básicos, pero puede no coincidir con el formato requerido por tu lógica de negocio o interfaz de usuario. Deluge proporciona funciones de formato de fecha que te permiten convertir estos valores a cualquier formato o zona horaria que necesites después de recuperarlos. ^[4]

---

Paso 5. Presta atención al comportamiento de las variables en flujos activados por correo electrónico.

Si estás recuperando variables que se crearon a partir de un disparador de correo electrónico (por ejemplo, en Zoho Flow), ten en cuenta que la variable solo se rellena cuando los datos entrantes coinciden con la estructura utilizada cuando la plantilla se configuró por primera vez. Si los valores de los campos difieren de los datos de la plantilla original, es posible que la variable no se cree en absoluto, lo que puede provocar que los pasos posteriores de tu flujo fallen. ^[3]

---

Errores comunes

• Discrepancia de plantilla en disparadores de correo electrónico: Las variables extraídas de disparadores de correo electrónico en Zoho Flow están estrechamente vinculadas a la estructura de la plantilla original. Si el correo entrante contiene valores de campo diferentes (incluso solo un nombre distinto), es posible que la variable no se capture, rompiendo todo el flujo. Valida siempre que tu plantilla de correo electrónico cubra todas las variaciones esperadas. ^[3]

• Dependencia del formato en los ajustes del servicio: zoho.currentdate y zoho.currenttime no devuelven un formato universal — el resultado depende del formato de fecha/hora configurado en el servicio de Zoho específico donde se ejecuta el script. Si mueves scripts entre servicios, verifica los ajustes de formato para evitar resultados inesperados. ^[4]

• Confusión de ámbito entre variables de Creator y variables de Deluge: Las variables de ámbito de aplicación en Zoho Creator se gestionan a través de la interfaz de Creator y persisten a nivel de aplicación. Las variables zoho.* de Deluge son valores de sistema de solo lectura. Confundir estos dos conceptos puede generar errores cuando intentas asignar un valor a una variable de sistema o esperas que una variable de aplicación esté disponible fuera de su aplicación declarada. ^[1][4]

---

Qué verificar

• Confirma el ámbito de la variable: Verifica si tu variable es una variable de Creator de ámbito de aplicación o una variable de sistema de Deluge — el método de recuperación es diferente para cada una. ^[1][4]
• Valida el formato de salida de fecha/hora: Después de recuperar zoho.currentdate o zoho.currenttime, registra el valor y confirma que coincide con el formato que espera tu lógica posterior, especialmente si el script se ejecuta en múltiples servicios de Zoho. ^[4]
• Prueba las plantillas de disparadores de correo electrónico con datos variados: Si las variables provienen de disparadores de correo electrónico, envía correos de prueba con diferentes valores de campo para confirmar que la variable se captura correctamente en cada caso, no solo con los datos de muestra originales. ^[3]