Come recuperare le variabili in Zoho

Recuperare le variabili in Zoho richiede la comprensione di due concetti distinti ma correlati: le variabili con ambito applicazione in Zoho Creator e le variabili di sistema Zoho predefinite disponibili negli script Deluge nei vari servizi.

Perché è importante

Se stai sviluppando applicazioni multi-form o automatizzando flussi di lavoro, avrai spesso bisogno che un singolo valore — come un'impostazione di configurazione o una data — sia accessibile ovunque senza doverlo ridefinire ogni volta. Sapere come dichiarare e recuperare le variabili correttamente previene flussi interrotti, dati obsoleti ed errori di scripting difficili da diagnosticare. Questo è particolarmente rilevante quando si lavora con i form di Zoho Creator o si scrivono script Deluge in qualsiasi servizio Zoho.

> Nota: Beam Help è un servizio di supporto esperto indipendente per Zoho — non siamo il supporto ufficiale Zoho.

---

Procedura passo dopo passo

Passaggio 1. Comprendi i due tipi di variabili che potresti dover recuperare.

Prima di scrivere qualsiasi codice, chiarisci con quale tipo di variabile stai lavorando. Zoho Creator offre Variabili con ambito applicazione — dichiarate una volta e utilizzabili in tutta la tua app Creator, in modo simile a come vengono riutilizzate le funzioni. Separatamente, Deluge fornisce Variabili Zoho integrate, ovvero variabili predefinite a livello di sistema disponibili nei diversi servizi Zoho. ^[1][4]

---

Passaggio 2. Recupera le variabili con ambito applicazione in Zoho Creator.

La funzionalità Variabili di Zoho Creator ti consente di definire una variabile a livello di applicazione e di farvi riferimento da qualsiasi form, flusso di lavoro o script all'interno della stessa applicazione. Per utilizzare una variabile già dichiarata:

• Apri lo script Deluge pertinente (ad esempio, un flusso di lavoro di un form o una funzione).
• Fai riferimento alla variabile con il nome assegnato durante la dichiarazione — non è necessario alcun import o inizializzazione aggiuntiva all'interno dello stesso ambito applicazione.
• Poiché queste variabili sono centralizzate, qualsiasi aggiornamento al valore della variabile si riflette ovunque venga referenziata nell'app. ^[1][2]

Questo approccio centralizzato rende molto più semplice gestire i dati condivisi tra form e componenti applicativi diversi senza duplicare la logica. ^[2]

---

Passaggio 3. Recupera le variabili di sistema Zoho integrate in Deluge.

Quando scrivi script Deluge — che si tratti di Zoho Creator, Zoho CRM o un altro servizio — puoi recuperare la data e l'ora correnti utilizzando due variabili Zoho predefinite:

• zoho.currentdate — restituisce la data odierna in base al formato configurato nelle impostazioni del tuo servizio.
• zoho.currenttime — restituisce la data e l'ora correnti, anch'esse formattate in base alla configurazione del tuo servizio.

Queste possono essere inserite direttamente in qualsiasi espressione Deluge senza alcuna dichiarazione preventiva. ^[4]

Esempio di utilizzo in uno script Deluge:

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

Entrambe le variabili acquisiscono il formato dalle impostazioni del servizio Zoho in cui viene eseguito lo script, quindi l'output può differire tra, ad esempio, Zoho CRM e Zoho Creator. ^[4]

---

Passaggio 4. Riformatta le variabili data/ora recuperate se necessario.

L'output predefinito di zoho.currentdate e zoho.currenttime è adatto alla registrazione di base, ma potrebbe non corrispondere al formato richiesto dalla tua logica di business o dall'interfaccia utente. Deluge fornisce funzioni di formattazione delle date che ti consentono di convertire questi valori in qualsiasi formato o fuso orario necessario dopo il recupero. ^[4]

---

Passaggio 5. Osserva il comportamento delle variabili nei flussi attivati da email.

Se stai recuperando variabili create da un trigger email (ad esempio in Zoho Flow), tieni presente che la variabile viene popolata solo quando i dati in entrata corrispondono alla struttura utilizzata al momento della prima configurazione del template. Se i valori dei campi differiscono dai dati del template originale, la variabile potrebbe non essere creata affatto, causando il fallimento dei passaggi successivi nel flusso. ^[3]

---

Errori comuni

• Mancata corrispondenza del template nei trigger email: Le variabili estratte dai trigger email in Zoho Flow sono strettamente legate alla struttura del template originale. Se l'email in entrata contiene valori di campo diversi (anche solo un nome differente), la variabile potrebbe non essere acquisita, interrompendo l'intero flusso. Verifica sempre che il tuo template email copra tutte le variazioni previste. ^[3]

• Dipendenza dal formato nelle impostazioni del servizio: zoho.currentdate e zoho.currenttime non restituiscono un formato universale — l'output dipende dal formato data/ora configurato nel servizio Zoho specifico in cui viene eseguito lo script. Se sposti gli script tra servizi diversi, verifica le impostazioni del formato per evitare output inattesi. ^[4]

• Confusione di ambito tra variabili Creator e variabili Deluge: Le variabili con ambito applicazione in Zoho Creator sono gestite tramite l'interfaccia Creator e persistono a livello di app. Le variabili zoho.* di Deluge sono valori di sistema in sola lettura. Confondere questi due concetti può generare errori quando si tenta di assegnare un valore a una variabile di sistema o ci si aspetta che una variabile dell'app sia disponibile al di fuori dell'applicazione dichiarata. ^[1][4]

---

Cosa verificare

• Conferma l'ambito della variabile: Verifica se la tua variabile è una variabile Creator con ambito applicazione o una variabile di sistema Deluge — il metodo di recupero è diverso per ciascuna. ^[1][4]
• Valida l'output del formato data/ora: Dopo aver recuperato zoho.currentdate o zoho.currenttime, registra il valore e conferma che corrisponda al formato atteso dalla tua logica a valle, specialmente se lo script viene eseguito su più servizi Zoho. ^[4]
• Testa i template dei trigger email con dati variati: Se le variabili provengono da trigger email, invia email di test con valori di campo diversi per confermare che la variabile venga acquisita correttamente in ogni caso, non solo con i dati di esempio originali. ^[3]