Documentation ERPNext

ERPNext

Niveaux de permission

Chaque champ a un niveau de permission, 0 par défaut. Un niveau plus élevé exige une ligne de droit du même niveau, sinon le champ peut être masqué ou en lecture seule.

3 min de lectureMis à jour le Source : docs.frappe.io

À quoi servent les niveaux

Le niveau de permission (Perm Level) est un contrôle au champ, dans ERPNext et Frappe. Il permet de limiter l'accès à des champs sensibles d'un DocType sans masquer ni interdire tout le document.

Chaque champ a un niveau de permission. Par défaut, c'est 0, gouverné par les permissions ordinaires du DocType. Si le champ passe à 1 ou 2, l'utilisateur a besoin d'une ligne de permission de ce niveau dans le gestionnaire de permissions de rôle. Sans cette ligne, il peut encore ouvrir le document, mais le champ de niveau supérieur peut être masqué ou en lecture seule, selon les droits configurés.

Ils évitent de créer un DocType ou un circuit à part pour protéger quelques champs. Exemples de la source : un commercial crée un devis, seul un responsable modifie l'accord de remise ; un utilisateur RH voit l'employé, le salaire reste aux rôles de paie ; une facture fournisseur est visible, les champs banque ou taxe restent aux responsables comptables ; un agent de support met à jour le ticket, les notes d'escalade internes restent aux utilisateurs seniors.

Comment ça s'applique

  1. Le champ reçoit un niveau dans le DocType ou dans Personnaliser le formulaire.
  2. Le gestionnaire de permissions de rôle définit ce que chaque rôle peut faire à chaque niveau.
  3. À l'ouverture, ERPNext confronte les rôles de l'utilisateur et le niveau de chaque champ.
  4. Si le droit existe pour ce niveau, le champ suit les actions autorisées, lecture ou écriture.
  5. Sinon, le champ est restreint même si le document lui-même est accessible.

Exemple sur une commande client

ChampNiveau
Client, articles, date de livraison0
Remise approuvée1
Remarques de direction2

L'utilisateur des ventes, autorisé seulement au niveau 0, travaille les champs ordinaires. Le responsable des ventes, au niveau 1, lit ou met à jour la remise approuvée. Le directeur des ventes, au niveau 2, accède aussi aux remarques de direction.

Dans le gestionnaire, chaque ligne de permission a une valeur Niveau, qui doit égaler le niveau du champ. Une ligne de niveau 1 peut alors autoriser lecture, écriture, création, validation, annulation ou amendement, selon le DocType et le besoin.

Points d'attention

  • Laissez la plupart des champs au niveau 0.
  • Ne montez le niveau que pour un champ qui a vraiment besoin d'un contrôle supplémentaire.
  • Des libellés clairs aident à retrouver les champs restreints pendant le paramétrage.
  • Testez avec un utilisateur qui n'est pas administrateur.
  • Évitez trop de niveaux : les règles deviennent difficiles à auditer.
  • Notez pourquoi un champ a reçu un niveau plus élevé.

Erreurs fréquentes citées par la source : champ au niveau 1 sans règle de niveau 1, ce qui retire l'accès au champ sans qu'on s'y attende ; croire que l'accès au document vaut accès au champ ; utiliser les niveaux à la place d'un circuit d'approbation, alors qu'ils ne gouvernent que l'accès au champ ; ne tester qu'en administrateur, ce qui masque les problèmes de permission.

Pages liées