API de função - ServiceNow Fluent

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura

    • A API de função define funções [sys_user_role] que concedem permissões específicas aos usuários de uma aplicação.

    Para obter informações gerais sobre funções de usuário, consulte Managing roles.

    Objeto de função

    Crie uma função [sys_user_role] para controlar o acesso a aplicações e seus recursos.

    Tabela 1. Propriedades
    Nome Tipo Descrição
    nome Cadeia de caracteres Um nome para a função que começa com o escopo da aplicação no seguinte formato: <scope>.<name> .
    Atribuído por Cadeia de caracteres Outras funções que podem atribuir esta função aos 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.
    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.

    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 .
    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.

    Padrão: falso
    concedente Booliano Sinalizador que indica se a função pode ser concedida independentemente.
    Valores válidos:
    • Verdadeiro: A função pode ser concedida independentemente.
    • Falso: A função não pode ser concedida independentemente.

    Padrão: verdadeiro
    ContêsRoles Matriz Os identificadores de variáveis de outro Função objetos que esta função contém.
    ScopedAdmin 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 da aplicação.
    Valores válidos:
    • Verdadeiro: A função é um administrador de aplicações.
    • Falso: A função não é um administrador de aplicações.

    Padrão: falso
    meta Objeto Metadados dos metadados da aplicação.
    Com o. Método de instalação , você pode mapear os metadados da aplicação para um diretório de saída que carrega somente em circunstâncias específicas.
    $meta: {
      installMethod: 'String'
}
    Valores válidos para Método de instalação :
    • Demonstração: Gera os metadados da aplicação para o. metadados/unload.demo diretório a ser instalado com a aplicação quando Carregar dados de demonstração a opção está selecionada.
    • Primeira instalação: Gera os metadados da aplicação para o. metadados/descarregamento diretório a ser instalado somente na primeira vez que uma aplicação for instalada em uma instância.
    		 
    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] 
})