Come recuperare una variabile specifica in Zoho CRM

Recuperare una variabile specifica in Zoho CRM ti consente di passare valori dinamici e runtime in query e componenti — mantenendo i tuoi recuperi dati flessibili senza hardcodare i criteri.

Perché è importante

Quando costruisci query nell'Hub Sviluppatori di Zoho CRM, spesso hai bisogno di filtrare o parametrizzare i risultati in base a un contesto che cambia a runtime — come l'utente corrente, un ID record selezionato o un intervallo di date. Le variabili risolvono questo problema agendo come segnaposti che vengono risolti quando la query viene effettivamente eseguita. Senza di esse, avresti bisogno di una query separata per ogni possibile combinazione di filtri, il che diventa rapidamente ingestibile. ^[6]

Procedura passo dopo passo

Passaggio 1. Accedi alla sezione Query andando a Setup → Hub Sviluppatori → Query. Si aprirà la finestra Query, mostrando tutte le query esistenti che hai configurato. ^[6]

Passaggio 2. Apri la query in cui desideri utilizzare una variabile, oppure fai clic per crearne una nuova. Scegli il tipo di origine appropriato — Modulo, COQL o REST API — a seconda di dove risiedono i tuoi dati. Ogni tipo di origine determina come e dove le variabili possono essere inserite. ^[6]

Passaggio 3. Dichiara la tua variabile direttamente nella definizione della query. Le variabili devono essere scritte tra doppie parentesi graffe utilizzando il formato {{VARIABLE_NAME}}. Puoi posizionarle all'interno di filtri criteri, condizioni di istruzioni COQL, valori di campi o percorsi e intestazioni di endpoint REST API — ovunque sia necessario un valore dinamico. ^[6]

Passaggio 4. Salva la query. Una volta salvata, il segnaposto della variabile è registrato e pronto per essere mappato. ^[6]

Passaggio 5. Associa la query a un componente (ad esempio, un elemento Canvas o un widget dashboard). Durante il passaggio di associazione, ti verrà chiesto di mappare ogni variabile dichiarata al campo o alla fonte di input pertinente. Questo mapping è ciò che dice a Zoho CRM quale valore reale sostituire in {{VARIABLE_NAME}} al momento dell'esecuzione. ^[6]

Passaggio 6. Testa la query attivando il componente o eseguendo la query nel contesto. Il sistema risolverà ogni segnaposto {{VARIABLE_NAME}} con il valore runtime mappato e restituirà i risultati filtrati di conseguenza. ^[6]

Estrazione di un valore di variabile da una struttura dati nidificata

Se la tua variabile contiene dati strutturati — ad esempio, un payload JSON proveniente da un'integrazione esterna come Calendly — potrebbe essere necessario analizzare un campo specifico prima di mapparlo a un campo CRM. Uno scenario comune è un numero di telefono sepolto all'interno di un oggetto nidificato come:

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

In questo caso, la variabile grezza non può essere mappata direttamente a un campo telefono CRM. Dovresti estrarre la chiave answer dal payload prima — tipicamente utilizzando un passaggio di trasformazione nel tuo flusso di integrazione (come una funzione Zoho Flow o una funzione personalizzata) — prima di passare il valore pulito nel campo CRM. ^[2]

Errori comuni

• Sintassi non corretta: Le variabili che non sono racchiuse tra doppie parentesi graffe ({{VARIABLE_NAME}}) verranno trattate come stringhe letterali anziché come segnaposti dinamici, causando query che non restituiscono risultati o generano errori. Conferma sempre il formato esatto. ^[6]
• Variabili non mappate al momento dell'associazione: Se dichiari una variabile in una query ma dimentichi di mapparla quando associa la query a un componente, il valore runtime sarà vuoto e la tua query probabilmente restituirà risultati inaspettati. Verifica che ogni variabile abbia un mapping corrispondente. ^[6]
• Valori JSON nidificati: Quando una variabile contiene un oggetto complesso (come un payload webhook di Calendly), non puoi mappare direttamente una proprietà nidificata. Devi prima estrarre il valore specifico utilizzando una trasformazione o una funzione personalizzata prima che possa popolare un campo CRM in modo pulito. ^[2]
• Restrizioni del tipo di origine: Non tutti i posizionamenti di variabili sono disponibili per ogni tipo di origine. Ad esempio, le query di origine REST API consentono variabili negli URL di endpoint e nelle intestazioni, mentre le query COQL le utilizzano all'interno dell'istruzione query stessa. Conferma quali posizionamenti sono validi per la tua origine scelta. ^[6]

Cosa verificare

• Verifica che ogni {{VARIABLE_NAME}} nella tua query sia correttamente mappato a un campo o a una fonte di input quando la query è associata a un componente. ^[6]
• Conferma che il valore della variabile passato a runtime sia il tipo di dato corretto previsto dal campo CRM di destinazione (ad esempio, una stringa semplice per un numero di telefono, non un oggetto JSON). ^[2]
• Dopo l'esecuzione, rivedi la risposta della query per assicurarti che i dati restituiti corrispondano al risultato filtrato previsto — non al set di dati completo non filtrato. ^[6]

---

*Beam Help è una risorsa di supporto esperto indipendente per i prodotti Zoho e non è il supporto ufficiale di Zoho. Per problemi a livello di piattaforma, verifica sempre con la documentazione ufficiale di Zoho.*