Come aggiornare un blueprint in Zoho CRM

Aggiornare un blueprint in Zoho CRM consente di perfezionare i flussi di processo automatizzati senza interrompere i record attivi — una capacità diventata significativamente più flessibile con l'introduzione della modifica basata su bozze.

Perché è importante

I blueprint governano il modo in cui i record si spostano attraverso le fasi definite in Zoho CRM, quindi qualsiasi modifica a transizioni, condizioni o azioni può influenzare trattative o contatti attivi nel mezzo del processo. Capire come aggiornare un blueprint in modo sicuro — incluso l'utilizzo di Client Script per aggiornare i campi prima di una transizione o bloccarla in base a una condizione — è essenziale per gli amministratori che devono iterare sui processi senza interrompere i workflow in corso. ^[2] In qualità di team di supporto esperto indipendente (non il supporto ufficiale Zoho), Beam Help ha raccolto l'approccio più affidabile basato sulla documentazione della piattaforma disponibile.

---

Procedura passo dopo passo

Passaggio 1. Salva il blueprint come bozza prima di apportare modifiche.

Una delle funzionalità più importanti disponibili è la possibilità di salvare un blueprint come bozza mentre la versione attualmente pubblicata rimane attiva e in uso. Ciò significa che puoi rivedere il flusso di processo, testare le modifiche e pubblicarle solo quando sei pronto — senza mettere in pausa o interrompere i processi automatizzati già in esecuzione. ^[3]

Passaggio 2. Accedi all'editor Blueprint nelle Impostazioni di Zoho CRM.

Dal tuo account Zoho CRM, vai su Configurazione → Gestione processi → Blueprint. Individua il blueprint che desideri modificare e aprilo nell'editor. Da qui puoi regolare gli stati, le transizioni e le azioni o condizioni associate a ciascuna transizione.

Passaggio 3. Usa i Client Script per aggiornare i campi prima che una transizione si attivi.

Se hai bisogno di aggiornare i valori dei campi in modo programmatico come parte di una transizione blueprint — o impedire il completamento di una transizione in base a una condizione specifica — i Client Script sono l'approccio consigliato. La serie Zoho CRM Kaizen affronta specificamente la questione di come aggiornare i campi prima di una transizione blueprint e come bloccare una transizione in modo condizionale utilizzando Client Script. ^[2]

Passaggio 4. Sfrutta la funzione onBeforeUpdate() per la logica basata su condizioni.

Quando si scrivono Client Script legati alle transizioni blueprint, la funzione onBeforeUpdate() è particolarmente utile. Espone un parametro value che acquisisce la *nuova* selezione dell'utente anziché il valore precedentemente salvato, consentendo di valutare i dati in ingresso e attivare avvisi o bloccare la transizione di conseguenza. ^[1] Questo è particolarmente utile quando si desidera applicare regole di qualità dei dati prima che una modifica di fase venga confermata.

Passaggio 5. Apri i modelli email dalle transizioni blueprint tramite Client Scripting.

Se il blueprint aggiornato deve aprire un modello email precompilato e modificabile quando un utente fa clic su un pulsante di transizione, anche questo può essere ottenuto tramite Client Scripting. Gli approcci verificati dalla community tramite Client Script consentono l'apertura di un modello con il contenuto precompilato, dando all'utente la possibilità di revisionarlo e modificarlo prima dell'invio. ^[1]

Passaggio 6. Pubblica il blueprint aggiornato.

Una volta apportate le modifiche in modalità bozza e validata la logica — incluse eventuali funzioni Client Script — pubblica il blueprint aggiornato. La nuova versione sostituirà quella precedentemente attiva e i record seguiranno il flusso di processo aggiornato da quel momento in poi. ^[3]

Passaggio 7. Verifica il comportamento dei tooltip e delle transizioni su mobile.

Se il tuo team utilizza l'app mobile Zoho CRM, tieni presente che le transizioni blueprint su Android ora supportano i tooltip dei campi, inclusi sia i tooltip statici (testo all'interno del campo) che i tooltip informativi (mostrati come icona informativa). Dopo aver aggiornato il blueprint, verifica che le indicazioni dei tooltip aggiunte ai campi di transizione vengano visualizzate correttamente sia su mobile che su desktop. ^[8]

---

Errori comuni

• Modificare un blueprint attivo senza utilizzare la modalità bozza può causare comportamenti imprevisti per i record attualmente in fase di transizione. Utilizza sempre la funzionalità bozza per preparare le modifiche prima della pubblicazione. ^[3]
• Estrarre i valori di ritorno dalle funzioni Client Script standalone può essere complicato. Se la transizione blueprint si basa su un Client Script che chiama una funzione standalone, assicurati di acquisire correttamente il valore di ritorno — si tratta di una sfida nota nella community e nei forum per sviluppatori Zoho CRM sono disponibili esempi di codice funzionante. ^[1]
• Utilizzare il parametro errato in onBeforeUpdate() — in particolare leggere il vecchio valore salvato invece del parametro value in ingresso — farà sì che la logica delle condizioni valuti dati obsoleti, il che significa che avvisi o blocchi potrebbero non attivarsi correttamente. ^[1]

---

Cosa verificare

• Stato bozza vs. pubblicato: Verifica che il blueprint revisionato sia stato completamente pubblicato e non sia ancora in bozza, soprattutto se gli utenti segnalano che le transizioni seguono ancora la vecchia logica.
• Associazione Client Script: Verifica che i Client Script scritti siano correttamente associati all'evento di transizione blueprint corretto (ad es. onBeforeUpdate) e che i valori di ritorno vengano gestiti come previsto. ^{[1] [2]}
• Compatibilità mobile: Se la tua organizzazione utilizza l'app Zoho CRM per Android, verifica che le pagine delle transizioni blueprint rendano correttamente i tooltip dei campi e le opzioni di transizione aggiornate dopo l'aggiornamento del blueprint. ^[8]