---
sourceDocument: Criar ou modificar aplicações do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/application-development

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Criar ou modificar aplicações do Xanadu

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Creator


---

# API de função - ServiceNow Fluent

# API de função - ServiceNow Fluent {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

A API Role inclui objetos que definem funções \[sys_user_role\] para usuários de uma aplicação.

## Objeto de função {#ariaid-title2}

Crie uma função \[sys_user_role\] para controlar o acesso a aplicações e seus recursos.
{#role-object-now-ts__table_vy2_525_jq__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| $id | Cadeia de caracteres ou número | Obrigatório. Um ID exclusivo para o objeto de metadados fornecido no seguinte formato, em que\<value\> é uma cadeia de caracteres ou um número. $id: Now.ID[<value>] Quando você cria a aplicação, esse ID é convertido em um sys_ID exclusivo. |
| nome | Cadeia de caracteres | Um nome para a função que começa com o escopo da aplicação no seguinte formato:\<scope\> <kbd class="ph userinput">.</kbd>\<name\> . |
| atribuível_por | Cadeia de caracteres | Outras funções que podem atribuir esta função a usuários. |
| pode_delegar | Booliano | Sinalizador que indica se a função pode ser delegada a outros usuários. Para obter mais informações, consulte [Delegating roles](https://www.servicenow.com/docs/access?context=c_DelegateRoles&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Valores válidos: * verdadeiro: a função pode ser delegada a outros usuários. * falso: a função não pode ser delegada a outros usuários. {#role-object-now-ts__ul_fjr_cc5_pbc} Padrão: verdadeiro |
| descrição | Cadeia de caracteres | Uma descrição do que a função pode acessar. |
| privilégio_elevado | Booliano | Sinalizador que indica se é necessário aceitar manualmente a responsabilidade de usar a função antes de acessar os recursos da função. Para obter mais informações sobre privilégios elevados, consulte [Funções de privilégio elevado](https://www.servicenow.com/docs/access?context=c_ElevatedPrivilege&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US). Valores válidos: * verdadeiro: você deve aceitar manualmente a responsabilidade de usar a função antes de acessar seus recursos. * falso: você não precisa aceitar manualmente a responsabilidade de usar a função para acessar seus recursos. {#role-object-now-ts__ul_ukv_qd5_pbc} Padrão: falso |
| concedível | Booliano | Sinalizador que indica se a função pode ser concedida de forma independente. Valores válidos: * verdadeiro: a função pode ser concedida de forma independente. * falso: a função não pode ser concedida de forma independente. {#role-object-now-ts__ul_gb2_zd5_pbc} Padrão: verdadeiro |
| contém_funções | Matriz | Os identificadores de variáveis de outros objetos Role que esta função contém. |
| scoped_admin | Booliano | Sinalizador que indica se a função é uma função de Administrador de aplicações. Para obter informações gerais sobre funções de administração de aplicações, consulte [Administração de aplicação](https://servicenow-prod.fluidtopics.net/1mRSRkFf6epg7609yqh2tg "Proteja dados de aplicações confidenciais usando a administração de aplicações para restringir como os usuários adquirem funções específicas da aplicação."). Valores válidos: * true: a função é um administrador de aplicações. * falso: a função não é um administrador de aplicações. {#role-object-now-ts__ul_nxt_325_pbc} Padrão: falso |
[Tabela 1. Propriedades]

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