GlideSession - Global

A API GlideSession fornece métodos para encontrar informações sobre a sessão atual.

GlideSession – clearClientData(cadeia de caracteres paramName)

Limpa um valor de cliente de sessão definido anteriormente com putClientData().

Este método é usado em um client script para limpar valores de dados que foram definidos por um script de servidor usando o método putClientData().

Tabela 1. Parâmetros

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

Tabela 2. Retornos

Tipo	Descrição
vazio

var session = gs.getSession();
session.putClientData('custName', 'Harry');
var clientData = session.getClientData('custName');
gs.info(clientData);
 
session.clearClientData('custName');
clientData = session.getClientData('custName');
gs.info(clientData);

Saída:

Harry
 
null

GlideSession – getClientData(cadeia de caracteres paramName)

Retorna um valor de cliente de sessão definido anteriormente com putClientData().

Este método é usado em um client script para recuperar valores de dados que foram definidos por um script de servidor que usou o método putClientData() .

Tabela 3. Parâmetros

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

Tabela 4. Retornos

Tipo	Descrição
Cadeia de caracteres	Os dados do cliente como uma cadeia de caracteres.

var session = gs.getSession();
session.putClientData('test1', 'Harry');
var clientData = session.getClientData('test1');
gs.info(clientData);

Saída:

Harry

Equivalente com escopo

Para usar o método getClientData() em uma aplicação com escopo, use o método com escopo correspondente: getClientData().

GlideSession – getLanguage()

Obtém o código de idioma da sessão.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 6. Retorna

Tipo	Descrição
Cadeia de caracteres	O código de idioma da sessão.

var session = gs.getSession();
var language = session.getLanguage();
gs.info(language);

Saída:

en

Equivalente com escopo

Para usar o método getLanguage() em uma aplicação com escopo, use o método com escopo correspondente: getLanguage().

GlideSession – getRoles()

Obtém uma lista de funções para o usuário atual.

A lista de funções não reflete as mudanças feitas durante a sessão do usuário atual. Para obter a lista atualizada de funções, o usuário deve fazer logout e login novamente.

Tabela 7. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 8. Retorna

Tipo	Descrição
Cadeia de caracteres	Uma lista separada por vírgulas de funções.

gs.info(gs.getSession().getRoles());

Saída:

admin,hr_fulfiller,itsa_fulfiller,security_admin

GlideSession – getTimeZoneName()

Obtém o nome do fuso horário da sessão.

Tabela 9. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 10. Retorna

Tipo	Descrição
Cadeia de caracteres	O nome do fuso horário da sessão.

var session = gs.getSession();
var zoneName = session.getTimeZoneName();
gs.info(zoneName);

Saída:

US/Pacific

Equivalente com escopo

Para usar o método getTimeZoneName() em uma aplicação com escopo, use o método com escopo correspondente: getTimeZoneName().

GlideSession – isInteractive()

Determina se a sessão atual é interativa.

Uma sessão interativa é aquela que envolve um usuário final interagindo com uma interface do usuário que recupera informações de um servidor. Um exemplo desse tipo de sessão é quando um usuário faz login usando a tela de login ou usa um formulário para consultar um armazenamento de dados. Uma sessão não interativa é aquela que envolve apenas interação programática com um servidor, como uma solicitação SOAP para recuperar dados.

Tabela 11. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 12. Retorna

Tipo	Descrição
Booliano	Verdadeiro se a sessão for interativa.

Nota:

O método isInteractive() sempre retornará um valor falso para todas as sessões de usuário que usam os aplicativos para celular clássicos ou atuais.

var interActive = gs.getSession().isInteractive();
gs.info(interActive);

Saída:

false

Equivalente com escopo

Para usar o método isInteractive() em uma aplicação com escopo, use o método com escopo correspondente: isInteractive().

GlideSession – isLoggedIn()

Determina se o usuário atual está conectado no momento.

Tabela 13. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 14. Retorna

Tipo	Descrição
Booliano	Verdadeiro se o usuário atual estiver conectado.

var session = gs.getSession();
var loggedIn = session.isLoggedIn();
gs.info(loggedIn);

Saída:

true

Equivalente com escopo

Para usar o método isLoggedIn() em uma aplicação com escopo, use o método com escopo correspondente: isLoggedIn().

GlideSession – putClientData(cadeia de caracteres paramName, cadeia de caracteres paramValue)

Define um valor de cliente de sessão que pode ser recuperado com getClientData(). Este método é usado em um script do lado do servidor que é executado quando um formulário é criado.

Tabela 15. Parâmetros

Nome	Tipo	Descrição
paramName	Cadeia de caracteres	Nome do parâmetro do cliente a ser definido.
paramValue	Cadeia de caracteres	Valor do parâmetro.

Tabela 16. Retornos

Tipo	Descrição
vazio

var session = gs.getSession();
session.putClientData('test1', 'Harry');
var clientData = session.getClientData('test1');
gs.info(clientData);

Saída:

Harry

Equivalente com escopo

Para usar o método putClientData() em uma aplicação com escopo, use o método com escopo correspondente: putClientData().