Come recuperare un utente specifico del portale in Zoho CRM

Recuperare un utente specifico del portale in Zoho CRM è più affidabile tramite l'oggetto $Crm.user disponibile negli Script Client, che espone i dettagli completi dell'identità e del ruolo di chi è attualmente connesso al portale.

Perché è importante

Quando crei un Portale Zoho CRM per clienti o partner, spesso hai bisogno di personalizzare l'esperienza — mostrando solo i record rilevanti, applicando regole a livello di campo o logica di ramificazione in base a chi sta visualizzando la pagina. Sapere come recuperare programmaticamente i dettagli dell'utente del portale attuale ti consente di adattare gli Script Client ai singoli utenti o a interi tipi di utenti senza duplicare il codice. Questo è particolarmente utile nelle soluzioni verticali dove diversi profili di portale necessitano di comportamenti diversi. ^[1]

Procedura passo dopo passo

Passaggio 1. Conferma che il supporto degli Script Client per i Portali sia abilitato nella tua organizzazione Zoho CRM. Questa funzione è stata implementata in tutti i data center, quindi dovrebbe essere disponibile per impostazione predefinita — ma verifica che sia attiva nelle impostazioni dello sviluppatore o del portale prima di scrivere qualsiasi script. ^[1]

Passaggio 2. Apri l'editor degli Script Client per il tuo portale. Poiché gli Script Client esistenti si estendono automaticamente nei portali, non è necessario creare un nuovo script da zero. Qualsiasi script che hai già scritto funzionerà nel contesto del portale senza riscrittura o duplicazione. ^[1]

Passaggio 3. All'interno del tuo Script Client, chiama $Crm.user per recuperare i dettagli dell'utente attualmente autenticato. Questo singolo oggetto restituisce tutti i campi di identità di cui hai bisogno per la logica condizionale. ^[1]

Passaggio 4. Ispeziona il campo type restituito da $Crm.user per distinguere tra un utente CRM regolare e un utente del portale. Un utente interno standard restituisce "type": "Regular User", mentre un account del portale rivolto ai clienti restituisce "type": "Client Portal User". ^[1]

Passaggio 5. Utilizza i campi rimanenti dalla risposta di $Crm.user per identificare l'individuo specifico. L'oggetto include:

• id — l'ID record CRM univoco per l'utente
• zuid — l'ID utente Zoho associato al loro account Zoho
• fullname, firstname, last_name — campi del nome visualizzato
• email — l'indirizzo email registrato dell'utente
• profile.id e profile.name — il profilo del portale assegnato (ad es. "ClientPortal")
• role.id e role.name — il ruolo assegnato all'interno del portale (ad es. "Portal User") ^[1]

Passaggio 6. Per indirizzare un *utente specifico* del portale nella logica dello script, confronta il valore id, email o zuid da $Crm.user con un valore noto. Ad esempio, puoi ramificare lo script in modo che determinate convalide di campo o modifiche dell'interfaccia utente si applichino solo quando $Crm.user.email corrisponde a un indirizzo particolare. ^[1]

Passaggio 7. Per indirizzare un *tipo di utente* intero piuttosto che un singolo individuo, controlla $Crm.user.type. Quando il valore è uguale a "Client Portal User", sai che il visualizzatore è un partecipante del portale piuttosto che un membro del team interno, e puoi applicare personalizzazioni a livello di portale di conseguenza. ^[1]

Passaggio 8. Se hai bisogno di gestire gli utenti del portale al di fuori degli script — ad esempio, per attivare, disattivare o rimuovere un utente — vai a Portali Personalizzati, apri il portale pertinente, vai alla scheda Utenti, individua l'indirizzo email dell'utente e fai clic sull'icona Altre Opzioni per scegliere l'azione appropriata. ^[7]

Errori comuni

• Confondere id con zuid: Il campo id è l'identificatore del record interno di CRM, mentre zuid è l'identificatore dell'account Zoho tra i prodotti. Usa id quando interroghi i record CRM e zuid quando hai bisogno di correlare tra i servizi Zoho. ^[1]
• Presumere che tutti gli utenti siano utenti del portale: Se il tuo script viene eseguito sia nell'interfaccia CRM standard che nel portale, controlla sempre $Crm.user.type prima di applicare la logica specifica del portale. Applicare regole del portale a un "Regular User" può causare comportamenti inaspettati. ^[1]
• Confusione tra profilo e ruolo: L'oggetto profile riflette il profilo del portale (controllando quali moduli sono visibili), mentre role riflette la posizione dell'utente nella gerarchia del portale. Questi sono concetti separati — non usarli in modo intercambiabile quando scrivi logica condizionale. ^[1]
• Inviti vs. utenti attivi: Un utente che è stato invitato ma non ha ancora accettato non apparirà nella scheda Utenti attiva. Controlla la scheda Inviti se un utente che ti aspetti di trovare manca dall'elenco. ^[7]

Cosa verificare

• Verifica che $Crm.user.type restituisca "Client Portal User" quando visualizzi in anteprima il portale come account di portale di prova, confermando che lo script viene eseguito nel contesto corretto. ^[1]
• Conferma che i valori profile.name e role.name corrispondano al profilo del portale e al ruolo che hai configurato per quell'utente nelle impostazioni del portale. ^[1]
• Dopo qualsiasi azione di gestione degli utenti (attiva, disattiva, rimuovi), torna alla scheda Utenti nella sezione Portali Personalizzati per confermare che la modifica sia riflessa nell'elenco degli utenti. ^[7]

---

*Beam Help è una risorsa di supporto esperto indipendente per i prodotti Zoho e non è il supporto ufficiale Zoho. Testa sempre le modifiche degli Script Client in un ambiente sandbox o di sviluppo prima di distribuire in produzione.*