GlideUser - Com escopo

. GlideUser A API fornece métodos para acessar informações sobre o usuário atual e as funções do usuário atual.

Usando o. GlideUser A API 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 o 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 (nome da cadeia de caracteres)

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

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 - getTimeZoneLabel()

Retorna o rótulo de fuso horário do usuário atual no idioma preferencial do usuário atual.

Para obter mais informações sobre como definir o idioma preferencial de um usuário, consulte User specific language.

Tabela 19. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 20. Retorna

Tipo	Descrição
Cadeia de caracteres	O rótulo do fuso horário do usuário atual.

Este exemplo mostra como retornar o rótulo de fuso horário do usuário atual em seu idioma preferencial.

gs.info(gs.getUser().getTimeZoneLabel());

Saída:

Europe/Dublin

GlideUser com escopo - getTimeZoneLabelLang(idioma de cadeia de caracteres)

Retorna o rótulo de fuso horário do usuário atual no idioma especificado.

Tabela 21. Parâmetros

Nome	Tipo	Descrição
idioma	Cadeia de caracteres	Idioma a ser usado para o rótulo de fuso horário. Localizado na coluna ID da tabela Idioma [sys_language]. Se um idioma válido não for fornecido, o rótulo do fuso horário será retornado em inglês.

Tabela 22. Retornos

Tipo	Descrição
Cadeia de caracteres	O rótulo do fuso horário do usuário atual.

Este exemplo mostra como retornar o rótulo de fuso horário do usuário atual em um idioma especificado.

gs.info(gs.getUser().getTimeZoneLabelLang("es")); //Spanish
gs.info(gs.getUser().getTimeZoneLabelLang("ja")); //Japanese
gs.info(gs.getUser().getTimeZoneLabelLang("jksjsjks")); //invalid

Saída:

Europa/Dublín
ヨーロッパ/ダブリン
Europe/Dublin

GlideUser com escopo - getUserRoles()

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

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

Tabela 23. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 24. 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(função de cadeia de caracteres)

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

Tabela 25. Parâmetros

Nome	Tipo	Descrição
função	Cadeia de caracteres	Função a ser verificada.

Tabela 26. Retornos

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(grupo de cadeia de caracteres)

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

Tabela 27. Parâmetros

Nome	Tipo	Descrição
grupo	Cadeia de caracteres	Sys_id ou nome do grupo a ser verificado.

Tabela 28. Retornos

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. Falso: O usuário não é membro do grupo.

O exemplo a seguir verifica se o usuário atual é membro do grupo Capacity MGMT.

var currentUser = gs.getUser(); 
gs.info(currentUser.isMemberOf('Capacity Mgmt'));

Saída:

false

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 29. Parâmetros

Nome	Tipo	Descrição
nome	Cadeia de caracteres	Preferência para salvar.
valor	Cadeia de caracteres	Valor de preferência.

Tabela 30. Retornos

Tipo	Descrição
Nenhum

var currentUser = gs.getUser(); 
currentUser.savePreference('myPref','red'); 
gs.info(currentUser.getPreference('myPref'));