Récupérer une règle de partage de données spécifique dans Zoho CRM est simple dès lors que vous connaissez le bon endpoint API et que vous savez naviguer dans l'interface des paramètres de partage de données mise à jour.
Pourquoi c'est important
Les règles de partage de données contrôlent quels utilisateurs, rôles et groupes peuvent accéder aux enregistrements CRM au sein de votre organisation. Lorsque vous devez auditer, mettre à jour ou résoudre un problème lié à une règle particulière, pouvoir en extraire rapidement les détails — que ce soit via l'interface ou par programmation — représente un gain de temps considérable. Cela est particulièrement pertinent depuis la mise à jour Q1 2025 de Zoho CRM, qui a remanié la section des paramètres de partage de données avec une nouvelle navigation et de nouveaux outils de filtrage. [1]
---
Étape par étape
Étape 1. Connectez-vous à votre compte Zoho CRM et accédez à Configuration. Depuis là, rendez-vous dans Contrôle de sécurité et ouvrez Paramètres de partage de données. L'interface actualisée présente désormais deux onglets dédiés : l'un pour les autorisations par défaut de l'organisation et l'autre pour les règles de partage. [1]
Étape 2. Cliquez sur l'onglet Règles de partage pour afficher la liste complète, organisée par module, de toutes les règles configurées dans votre organisation. Cette vue détaillée est conçue pour une consultation rapide et facilite la localisation de la règle recherchée. [1]
Étape 3. Pour localiser une règle spécifique sans faire défiler la liste, utilisez la barre de recherche en haut de la liste. Vous pouvez également appliquer des Filtres avancés pour affiner les résultats par module ou selon d'autres critères. Cette fonctionnalité de filtrage a été introduite dans le cadre de la mise à jour Q1 2025. [1]
Étape 4. Une fois la règle repérée dans la liste, cliquez dessus pour ouvrir sa vue détaillée. Vous pouvez y consulter ses conditions, les rôles ou groupes auxquels elle s'applique, ainsi que son statut actif/inactif actuel. [1]
---
Récupérer une règle via l'API
Si vous avez besoin de récupérer une règle spécifique par programmation — par exemple pour intégrer les détails d'une règle dans un outil d'audit externe ou une automatisation — Zoho CRM expose un endpoint REST dédié.
Étape 5. Effectuez une requête GET vers l'endpoint suivant, en remplaçant {rule_id} par l'identifiant unique de la règle que vous souhaitez récupérer : [8]
GET /settings/data_sharing_rules/{rule_id}
Étape 6. En Python, l'appel se présente comme suit — passez le rule_id en tant qu'argument de type chaîne à votre wrapper client CRM : [8]
def get_data_sharing_rule(self, rule_id: str):
return self.c.request("GET", f"/settings/data_sharing_rules/{rule_id}")
La réponse contiendra la configuration complète de cette règle de partage individuelle. [8]
---
Erreurs courantes
- Identifiant de règle incorrect. Si vous fournissez un
rule_iderroné ou obsolète, l'API retournera une erreur plutôt qu'un objet de règle. Confirmez toujours l'identifiant en listant d'abord toutes les règles ou en vérifiant dans l'interface avant d'effectuer l'appel GET ciblé. [8] - Manque de permissions. Seuls les administrateurs CRM ont accès aux Paramètres de partage de données. Si vous ne voyez pas le menu Contrôle de sécurité, votre profil ne dispose probablement pas des privilèges administratifs requis. [1]
- Confusion entre les onglets. L'interface mise à jour sépare les Autorisations par défaut de l'organisation des Règles de partage en deux onglets distincts. Assurez-vous d'être sur l'onglet Règles de partage — et non sur l'onglet des autorisations par défaut — lorsque vous recherchez une règle spécifique. [1]
---
Points à vérifier
- Confirmez que la règle est active. Après avoir localisé la règle, vérifiez que son bouton activer/désactiver reflète l'état souhaité — la fonctionnalité d'activation en un clic facilite les modifications accidentelles. [1]
- Validez le rule_id utilisé dans les appels API. Comparez l'identifiant retourné par l'API avec ce que vous voyez dans l'interface pour vous assurer d'inspecter la bonne règle. [8]
- Vérifiez la portée du module. Confirmez que la règle est associée au module CRM attendu, car les règles sont organisées par module et une règle portant un nom similaire peut exister pour un module différent. [1]
---
*Beam Help est une ressource d'assistance experte indépendante pour les produits Zoho et ne constitue pas le support officiel de Zoho. Pour les problèmes au niveau de la plateforme, soumettez toujours un ticket directement auprès de Zoho.*