Odoo 20.0 Community · Persistant

res.role : champs, relations et API

Le modèle res.role (« Représente un rôle dans le système utilisé pour catégoriser les utilisateurs. Chaque rôle a un nom unique et peut être associé à plusieurs utilisateurs. Les rôles peuvent être mentionnés dans les messages pour notifier tous les utilisateurs associés. ») est un modèle persistant déclaré par le module Discussion. Il expose 10 champs, dont 4 déclarés directement sur le modèle ; 8 champs d'autres modèles pointent vers lui. Retrouvez ci-dessous chaque champ avec son nom technique, son type, son libellé français et ses relations, puis un exemple d'appel à l'API JSON-2 d'Odoo 20.

Voir le code source Rechercher un autre modèle

Fiche d'identité

Nom technique: res.role
Libellé: Représente un rôle dans le système utilisé pour catégoriser les utilisateurs. Chaque rôle a un nom unique et peut être associé à plusieurs utilisateurs. Les rôles peuvent être mentionnés dans les messages pour notifier tous les utilisateurs associés.
Type: Persistant (models.Model)
Table SQL: res_role
Module d'origine: Discussion (mail)

Champs du modèle

4 champs propres, 0 hérités des mixins et 6 champs automatiques de l'ORM. Cliquez sur un nom pour obtenir le lien direct vers le champ.

Masquer les champs hérités

10 champs affichés sur 10

Nom technique	Libellé	Type	Détails
active	Actif	`boolean`
name	Nom	`char`	requis
user_ids	Utilisateurs	`many2many` → res.users
user_ids_count	Nombre d'ids utilisateur	`integer`	calculé
create_date	Créé le	`datetime`	lecture seuleautomatique
create_uid	Créé par	`many2one` → res.users	lecture seuleautomatique
display_name	Nom affiché	`char`	lecture seulecalculéautomatique
id	ID	`integer`	lecture seuleautomatique
write_date	Dernière mise à jour le	`datetime`	lecture seuleautomatique
write_uid	Dernière mise à jour par	`many2one` → res.users	lecture seuleautomatique

Relations

Modèles liés depuis ce modèle

res.users : user_ids

Champs d'autres modèles qui pointent ici

ir.actions.server : activity_role_id
mail.activity : role_id
mail.activity.plan.template : role_id
mail.activity.schedule : activity_role_id, plan_on_demand_role_id
mail.activity.schedule.line : role_id
mail.activity.type : default_role_id
res.users : role_ids

Lire ce modèle par l'API

Exemple d'appel à l'API JSON-2 d'Odoo 20 : lecture des cinq premiers enregistrements avec des champs réels du modèle. Remplacez l'instance, la base et la clé API par les vôtres.

curl

curl -X POST "https://votre-instance.odoo.com/json/2/res.role/search_read" \
  -H "Authorization: bearer $ODOO_API_KEY" \
  -H "X-Odoo-Database: votre-base" \
  -H "Content-Type: application/json" \
  -d '{"domain":[],"fields":["name","active"],"limit":5}'

Python (requests)

import requests

BASE_URL = "https://votre-instance.odoo.com/json/2"
headers = {"Authorization": f"bearer {API_KEY}", "X-Odoo-Database": "votre-base"}

res = requests.post(
    f"{BASE_URL}/res.role/search_read",
    headers=headers,
    json={"domain": [], "fields": ["name","active"], "limit": 5},
)
res.raise_for_status()
print(res.json())

L'accès à l'API externe est réservé à la formule Custom d'Odoo.
XML-RPC et JSON-RPC seront retirés dans Odoo 22 (automne 2028) : préférez JSON-2.
Les droits d'accès et règles d'enregistrement de l'utilisateur de la clé s'appliquent.

Citer cet outil

Vous rédigez un tutoriel, une documentation interne ou une réponse sur un forum ? Copiez ce lien pour renvoyer vos lecteurs vers la fiche à jour.

<a href="https://aidoo.ai/fr/outils/explorateur-modeles-odoo/res-role">res.role (Odoo 20.0)</a>

Sources

Données vérifiées le 25 septembre 2026 · Odoo 20.0 Community

Vous avez un projet Odoo ou souhaitez exploiter votre ERP avec l'IA ? Échangeons

Intégration, développement de modules, connexion de Claude ou ChatGPT à vos données : décrivez-nous votre contexte, nous vous répondons sous 24 heures ouvrées.

Nous contacter Voir une démo