Beam Help
Richiedi supporto

How-to · Zoho CRM

Come aggiornare campi personalizzati con funzioni Deluge in Zoho CRM

Deluge è il linguaggio di scripting di Zoho CRM che ti consente di automatizzare gli aggiornamenti dei campi e le operazioni sui dati complesse a livello di codice. Puoi utilizzare le funzioni Deluge per modificare campi personalizzati sui record, convalidare i dati prima del salvataggio e attivare aggiornamenti tra moduli correlati.


Perché è importante


Gli aggiornamenti dei campi personalizzati tramite Deluge sono essenziali quando è necessario automatizzare modifiche ai dati che vanno oltre i flussi di lavoro standard, sincronizzare dati tra moduli o applicare logiche di business che l'interfaccia utente da sola non può gestire. Questo approccio è particolarmente utile durante le migrazioni di dati, le operazioni in blocco o quando si integra Zoho CRM con sistemi esterni.


Passaggi


Passaggio 1. Accedi all'editor Deluge in Zoho CRM.


Naviga nel tuo spazio di lavoro Zoho CRM e apri la sezione di automazione in cui vengono gestite le funzioni personalizzate. Deluge è il linguaggio di scripting interno disponibile in tutti i prodotti Zoho per eseguire operazioni come chiamate API, query di database e manipolazioni di dati [3].


Passaggio 2. Scrivi una funzione per indirizzare il campo personalizzato.


Crea una funzione Deluge che faccia riferimento al campo personalizzato tramite il suo nome API. Puoi trovare il nome API facendo clic con il pulsante destro del mouse sul campo nel tuo modulo CRM e selezionando l'opzione per visualizzare i dettagli del campo. Utilizza l'identificatore di campo corretto (metaApiName o inputApiName) per garantire che il sistema riconosca il campo che desideri aggiornare [2].


Passaggio 3. Utilizza la sintassi Deluge appropriata per aggiornare il valore del campo.


Struttura il tuo script per assegnare un nuovo valore al campo personalizzato. La sintassi esatta dipende se stai aggiornando un singolo record, più record o recuperando dati da moduli correlati. Ad esempio, se devi aggiornare un campo data da un modulo a un altro, potresti dover prima recuperare il valore di origine, quindi applicarlo al campo di destinazione [5].


Passaggio 4. Testa la funzione con dati di esempio.


Prima di distribuire in produzione, esegui la tua funzione Deluge su un record di test per verificare che il campo personalizzato venga aggiornato correttamente. Verifica che il valore appaia nel campo e che non si verifichino errori di convalida. Se riscontri un errore "PATTERNNOTMATCHED", ricontrolla di utilizzare il nome API del campo corretto [2].


Passaggio 5. Integra la funzione nel tuo flusso di lavoro o regola di automazione.


Una volta testata, attiva la funzione Deluge da una regola di flusso di lavoro, un'azione di pulsante o un'attività pianificata. Ciò garantisce che l'aggiornamento del campo personalizzato venga eseguito automaticamente quando vengono soddisfatte le condizioni specificate, anziché richiedere l'esecuzione manuale ogni volta [4].


Errori comuni


I nomi API dei campi sono sensibili alle maiuscole e devono corrispondere esattamente a come appaiono nella configurazione del tuo CRM. Se il tuo campo personalizzato non appare nella risposta API o ricevi un errore di corrispondenza del modello, verifica il nome API ispezionando le proprietà del campo direttamente nelle impostazioni del modulo [2].


Quando aggiorni campi tra moduli correlati, assicurati di avere l'ID del record corretto e che la relazione tra i moduli sia definita correttamente. Tentare di aggiornare un campo su un tipo di record che non ha accesso a quel campo farà sì che l'operazione fallisca silenziosamente o generi un errore [5].


Cosa controllare


  • Conferma che il nome API del campo personalizzato corrisponda esattamente a quanto inserito nel tuo script Deluge.
  • Verifica che l'ID del record di destinazione esista e appartenga al modulo corretto.
  • Testa la funzione prima su un record non critico per assicurarti che l'aggiornamento produca il risultato atteso prima di eseguirla sui dati di produzione.

---


Nota: Questo articolo è fornito da Beam Help, supporto esperto indipendente per Zoho, non supporto ufficiale Zoho. Per la documentazione ufficiale, consulta direttamente il portale di aiuto di Zoho.

Sources cited

  1. [1] Zoho Community | Connect, network, and share on Zoho Forums
  2. [2] How to Update custom Fillable Fields via Zoho Contracts API
  3. [3] Introduction to Zoho Bookings | Help - Zoho Bookings
  4. [4] Organizational Tree Map Extension
  5. [5] Zoho Developer Community Monthly Digest – May 2025
  6. [6] Writer | Custom Function | Knowledge Base
  7. [7] Zoho Community | Connect, network, and share on Zoho Forums
Aggiorna campi personalizzati con Deluge in Zoho CRM | Beam Help