GlideUser - com escopo

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 3 min. de leitura
  • A API GlideUser fornece métodos para acessar informações sobre o usuário atual e as funções do usuário atual.

    O uso da API GlideUser evita a necessidade de usar as consultas GlideRecord mais lentas para obter informações do usuário.

    GlideUser com escopo - getCompanyID()

    Retorna o sys_id da empresa do usuário atual.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 2. Retorna
    Tipo Descrição
    Cadeia de caracteres sys_id da empresa.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getCompanyID());

    GlideUser com escopo - getDisplayName()

    Retorna o nome de exibição do usuário atual.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 4. Retorna
    Tipo Descrição
    Cadeia de caracteres Nome de exibição do usuário
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getDisplayName());

    GlideUser com escopo - getEmail()

    Retorna o endereço de e-mail do usuário.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 6. Retorna
    Tipo Descrição
    Cadeia de caracteres Endereço de e-mail do usuário.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getEmail());

    GlideUser com escopo - getFirstName()

    Retorna o nome do usuário.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 8. Retorna
    Tipo Descrição
    Cadeia de caracteres Nome do usuário.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getFirstName());

    GlideUser com escopo - getID()

    Obtém o sys_id do usuário atual.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 10. Retorna
    Tipo Descrição
    Cadeia de caracteres sys_id do usuário.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getID());

    GlideUser com escopo - getLastName()

    Retorna o sobrenome do usuário.

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 12. Retorna
    Tipo Descrição
    Cadeia de caracteres Sobrenome do usuário.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getLastName());

    GlideUser com escopo - getName()

    Retorna o ID do usuário, ou nome de login, do usuário atual.

    Tabela 13. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 14. Retorna
    Tipo Descrição
    Cadeia de caracteres ID do usuário ou nome de login.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getName());

    GlideUser com escopo - getPreference(String name)

    Obtém o valor de preferência do usuário especificado para o usuário atual.

    Tabela 15. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres Nome da preferência.
    Tabela 16. Retorna
    Tipo Descrição
    Cadeia de caracteres Valor de preferência.
    var currentUser = gs.getUser(); 
    currentUser.savePreference(­'myPref','red'); 
    gs.info(currentUser.getPreference(­'myPref'));

    GlideUser com escopo - getRoles()

    Retorna uma lista de funções que inclui funções concedidas explicitamente, funções herdadas e funções adquiridas por associação de grupo.

    Tabela 17. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 18. Retorna
    Tipo Descrição
    Matriz Lista de todas as funções disponíveis para o usuário
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getRoles());

    GlideUser com escopo - getUserRoles()

    Retorna a lista de funções concedidas explicitamente ao usuário.

    Ao contrário do método getRoles(), este método não retorna funções que o usuário herda ou funções adquiridas da associação ao grupo.

    Tabela 19. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 20. Retorna
    Tipo Descrição
    Matriz Lista de funções atribuídas explicitamente ao usuário.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.getUserRoles());

    GlideUser com escopo - hasRole(cadeia de caracteres função)

    Determina se o usuário atual tem a função especificada.

    Tabela 21. Parâmetros
    Nome Tipo Descrição
    função Cadeia de caracteres Função a ser verificada.
    Tabela 22. Retorna
    Tipo Descrição
    Booliano Sinalizador que indica se o usuário tem a função especificada.
    Valores possíveis:
    • verdadeiro: o usuário tem a função especificada.
    • falso: o usuário não tem a função especificada.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.hasRole('admin'));

    GlideUser com escopo - isMemberOf(cadeia de caracteres grupo)

    Determina se o usuário atual é membro do grupo especificado.

    Tabela 23. Parâmetros
    Nome Tipo Descrição
    grupo Cadeia de caracteres Grupo a ser verificado.
    Tabela 24. Retorna
    Tipo Descrição
    Booliano Sinalizador que indica se o usuário é membro do grupo especificado.
    Valores possíveis:
    • verdadeiro: o usuário é membro do grupo especificado.
    • falso: o usuário não é membro do grupo especificado.
    var currentUser = gs.getUser(); 
    gs.info(currentUser.isMemberOf(­'Capacity Mgmt'));

    GlideUser com escopo - savePreference (nome da cadeia de caracteres, valor da cadeia de caracteres)

    Salva um valor de preferência do usuário no banco de dados.

    Tabela 25. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres Preferência para salvar.
    valor Cadeia de caracteres Valor de preferência.
    Tabela 26. Retorna
    Tipo Descrição
    Nenhum
    var currentUser = gs.getUser(); 
    currentUser.savePreference('myPref','red'); 
    gs.info(currentUser.getPreference('myPref'));