--- title: Créer ou renommer un rôle dans Boss’nX description: "Créer ou renommer un rôle dans Boss’nX. Boss’nX : ouvrir Nouveau rôle depuis liste, renseigner libellé obligatoire." canonical: https://wiki.can-nx.com/guides/boss-role-create/ language: fr product: Boss’nX audience: - administrateur - installateur context: Boss’nX FR/EN, supervision autonome ou ouverte depuis hypervision; Utilisateurs puis Rôles; gestion des rôles, libellé modifiable pour renommage; écran large --- # Créer ou renommer un rôle dans Boss’nX Contexte : Boss’nX FR/EN, supervision autonome ou ouverte depuis hypervision; Utilisateurs puis Rôles; gestion des rôles, libellé modifiable pour renommage; écran large Pour attribuer le rôle préparé, suivez [créer un compte](https://wiki.can-nx.com/guides/boss-users-create/) ou [modifier le rôle d’un compte existant](https://wiki.can-nx.com/guides/boss-users-edit/). Ce guide concerne l’administrateur ou l’installateur autorisé à gérer les rôles. Un rôle réunit les capacités, le périmètre et les règles appliqués aux comptes qui l’utilisent. Sa création ne crée pas de compte utilisateur. ## Ouvrir Nouveau rôle 1. Ouvrez la supervision concernée, puis **Utilisateurs → Rôles**, éventuellement depuis **Plus**. 2. [Consultez les rôles existants](https://wiki.can-nx.com/guides/boss-roles-consult/) pour vérifier si l’un d’eux répond déjà au besoin. 3. Cliquez sur **Nouveau rôle**, en haut de la liste. 4. Dans **Libellé**, saisissez un nom compréhensible, par exemple « Accueil du bâtiment » dans un exemple fictif. Un libellé vide ou constitué seulement d’espaces est refusé avec **Le libellé est requis**. Le formulaire commence dans **Capacités**. Les capacités sont initialement désactivées, tandis que le périmètre de **Composants & Bâtiment** couvre initialement tous les composants. Aucune règle de points ni de notification n’est encore définie. Vérifiez ces sections avant de créer le rôle. ## Préparer les droits dans les quatre sections | Section | Choix à préparer | | --- | --- | | **Capacités** | Activez les actions utiles et vérifiez les capacités associées automatiquement. Voir [les capacités et le périmètre des journaux](https://wiki.can-nx.com/guides/boss-role-capabilities/), ainsi que [les types de widgets autorisés](https://wiki.can-nx.com/guides/boss-role-widgets/). | | **Composants & Bâtiment** | Vérifiez le périmètre initial. Pour le limiter, utilisez **Restreindre l’accès**, puis définissez les [règles permanentes](https://wiki.can-nx.com/guides/boss-role-scope-rules/) et les [exceptions](https://wiki.can-nx.com/guides/boss-role-scope-overrides/) nécessaires. | | **Règles de datapoints** | Si nécessaire, choisissez les points à masquer ou à rendre en lecture seule par [règles de tag](https://wiki.can-nx.com/guides/boss-role-datapoint-tags/), et préparez les [restrictions « Afficher seulement »](https://wiki.can-nx.com/guides/boss-role-show-only/). | | **Notifications** | Définissez les [règles de notification](https://wiki.can-nx.com/guides/boss-role-notifications/) nécessaires pour ce rôle. | Passer d’une section à l’autre conserve la saisie. Les changements ne sont enregistrés qu’avec **Enregistrer** dans la barre inférieure du rôle. Si une fenêtre ou une carte propose sa propre validation, validez-la d’abord pour intégrer ses choix au brouillon du rôle. ## Créer le rôle et vérifier le résultat 1. Relisez le libellé, les capacités, le périmètre, les règles de points et les notifications. 2. Cliquez sur **Enregistrer** dans la barre inférieure. 3. Attendez la fin de l’enregistrement avant de continuer à modifier le formulaire. 4. Vérifiez **Rôle créé** et le retour à la liste **Rôles**. 5. Retrouvez la nouvelle ligne, puis ouvrez **Modifier** pour relire les réglages conservés. Les espaces placés au début et à la fin du libellé sont retirés à la sauvegarde. Le rôle doit ensuite être attribué aux comptes concernés par une personne autorisée à gérer les utilisateurs. Avant son utilisation, vérifiez les accès attendus et ceux qui doivent rester absents avec un compte concerné dans une nouvelle session. ## Renommer un rôle existant 1. Dans **Rôles**, repérez le rôle et vérifiez ses comptes associés. 2. Cliquez sur **Modifier** à sa ligne. 3. Si **Libellé** est modifiable, remplacez son contenu par le nom voulu. 4. Relisez les autres sections si vous les avez également modifiées, puis cliquez sur **Enregistrer**. 5. Attendez **Rôle mis à jour** et vérifiez le nouveau libellé dans la liste. Changer uniquement le libellé conserve les réglages du rôle. Si le champ est en lecture seule, lisez le bandeau et faites vérifier le rôle à utiliser par l’administrateur. Ne recréez pas un rôle uniquement pour contourner un champ indisponible ; si le résultat reste inattendu après vérification des droits et du contexte, contactez support@can-nx.com. ## Annuler ou reprendre un brouillon **Annuler les modifications** restaure toutes les sections à l’état chargé, sans quitter l’éditeur. Pour une création, le libellé redevient vide et les réglages initiaux sont rétablis. Pour un rôle existant, ses valeurs chargées sont restaurées. Avec des changements non enregistrés, **Retour aux rôles** ouvre **Abandonner les modifications non enregistrées ?**. Refuser conserve le brouillon ; confirmer quitte l’éditeur en abandonnant ces changements. Fermer ou recharger l’onglet peut aussi déclencher l’avertissement du navigateur. ## Si l’enregistrement ne se termine pas comme prévu - **Enregistrer** absent : vérifiez qu’une valeur a été modifiée et que le rôle est modifiable. - **Le libellé est requis** : renseignez un nom, puis recommencez la validation. - **Enregistrer** indisponible : attendez une opération en cours, ou vérifiez l’avertissement de **Règles de datapoints**. Le mode **Masquer tout composant non listé** demande au moins une restriction. - Message de refus ou de sauvegarde interrompue : relevez le message et vérifiez dans la liste si le rôle ou son nouveau libellé a été enregistré avant de renouveler l’opération. Si le résultat demeure incertain, contactez support@can-nx.com en précisant la supervision, le libellé du rôle, le message affiché et les vérifications effectuées, sans transmettre de secret d’accès. En anglais : **Users → Roles → New role**, **Label**, **Capabilities**, **Components & Building**, **Datapoint rules**, **Notifications**, **Save**, **Role created**, **Edit**, **Role updated**, **Discard**, **Back to roles**, **Discard your unsaved changes?**, **Label is required**.