---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# GlideUser - Cliente

# GlideUser - Cliente {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura

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.
{#c_GlideUserAPI__ul_bqz_wch_vs}

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](https://developer.servicenow.com/dev.do#!/learn/courses/sandiego/app_store_learnv2_scripting_rome_scripting_in_servicenow/app_store_learnv2_scripting_rome_client_side_scripting/app_store_learnv2_scripting_rome_introduction_to_client_side_scripting).

## GlideUser - firstName {#ariaid-title2}

O nome do usuário atual.
{#r_GlideUserFirstName__table_yrj_5fh_vs__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| firstName | Cadeia de caracteres | Nome do usuário atual. |
[Tabela 1. Campo]

{#r_GlideUserFirstName__table_yrj_5fh_vs}  

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

## GlideUser -- getClientData(Chave de cadeia de caracteres) {#ariaid-title3}

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()](https://servicenow-prod.fluidtopics.net/JkKoVjDBfUlhjdBuhYOkZw#c_GlideSessionScopedAPI "A API GlideSession com escopo fornece métodos para encontrar informações sobre a sessão atual."). 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](https://servicenow-prod.fluidtopics.net/Zl3eiO_1CJx2_6E9J3xhDQ#c_GlideFormAPI "A API GlideForm fornece métodos para personalizar formulários.").
{#r_GlideUser-getClientData_string__table_nv5_3k3_ws__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| chave | Cadeia de caracteres | Nome dos dados do cliente a serem recuperados. |
[Tabela 2. Parâmetros]

{#r_GlideUser-getClientData_string__table_nv5_3k3_ws} {#r_GlideUser-getClientData_string__table_ov5_3k3_ws__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Valor dos dados do cliente. |
[Tabela 3. Retorna]

{#r_GlideUser-getClientData_string__table_ov5_3k3_ws}  

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

## GlideUser -- getFullName() {#ariaid-title4}

Retorna o nome e o sobrenome do usuário atual.
{#r_GlideUser-getFullName__table_pvh_cm3_ws__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 4. Parâmetros]

{#r_GlideUser-getFullName__table_pvh_cm3_ws} {#r_GlideUser-getFullName__table_qvh_cm3_ws__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O nome completo do usuário atual. |
[Tabela 5. Retorna]

{#r_GlideUser-getFullName__table_qvh_cm3_ws}  

    var formalName = g_user.getFullName();

## GlideUser - hasRole (cadeia de caracteres função, booliano includeDefaults) {#ariaid-title5}

Retorna verdadeiro se o usuário atual tiver a função especificada ou a função de administrador.
{#r_GlideUser-hasRole_String__table_p1w_4m3_ws__entry__3}

| 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](https://www.servicenow.com/docs/access?context=exploring-user-administration&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Padrão: falso |
[Tabela 6. Parâmetros]

{#r_GlideUser-hasRole_String__table_p1w_4m3_ws} {#r_GlideUser-hasRole_String__table_q1w_4m3_ws__entry__2}

| 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. |
[Tabela 7. Retorna]

{#r_GlideUser-hasRole_String__table_q1w_4m3_ws}  

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

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

## GlideUser - hasRoleExactly (cadeia de caracteres função, booliano includeDefaults) {#ariaid-title6}

Determina se o usuário atual tem a função especificada.
{#r_GlideUser-hasRoleExactly_String__table_r53_hn3_ws__entry__3}

| 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](https://www.servicenow.com/docs/access?context=explicit-roles&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US). Padrão: falso |
| função | Cadeia de caracteres | Função a ser verificada. |
[Tabela 8. Parâmetros]

{#r_GlideUser-hasRoleExactly_String__table_r53_hn3_ws} {#r_GlideUser-hasRoleExactly_String__table_s53_hn3_ws__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Retorna verdadeiro se o usuário atual tiver a função especificada. |
[Tabela 9. Retorna]

{#r_GlideUser-hasRoleExactly_String__table_s53_hn3_ws}  

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

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

## GlideUser - hasRoleFromList (funções de cadeia de caracteres, booliano includeDefaults) {#ariaid-title7}

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

| 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](https://www.servicenow.com/docs/access?context=exploring-user-administration&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Padrão: falso |
[Tabela 10. Parâmetros]

{#r_GlideUser-hasRoleFromList_String__table_oxf_wn3_ws} {#r_GlideUser-hasRoleFromList_String__table_pxf_wn3_ws__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Retorna verdadeiro se o usuário atual tiver uma função na lista ou na função de administrador. |
[Tabela 11. Retorna]

{#r_GlideUser-hasRoleFromList_String__table_pxf_wn3_ws}  

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

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

## GlideUser - hasRoles(Booliano includeDefaults) {#ariaid-title8}

Retorna verdadeiro se o usuário atual tiver qualquer função.
{#r_GlideUser-hasRoles__table_ups_k43_ws__entry__3}

| 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](https://www.servicenow.com/docs/access?context=exploring-user-administration&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US). Padrão: falso |
[Tabela 12. Parâmetros]

{#r_GlideUser-hasRoles__table_ups_k43_ws} {#r_GlideUser-hasRoles__table_vps_k43_ws__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Retorna verdadeiro se o usuário atual tiver pelo menos uma função. |
[Tabela 13. Retorna]

{#r_GlideUser-hasRoles__table_vps_k43_ws}  

    var yesRole = g_user.hasRoles();

    var yesRole = g_user.hasRoles(true);

## GlideUser - lastName {#ariaid-title9}

O sobrenome do usuário atual.
{#r_GlideUserLastName__table_g2n_dgh_vs__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| sobreNome | Cadeia de caracteres | Sobrenome do usuário atual. |
[Tabela 14. Campo]

{#r_GlideUserLastName__table_g2n_dgh_vs}  

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

## GlideUser -- setClientData(Chave de cadeia de caracteres, Valor de cadeia de caracteres) {#ariaid-title10}

Define um valor de cliente que você pode recuperar usando getClientData().
Consulte também [GlideForm](https://servicenow-prod.fluidtopics.net/Zl3eiO_1CJx2_6E9J3xhDQ#c_GlideFormAPI "A API GlideForm fornece métodos para personalizar formulários.").
{#r_GlideUser-setClientData_S_S__table_nv5_3k3_ws__entry__3}

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

{#r_GlideUser-setClientData_S_S__table_nv5_3k3_ws} {#r_GlideUser-setClientData_S_S__table_ov5_3k3_ws__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum |   |
[Tabela 16. Retorna]

{#r_GlideUser-setClientData_S_S__table_ov5_3k3_ws}  

    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 {#ariaid-title11}

O nome de usuário atual, por exemplo, gsmith02. Não é o nome do usuário, por exemplo, George Smith.
{#r_GlideUserUserName__table_sf4_t2h_vs__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| userName | Cadeia de caracteres | Nome de usuário atual. |
[Tabela 17. Campo]

{#r_GlideUserUserName__table_sf4_t2h_vs}  

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

## GlideUser - ID do usuário {#ariaid-title12}

Retorna o sys_id do usuário atual.
{#r_GlideUserUserID__table_fhb_3fh_vs__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| userID | Cadeia de caracteres | Sys_id do usuário atual. |
[Tabela 18. Campo]

{#r_GlideUserUserID__table_fhb_3fh_vs}  

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