---
sourceDocument: Yokohama Créer ou modifier des applications
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/yokohama/application-development

 Release :

    - yokohama

ft:locale :

    - fr-FR

ft:publication_title :

    - Yokohama Créer ou modifier des applications

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Creator


---

API du rôle : ServiceNow Fluent
===============================

API du rôle : ServiceNow Fluent {#ariaid-title1}
================================================

* Rversion finale: Yokohama
* 
* Mis à jour 30 janv. 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 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 {#ariaid-title2}
------------------------------

Créez un rôle \[sys_user_role\] pour contrôler l'accès aux applications et à leurs fonctionnalités.
{#role-object-now-ts__table_vy2_525_jq__entry__3}

|        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 : <kbd class="ph userinput">&lt;périmètre&gt;.&lt;nom&gt;</kbd>.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 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](https://www.servicenow.com/docs/access?context=c_DelegateRoles&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). 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. {#role-object-now-ts__ul_fjr_cc5_pbc} 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](https://www.servicenow.com/docs/access?context=c_ElevatedPrivilege&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US). 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. {#role-object-now-ts__ul_ukv_qd5_pbc} 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. {#role-object-now-ts__ul_gb2_zd5_pbc} 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](https://servicenow-prod.fluidtopics.net/KOXQN_nAO_XjPuw38oQbDw "Protégez les données d’application sensibles en utilisant l’administration d’application pour restreindre la façon dont les utilisateurs acquièrent des rôles spécifiques aux applications."). Valeurs valides : * vrai : le rôle est un administrateur d'application. * false : le rôle n'est pas un administrateur d'application. {#role-object-now-ts__ul_nxt_325_pbc} Valeur par défaut : false                                                                                                  |
[Tableau 1. Propriétés]

{#role-object-now-ts__table_vy2_525_jq}  

    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] 
    })