Come recuperare i pulsanti personalizzati in Zoho

I pulsanti personalizzati in Zoho CRM possono essere recuperati e gestiti tramite la pagina Pulsanti nelle impostazioni di personalizzazione del CRM, e possono anche essere estesi con la logica Client Script per un comportamento più ricco e interattivo direttamente nella pagina del record.

Perché è importante

Se stai creando automazioni, esperienze portale o estensioni per sviluppatori all'interno di Zoho CRM, sapere dove individuare e modificare i pulsanti personalizzati esistenti consente di risparmiare molto tempo nella risoluzione dei problemi. I pulsanti personalizzati ti permettono di attivare logiche specifiche per il record, compilare automaticamente i campi ed eseguire flussi guidati in più passaggi — il tutto senza abbandonare la vista corrente. ^[6] Capire come recuperarli è inoltre essenziale prima di collegare Client Script o funzioni Deluge a un pulsante esistente.

---

Procedura passo dopo passo

Passaggio 1. Accedi al tuo account Zoho CRM come amministratore. Vai su Impostazioni (l'icona a forma di ingranaggio nell'angolo in alto a destra), quindi seleziona Personalizzazione. Questo è il centro di controllo per tutte le personalizzazioni a livello di modulo, inclusi pulsanti e link. ^[6]

Passaggio 2. All'interno di Personalizzazione, seleziona Moduli e Campi, quindi scegli il modulo specifico (ad esempio, Contatti, Trattative o un modulo personalizzato) di cui vuoi recuperare i pulsanti. Ogni modulo mantiene il proprio set indipendente di pulsanti personalizzati. ^[6]

Passaggio 3. Nell'editor del modulo, individua e fai clic sulla sezione Link e Pulsanti (a volte denominata Pulsanti Personalizzati). Questa pagina elenca tutti i pulsanti personalizzati creati per quel modulo, insieme al tipo di posizionamento — ad esempio, Pagina di Dettaglio, Menu Azione Collettiva della Pagina Elenco o Elenco Correlato. ^{[1] [6]}

Passaggio 4. Fai clic sul nome di qualsiasi pulsante nell'elenco per aprirne la configurazione. Qui puoi esaminare il nome del pulsante, il posizionamento, la funzione Deluge o il Client Script associato e le eventuali restrizioni a livello di profilo che controllano quali utenti lo visualizzano. ^{[6] [3]}

Passaggio 5. Se hai bisogno di recuperare o ispezionare il Client Script collegato a un pulsante, tieni presente che, sebbene il pulsante stesso venga creato dalla pagina Pulsanti, il suo Client Script può essere visualizzato e modificato separatamente tramite la pagina di configurazione Client Script. Vai su Impostazioni > Spazio Sviluppatore > Client Script per trovare lo script collegato. ^[6]

Passaggio 6. Per i pulsanti utilizzati all'interno dei Portali (Candidato, Cliente, Fornitore o Personalizzato), il percorso di recupero è la stessa pagina Pulsanti, ma devi anche verificare le impostazioni di restrizione del Profilo Portale per capire quali utenti del portale possono vedere ciascun pulsante. ^[3] Queste assegnazioni di profilo sono visibili quando apri la vista di modifica del pulsante.

Passaggio 7. Se stai lavorando in modo programmatico e hai bisogno di richiamare la logica sottostante di un pulsante tramite API, la funzione Deluge del pulsante può chiamare internamente le API di Zoho CRM tramite il livello ZDK CRM APIs, che racchiude gli endpoint REST standard del CRM. ^[6] Esamina il codice della funzione collegata al pulsante per identificare quali endpoint vengono utilizzati.

---

Errori comuni

• Il Client Script non può essere creato dalla pagina di configurazione Client Script per i pulsanti. Deve essere avviato dalla pagina Pulsanti stessa. Dalla pagina di configurazione è possibile solo *modificare* il Client Script di un pulsante esistente — non crearne uno nuovo. ^[6]

• I pulsanti Azione Collettiva della Pagina Elenco potrebbero non popolare automaticamente gli ID dei record selezionati in alcuni moduli personalizzati. Se noti che l'argomento List è vuoto quando si attiva un pulsante di azione collettiva, verifica che il modulo sia configurato correttamente per passare gli ID dei record selezionati alla funzione. Questo è un caso limite noto segnalato nel modulo Pacchetti. ^[1]

• I pulsanti del portale sono soggetti a restrizioni di profilo. Se un pulsante personalizzato risulta mancante per un utente del portale, la causa più probabile è che il pulsante non sia stato assegnato al profilo portale corretto (ad es., Candidato, Cliente o Fornitore). Verifica sempre le assegnazioni di profilo quando recuperi pulsanti destinati all'uso nel portale. ^[3]

• L'ambito del modulo è importante. I pulsanti personalizzati sono specifici per modulo. Un pulsante creato per il modulo Contatti non apparirà nell'elenco del modulo Trattative. Se non riesci a trovare un pulsante, verifica di stare cercando nella pagina Pulsanti del modulo corretto. ^[6]

---

Cosa verificare

• Conferma che il modulo corretto sia selezionato nella pagina Pulsanti — i pulsanti sono limitati al modulo e non appariranno in altri moduli. ^[6]
• Verifica le assegnazioni di profilo e portale se il pulsante è destinato agli utenti del portale, assicurandoti che il profilo portale corretto (Candidato, Cliente, Fornitore o Personalizzato) sia abilitato sul pulsante. ^[3]
• Controlla la pagina di configurazione Client Script per verificare se al pulsante è collegata una logica di scripting aggiuntiva oltre alla funzione Deluge principale, soprattutto se il comportamento del pulsante sembra incompleto. ^[6]

---

*Beam Help è una risorsa di supporto esperto indipendente per i prodotti Zoho e non è il supporto ufficiale Zoho. Testa sempre le modifiche ai pulsanti in un ambiente sandbox prima di distribuirle in produzione.*