API du rôle : ServiceNow Fluent

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 2 minutes de lecture

    • L’API de rôle définit les rôles [sys_user_role] qui accordent des autorisations spécifiques aux utilisateurs d’une application.

    Pour des informations générales sur les rôles d’utilisateur, reportez-vous à la section Managing roles.

    Objet du 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
    nom Chaîne Nom du rôle commençant par le périmètre de l’application au format suivant : <périmètre>.<nom>.
    assignableBy Chaîne Autres rôles pouvant affecter ce rôle à des utilisateurs.
    canDelegate 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 à laquelle le rôle peut accéder.
    elevatedPrivilege Booléen Marqueur indiquant s’il est nécessaire d’accepter manuellement la responsabilité de l’utilisation du 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 de privilège élevé.
    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é d’utiliser le rôle pour accéder à ses fonctionnalités.

    Valeur par défaut : false
    Accordable 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.

    Par défaut : true
    containsRoles Tableau Les identificateurs de variables des autres objets de rôle que ce rôle contient.
    scopedAdmin 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 à 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
    $meta Objet Métadonnées pour les métadonnées de l’application.
    Avec la propriété installMethod , vous pouvez mapper les métadonnées d’application à un répertoire de sortie qui ne se charge que dans des circonstances spécifiques.
    $meta: {
      installMethod: 'String'
}
    Valeurs valides pour installMethod :
    • demo : génère les métadonnées de l’application dans le répertoire metadata/unload.demo à installer avec l’application lorsque l’option Charger les données de démonstration est sélectionnée.
    • première installation : génère les métadonnées de l’application dans le répertoire metadata/unload à installer uniquement la première fois qu’une application est installée sur une instance.
    		 
    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', 
   containsRoles: [managerRole] 
})