API de rôle : ServiceNow Fluent

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 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 nombre.
    $id: Now.ID[<value>]

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

    nom Chaîne Nom pour le rôle commençant par le périmètre de l’application au format suivant : <scope>.<name>.
    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 :
    • true : le rôle peut être délégué à d’autres utilisateurs.
    • false : le rôle ne peut pas être délégué à d’autres utilisateurs.

    Valeur par défaut : true

    description Chaîne Description de ce à 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, consultez Rôles de privilèges élevés.
    Valeurs valides :
    • true : vous devez accepter manuellement la responsabilité d’utiliser le rôle avant de pouvoir accéder à ses fonctionnalités.
    • false : vous n’avez pas besoin d’accepter manuellement la responsabilité d’utiliser le rôle pour accéder à ses fonctionnalités.

    Valeur par défaut : false

    Pouvant être accordé Booléen Marqueur indiquant si le rôle peut être accordé indépendamment.
    Valeurs valides :
    • true : le rôle peut être accordé indépendamment.
    • false : le rôle ne peut pas être accordé indépendamment.

    Valeur 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 en savoir plus sur les rôles d’administration d’application, reportez-vous à Administration d'application.
    Valeurs valides :
    • true : le rôle est administrateur d’application.
    • false : le rôle n’est pas 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] 
    })