GlideUser - Cliente

A API GlideUser fornece métodos que acessam informações sobre o usuário atual e as funções do usuário atual. O uso desta API evita a necessidade de usar consultas GlideRecord mais lentas para obter informações do usuário.

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

Esta API:

• contém informações de nome e função sobre o usuário atual.
• O é 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ócio ou ações de IU executadas no servidor.

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 do método 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

O nome do usuário atual.

Tabela 1. Campo

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

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

GlideUser – getClientData(Chave de cadeia de caracteres)

Retorna um conjunto de valores de cliente 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 client script 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. Retornos

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.
includePadrões	Booliano	Opcional. Sinalizador que indica se funções padrão devem ser incluídas, como snc_internal e snc_external, na solicitação. Para obter informações adicionais sobre funções, consulte Exploring user administration. Padrão: falso

Tabela 7. Retornos

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
includePadrões	Booliano	Opcional. Sinalizador que indica se funções padrão devem ser incluídas, como snc_internal e snc_external, 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. Retornos

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 (funções de cadeia de caracteres, 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
includePadrões	Booliano	Opcional. Sinalizador que indica se funções padrão devem ser incluídas, como snc_internal e snc_external, na solicitação. Para obter informações adicionais sobre funções, consulte Exploring user administration. Padrão: falso

Tabela 11. Retornos

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

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

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

GlideUser - hasRoles(Booliano includeDefaults)

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

Tabela 12. Parâmetros

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

Tabela 13. Retornos

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 você pode recuperar 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. Retornos

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 - nome de usuário

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 - ID do usuário

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);