GlideUser - Cliente

A API GlideUser fornece acesso a 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 consultas GlideRecord mais lentas para obter informações do usuário.

Os métodos e propriedades GlideUser são acessados por meio de um objeto global (g_user) que só está disponível em client scripts. GlideUser

• contém informações de nome e função sobre o usuário atual.
• é normalmente usado em client scripts e políticas de IU, mas também é encontrado em ações de IU executadas no cliente.
• não pode ser usado em regras de negócios ou ações de IU executadas no servidor.
• evita a necessidade de consultas GlideRecord para obter informações do usuário.

As informações da sessão sobre o usuário atual e as funções do usuário atual estão contidas no cliente (navegador da Web). Todos os métodos GlideUser, exceto getClientData(), acessam as informações da sessão que estão disponíveis por padrão. O método getClientData() requer configuração no servidor e o uso de putClientData() para disponibilizar as informações da sessão.

Para obter informações sobre como usar scripts do lado do cliente, consulte Introdução ao script do lado do cliente.

GlideUser - firstName

Retorna o nome do usuário atual.

Tabela 1. Campo

Nome	Tipo	Descrição
firstName	Cadeia de caracteres	Nome do usuário atual.

alert('first name = ' + g_user.firstName);

GlideUser - getClientData(cadeia de caracteres chave)

Retorna um valor de cliente definido usando setClientData() ou GlideSession -- putClientData().

Os dados do cliente da sessão são um conjunto de cadeias de caracteres nomeadas que podem ser configuradas no servidor usando GlideSession -- putClientData(). Você pode usar getClientData() durante o tempo de carregamento do formulário para obter informações de que o script do cliente precisa para tomar decisões sobre o formulário. Por exemplo, para identificar quais campos devem estar visíveis.

Consulte também GlideForm.

Tabela 2. Parâmetros

Nome	Tipo	Descrição
chave	Cadeia de caracteres	Nome dos dados do cliente a serem recuperados.

Tabela 3. Retorna

Tipo	Descrição
Cadeia de caracteres	Valor dos dados do cliente.

var loginLanguage = g_user.getClientData("loginlanguage");

GlideUser – getFullName()

Retorna o nome e o sobrenome do usuário atual.

Tabela 4. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 5. Retorna

Tipo	Descrição
Cadeia de caracteres	O nome completo do usuário atual.

var formalName = g_user.getFullName();

GlideUser - hasRole(cadeia de caracteres função, booliano includeDefaults)

Retorna verdadeiro se o usuário atual tiver a função especificada ou a função de administrador.

Tabela 6. Parâmetros

Nome	Tipo	Descrição
função	Cadeia de caracteres	Função a ser verificada.
includeDefaults	Booliano	Opcional. Sinalizador que indica se as funções padrão, como snc_internal e snc_external, devem ser incluídas na solicitação. Para obter informações adicionais sobre funções, consulte Exploring user administration. Padrão: falso

Tabela 7. Retorna

Tipo	Descrição
Booliano	Retorna verdadeiro se o usuário atual tiver a função especificada ou a função de administrador. caso contrário, retornará falso.

var isInternal = g_user.hasRole('snc_internal', true);

var isItil = g_user.hasRole('itil');

GlideUser - hasRoleExactly(cadeia de caracteres função, booliano includeDefaults)

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

Tabela 8. Parâmetros

Nome	Tipo	Descrição
includeDefaults	Booliano	Opcional. Sinalizador que indica se as funções padrão, como snc_internal e snc_external, devem ser incluídas na solicitação. Para obter informações adicionais sobre funções, consulte Funções explícitas. Padrão: falso
função	Cadeia de caracteres	Função a ser verificada.

Tabela 9. Retorna

Tipo	Descrição
Booliano	Retorna verdadeiro se o usuário atual tiver a função especificada.

var isInternal = g_user.hasRoleExactly('snc_internal', true);

var isItil = g_user.hasRoleExactly('itil');

GlideUser - hasRoleFromList(cadeia de caracteres funções, booliano includeDefaults)

Retorna verdadeiro se o usuário atual tiver pelo menos uma das funções especificadas ou tiver a função de administrador.

Tabela 10. Parâmetros

Nome	Tipo	Descrição
funções	Cadeia de caracteres	Lista separada por vírgulas de funções a serem verificadas
includeDefaults	Booliano	Opcional. Sinalizador que indica se as funções padrão, como snc_internal e snc_external, devem ser incluídas na solicitação. Para obter informações adicionais sobre funções, consulte Exploring user administration. Padrão: falso

Tabela 11. Retorna

Tipo	Descrição
Booliano	Retorna verdadeiro se o usuário atual tiver uma função na lista ou a função de administrador.

var isOK = g_user.hasRoleFromList("itil, maint");

var isOK = g_user.hasRoleFromList("itil, maint, snc_internal", true);

GlideUser - hasRoles(boolean includeDefaults)

Retorna verdadeiro se o usuário atual tiver alguma função.

Tabela 12. Parâmetros

Nome	Tipo	Descrição
includeDefaults	Booliano	Opcional. Sinalizador que indica se as funções padrão, como snc_internal e snc_external, devem ser incluídas na solicitação. Para obter informações adicionais sobre funções, consulte Exploring user administration. Padrão: falso

Tabela 13. Retorna

Tipo	Descrição
Booliano	Retorna verdadeiro se o usuário atual tiver pelo menos uma função.

var yesRole = g_user.hasRoles();

var yesRole = g_user.hasRoles(true);

GlideUser - lastName

O sobrenome do usuário atual.

Tabela 14. Campo

Nome	Tipo	Descrição
sobrenome	Cadeia de caracteres	Sobrenome do usuário atual.

alert('last name = ' + g_user.lastName);

GlideUser - setClientData(Chave de cadeia de caracteres, Valor de cadeia de caracteres)

Define um valor de cliente que pode ser recuperado usando getClientData().

Consulte também GlideForm.

Tabela 15. Parâmetros

Nome	Tipo	Descrição
chave	Cadeia de caracteres	Nome dos dados do cliente a serem armazenados como uma chave.
valor	Número	Valor a ser atribuído à chave.

Tabela 16. Retorna

Tipo	Descrição
Nenhum

function onSubmit() {
	
	if (!g_user.getClientData('keyName')) {
		var now_GR = new GlideRecord('incident');
		now_GR.addActiveQuery();
		now_GR.setLimit(1);
		now_GR.query(cb);
		return false;
	}
	return true;
}

function cb(now_GR) {
	// <insert glide operation >
	g_user.setClientData('keyName', now_GR.getValue('<number>'));
	g_form.submit();	
}

GlideUser - userName

Esta propriedade é o nome de usuário atual, por exemplo, gsmith02. Não é o nome do usuário, por exemplo, George Smith.

Tabela 17. Campo

Nome	Tipo	Descrição
userName	Cadeia de caracteres	Nome de usuário atual.

var userName = g_user.userName;
   alert('Current user = ' + userName);

GlideUser - userID

Retorna o sys_id do usuário atual.

Tabela 18. Campo

Nome	Tipo	Descrição
userID	Cadeia de caracteres	sys_id do usuário atual.

var userID = g_user.userID;
   alert('Current user ID = ' + userID);