API du rôle : ServiceNow Fluent

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 1 minute de lecture
  • L’API de rôle inclut des objets qui définissent les rôles [sys_user_role] des utilisateurs d’une application.

    Objet de rôle

    Créez un rôle [sys_user_role] pour contrôler l’accès aux applications et à leurs fonctionnalités.

    Tableau 1. Propriétés
    Nom Type Description
    $id Chaîne ou numéro Requis. ID unique pour l’objet de métadonnées fourni au format suivant, où < valeur > est une chaîne ou un numéro.
    $id: Now.ID[<value>]

    Lorsque vous créez l’application, cet ID est haché en une sys_ID unique.

    nom Chaîne Nom du rôle commençant par le périmètre de l’application au format suivant : <périmètre>.<nom>.
    assignable_by Chaîne Autres rôles pouvant affecter ce rôle aux utilisateurs.
    can_delegate Booléen Marqueur indiquant si le rôle peut être délégué à d’autres utilisateurs. Pour plus d'informations, consultez Delegating roles.
    Valeurs valides :
    • vrai : le rôle peut être délégué à d’autres utilisateurs.
    • faux : le rôle ne peut pas être délégué à d’autres utilisateurs.

    Par défaut : true

    description Chaîne Description à quoi le rôle peut accéder.
    elevated_privilege Booléen Marqueur indiquant s’il est nécessaire d’accepter manuellement la responsabilité d’utiliser le rôle avant de pouvoir accéder aux fonctionnalités du rôle. Pour plus d’informations sur les privilèges élevés, voir Rôles à privilèges élevés.
    Valeurs valides :
    • true : vous devez accepter manuellement la responsabilité de l’utilisation du rôle avant de pouvoir accéder à ses fonctionnalités.
    • false : vous n’avez pas besoin d’accepter manuellement la responsabilité de l’utilisation du rôle pour accéder à ses fonctionnalités.

    Valeur par défaut : false

    Octroi possible Booléen Marqueur indiquant si le rôle peut être accordé indépendamment.
    Valeurs valides :
    • vrai : le rôle peut être accordé indépendamment.
    • faux : le rôle ne peut pas être accordé indépendamment.

    Par défaut : true

    contains_roles Tableau Les identificateurs de variables des autres objets de rôle que ce rôle contient.
    scoped_admin Booléen Marqueur indiquant si le rôle est un rôle d’administrateur d’application. Pour obtenir des informations générales sur les rôles d’administration d’application, reportez-vous à la section Administration d'application.
    Valeurs valides :
    • vrai : le rôle est un administrateur d’application.
    • false : le rôle n’est pas un administrateur d’application.

    Valeur par défaut : false

    import { Role } from "@servicenow/sdk/core";
    
    const managerRole = Role({ 
       $id: Now.ID['manager_role'], 
       name: 'x_snc_example.manager' 
    })
    
    const adminRole = Role({ 
       $id: Now.ID['admin_role'], 
       name: 'x_snc_example.admin', 
       contains_roles: [managerRole] 
    })