GlideUser - Cliente

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

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

Esta API:

• contém informações de nome e função sobre o usuário atual.
• Normalmente é usado em scripts de cliente 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.

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 GlideUser métodos, exceto GetClientData() acesse as informações da sessão que estão disponíveis por padrão. . GetClientData() o método requer configuração no servidor e o uso do PutClientData() método para disponibilizar informações da sessão.

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

GlideUser - Nome

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 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. 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(função de cadeia de caracteres, includeDefaults booliano)

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 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 (função de cadeia de caracteres, includeDefaults booliano)

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 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, includeDefaults boolianos)

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 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 a função de administrador.

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

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

GlideUser - hasRoles(boolian 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 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

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