Comment récupérer un utilisateur de portail spécifique dans Zoho CRM

La récupération d'un utilisateur de portail spécifique dans Zoho CRM s'effectue de manière la plus fiable via l'objet $Crm.user disponible dans les Client Scripts, qui expose l'identité complète et les détails de rôle de la personne actuellement connectée au portail.

Pourquoi cela importe

Lorsque vous créez un portail Zoho CRM pour les clients ou les partenaires, vous devez souvent personnaliser l'expérience — afficher uniquement les enregistrements pertinents, appliquer des règles au niveau des champs, ou brancher la logique en fonction de qui consulte la page. Savoir comment récupérer par programmation les détails de l'utilisateur du portail actuel vous permet d'adapter les Client Scripts à des utilisateurs individuels ou à des types d'utilisateurs entiers sans dupliquer le code. Ceci est particulièrement utile dans les solutions verticales où différents profils de portail nécessitent des comportements différents. ^[1]

Étape par étape

Étape 1. Confirmez que la prise en charge des Client Scripts pour les portails est activée dans votre organisation Zoho CRM. Cette fonctionnalité a été déployée dans tous les centres de données, elle devrait donc être disponible par défaut — mais vérifiez qu'elle est active dans vos paramètres de développeur ou de portail avant d'écrire un script. ^[1]

Étape 2. Ouvrez l'éditeur de Client Script pour votre portail. Comme les Client Scripts existants s'étendent automatiquement aux portails, vous n'avez pas besoin de créer un nouveau script à partir de zéro. Tout script que vous avez déjà écrit fonctionnera dans le contexte du portail sans réécriture ni duplication. ^[1]

Étape 3. Dans votre Client Script, appelez $Crm.user pour récupérer les détails de l'utilisateur actuellement authentifié. Cet objet unique retourne tous les champs d'identité dont vous avez besoin pour la logique conditionnelle. ^[1]

Étape 4. Inspectez le champ type retourné par $Crm.user pour distinguer un utilisateur CRM régulier d'un utilisateur de portail. Un utilisateur interne standard retourne "type": "Regular User", tandis qu'un compte de portail orienté client retourne "type": "Client Portal User". ^[1]

Étape 5. Utilisez les champs restants de la réponse $Crm.user pour identifier l'individu spécifique. L'objet inclut :

• id — l'ID d'enregistrement CRM unique pour l'utilisateur
• zuid — l'ID utilisateur Zoho lié à son compte Zoho
• fullname, firstname, last_name — champs de nom d'affichage
• email — l'adresse e-mail enregistrée de l'utilisateur
• profile.id et profile.name — le profil de portail assigné (par exemple, "ClientPortal")
• role.id et role.name — le rôle assigné dans le portail (par exemple, "Portal User") ^[1]

Étape 6. Pour cibler un *utilisateur de portail spécifique* dans votre logique de script, comparez la valeur id, email, ou zuid de $Crm.user avec une valeur connue. Par exemple, vous pouvez brancher votre script de sorte que certaines validations de champs ou modifications d'interface utilisateur s'appliquent uniquement lorsque $Crm.user.email correspond à une adresse particulière. ^[1]

Étape 7. Pour cibler un *type d'utilisateur entier* plutôt qu'un seul individu, vérifiez $Crm.user.type. Lorsque la valeur est égale à "Client Portal User", vous savez que le spectateur est un participant du portail plutôt qu'un membre de l'équipe interne, et vous pouvez appliquer les personnalisations à l'échelle du portail en conséquence. ^[1]

Étape 8. Si vous devez gérer les utilisateurs du portail en dehors des scripts — par exemple, pour activer, désactiver ou supprimer un utilisateur — accédez à Custom Portals, ouvrez le portail pertinent, allez à l'onglet Users, localisez l'adresse e-mail de l'utilisateur, et cliquez sur l'icône More Options pour choisir l'action appropriée. ^[7]

Pièges courants

• Confondre id avec zuid : Le champ id est l'identifiant d'enregistrement interne CRM, tandis que zuid est l'identifiant de compte Zoho inter-produits. Utilisez id lors de l'interrogation des enregistrements CRM et zuid lorsque vous devez corréler entre les services Zoho. ^[1]
• Supposer que tous les utilisateurs sont des utilisateurs de portail : Si votre script s'exécute à la fois dans l'interface CRM standard et dans le portail, vérifiez toujours $Crm.user.type avant d'appliquer la logique spécifique au portail. L'application de règles de portail à un "Regular User" peut causer un comportement inattendu. ^[1]
• Confusion profil vs. rôle : L'objet profile reflète le profil de portail (contrôlant quels modules sont visibles), tandis que role reflète la position de l'utilisateur dans la hiérarchie du portail. Ce sont des concepts distincts — ne les utilisez pas de manière interchangeable lors de l'écriture de logique conditionnelle. ^[1]
• Invitations vs. utilisateurs actifs : Un utilisateur qui a été invité mais n'a pas encore accepté n'apparaîtra pas dans l'onglet Users actif. Vérifiez l'onglet Invitations si un utilisateur que vous vous attendez à trouver manque de la liste. ^[7]

Ce qu'il faut vérifier

• Vérifiez que $Crm.user.type retourne "Client Portal User" lorsque vous prévisualisez le portail en tant que compte de portail de test, confirmant que le script s'exécute dans le contexte correct. ^[1]
• Confirmez que les valeurs profile.name et role.name correspondent au profil de portail et au rôle que vous avez configurés pour cet utilisateur dans les paramètres du portail. ^[1]
• Après toute action de gestion d'utilisateur (activer, désactiver, supprimer), retournez à l'onglet Users dans la section Custom Portals pour confirmer que la modification est reflétée dans la liste des utilisateurs. ^[7]

---

*Beam Help est une ressource d'assistance expert indépendante pour les produits Zoho et n'est pas le support officiel de Zoho. Testez toujours les modifications de Client Script dans un environnement sandbox ou de développement avant de déployer en production.*