---
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 - Global

# GlideUser - Global {#ariaid-title1}

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

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

## GlideUser -- getCompanyID() {#ariaid-title2}

Retorna o sys_id da empresa do usuário atual.
{#GUser-getCompanyID__table_vmc_n33_xz__entry__3}

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

{#GUser-getCompanyID__table_vmc_n33_xz} {#GUser-getCompanyID__table_wmc_n33_xz__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | sys_id da empresa |
[Tabela 2. Retorna]

{#GUser-getCompanyID__table_wmc_n33_xz}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getCompanyID());

### Equivalente com escopo {#GUser-getCompanyID__section_fzj_lyh_xz}

Para usar o método getCompanyID() em uma aplicação com escopo, use o método com escopo correspondente: [getCompanyID()](https://servicenow-prod.fluidtopics.net/8OtwlsmxrS3B8Ws3VcsQXw#r_ScopedGlideUserGetCompanyID "Retorna o sys_id da empresa do usuário atual.").

## GlideUser -- getDisplayName() {#ariaid-title3}

Retorna o nome de exibição do usuário atual.
{#GUser-getDisplayName__table_qqh_mh3_xz__entry__3}

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

{#GUser-getDisplayName__table_qqh_mh3_xz} {#GUser-getDisplayName__table_rqh_mh3_xz__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Nome de exibição do usuário |
[Tabela 4. Retorna]

{#GUser-getDisplayName__table_rqh_mh3_xz}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getDisplayName());

### Equivalente com escopo {#GUser-getDisplayName__section_fzj_lyh_xz}

Para usar o método getDisplayName() em uma aplicação com escopo, use o método com escopo correspondente: [getDisplayName()](https://servicenow-prod.fluidtopics.net/8OtwlsmxrS3B8Ws3VcsQXw#r_ScopedGlideUserGetDisplayName "Retorna o nome de exibição do usuário atual.").

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

Retorna o valor de exibição do domínio da sessão do usuário.
{#GUser-getDomainDisplayValue__table_wrr_hlg_zz__entry__3}

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

{#GUser-getDomainDisplayValue__table_wrr_hlg_zz} {#GUser-getDomainDisplayValue__table_xrr_hlg_zz__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O valor de exibição do domínio da sessão do usuário. |
[Tabela 6. Retorna]

{#GUser-getDomainDisplayValue__table_xrr_hlg_zz}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getDomainDisplayValue());

### Equivalente com escopo {#GUser-getDomainDisplayValue__section_oy2_nts_mcb}

Não há solução alternativa para aplicações com escopo.

## GlideUser -- getDomainID() {#ariaid-title5}

Retorna o identificador do domínio da sessão atual do usuário.
O identificador retornado depende do tipo de domínio e da instanciação desse domínio.  
* Se o usuário estiver configurado no domínio global e não usar o seletor de domínio para alternar os domínios, o método retornará nulo.
* Se o usuário usar o seletor de domínio para alternar para o domínio global, o método retornará a cadeia de caracteres "global".
* Para todos os outros domínios, o método retorna o sys_id desse domínio.
{#GUser-getDomainID__ul_l4v_kc1_pfb}
{#GUser-getDomainID__table_trl_lzz_4fb__entry__3}

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

{#GUser-getDomainID__table_trl_lzz_4fb} {#GUser-getDomainID__table_url_lzz_4fb__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Identificador de domínio. |
[Tabela 8. Retorna]

{#GUser-getDomainID__table_url_lzz_4fb}  

    var domain = new GlideRecord('domain');
    domain.get(gs.getUser().getDomainID());
    gs.info(domain.name);

## GlideUser -- getEmail() {#ariaid-title6}

Retorna o endereço de e-mail do usuário.
{#GUser-getEmail__table_nxz_qg3_xz__entry__3}

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

{#GUser-getEmail__table_nxz_qg3_xz} {#GUser-getEmail__table_oxz_qg3_xz__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Endereço de e-mail do usuário |
[Tabela 10. Retorna]

{#GUser-getEmail__table_oxz_qg3_xz}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getEmail());

### Equivalente com escopo {#GUser-getEmail__section_fzj_lyh_xz}

Para usar o método getEmail() em uma aplicação com escopo, use o método com escopo correspondente: [getEmail()](https://servicenow-prod.fluidtopics.net/8OtwlsmxrS3B8Ws3VcsQXw#r_SGU-getEmail "Retorna o endereço de e-mail do usuário.").

## GlideUser -- getFirstName() {#ariaid-title7}

Retorna o nome do usuário.
{#GUser-getFirstName__table_mjs_zb3_xz__entry__3}

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

{#GUser-getFirstName__table_mjs_zb3_xz} {#GUser-getFirstName__table_njs_zb3_xz__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto/cadeia de caracteres | Nome do usuário. Nota: O tipo de dados do valor retornado é objeto, no entanto, as informações são retornadas como uma cadeia de caracteres. |
[Tabela 12. Retorna]

{#GUser-getFirstName__table_njs_zb3_xz}  

    var currentUser = gs.getUser(); 
    var userName = currentUser.getFirstName();
    gs.info('User First Name: + userName);
    gs.info('Data type: ' + typeof userName);

    *** Script: User First Name: John
    *** Script: Data type: object

### Equivalente com escopo {#GUser-getFirstName__section_fzj_lyh_xz}

Para usar o método getFirstName() em uma aplicação com escopo, use o método com escopo correspondente: [getFirstName()](https://servicenow-prod.fluidtopics.net/8OtwlsmxrS3B8Ws3VcsQXw#r_SGU-getFirstName "Retorna o nome do usuário.").

## GlideUser - getID {#ariaid-title8}

Retorna o sys_id do usuário atual.
{#GUser-getID__table_vtq_4xh_xz__entry__3}

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

{#GUser-getID__table_vtq_4xh_xz} {#GUser-getID__table_wtq_4xh_xz__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | sys_id do usuário |
[Tabela 14. Retorna]

{#GUser-getID__table_wtq_4xh_xz}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getID());

### Equivalente com escopo {#GUser-getID__section_fzj_lyh_xz}

Para usar o método getID() em uma aplicação com escopo, use o método com escopo correspondente: [getID()](https://servicenow-prod.fluidtopics.net/8OtwlsmxrS3B8Ws3VcsQXw#r_ScopedGlideUserGetID "Obtém o sys_id do usuário atual.").

## GlideUser -- getLastName() {#ariaid-title9}

Retorna o sobrenome do usuário.
{#GUser-getLastName__table_agq_1g3_xz__entry__3}

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

{#GUser-getLastName__table_agq_1g3_xz} {#GUser-getLastName__table_bgq_1g3_xz__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto/cadeia de caracteres | Sobrenome do usuário. Nota: O tipo de dados do valor retornado é objeto, no entanto, as informações são retornadas como uma cadeia de caracteres. |
[Tabela 16. Retorna]

{#GUser-getLastName__table_bgq_1g3_xz}  

    var currentUser = gs.getUser(); 
    var userName = currentUser.getLastName();
    gs.info('User Last Name: + userName);
    gs.info('Data type: ' + typeof userName);

    *** Script: User Last Name: Smith
    *** Script: Data type: object

### Equivalente com escopo {#GUser-getLastName__section_fzj_lyh_xz}

Para usar o método getLastName() em uma aplicação com escopo, use o método com escopo correspondente: [getLastName()](https://servicenow-prod.fluidtopics.net/8OtwlsmxrS3B8Ws3VcsQXw#r_SGU-getLastName "Retorna o sobrenome do usuário.").

## GlideUser -- getMyGroups() {#ariaid-title10}

Retorna um iterador que contém a lista de todos os grupos aos quais o usuário pertence. Somente grupos ativos são retornados.
{#GUser-getMyGroups__table_llp_tc5_5bb__entry__3}

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

{#GUser-getMyGroups__table_llp_tc5_5bb} {#GUser-getMyGroups__table_mlp_tc5_5bb__entry__2}

| Tipo | Descrição |
|-|-|
| iterador | Uma lista de sys_ids dos grupos ativos aos quais o usuário pertence. |
[Tabela 18. Retorna]

{#GUser-getMyGroups__table_mlp_tc5_5bb}  
O exemplo a seguir mostra como retornar uma lista de grupos aos quais o usuário pertence.

    var groupsArray = gs.getUser().getMyGroups().toArray();
    gs.info(groupsArray[0]);

Saída:

    cfcbad03d711110050f5edcb9e61038f

### Equivalente com escopo {#GUser-getMyGroups__section_p31_wts_mcb}

Não há equivalente com escopo para este método.

## GlideUser -- getName() {#ariaid-title11}

Retorna o ID do usuário, ou nome de login, do usuário atual.
{#GUser-getName__table_exc_w13_xz__entry__3}

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

{#GUser-getName__table_exc_w13_xz} {#GUser-getName__table_fxc_w13_xz__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | ID do Usuário |
[Tabela 20. Retorna]

{#GUser-getName__table_fxc_w13_xz}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getName());

### Equivalente com escopo {#GUser-getName__section_fzj_lyh_xz}

Para usar o método getName() em uma aplicação com escopo, use o método com escopo correspondente: [getName()](https://servicenow-prod.fluidtopics.net/8OtwlsmxrS3B8Ws3VcsQXw#r_ScopedGlideUserGetName "Retorna o ID do usuário, ou nome de login, do usuário atual.").

## GlideUser -- getRoles() {#ariaid-title12}

Retorna uma lista de funções associadas ao usuário. Inclui funções concedidas explicitamente, funções herdadas e funções adquiridas por associação de grupo.
{#GUser-getRoles__table_ml5_q4m_xz__entry__3}

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

{#GUser-getRoles__table_ml5_q4m_xz} {#GUser-getRoles__table_nl5_q4m_xz__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto | Lista separada por vírgulas de funções de usuário. |
[Tabela 22. Retorna]

{#GUser-getRoles__table_nl5_q4m_xz}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.getRoles());

Saída:

    admin,hr_fulfiller,itsa_fulfiller,security_admin

### Equivalente com escopo {#GUser-getRoles__section_fzj_lyh_xz}

Para usar o método getRoles() em uma aplicação com escopo, use o método com escopo correspondente: [getRoles()](https://servicenow-prod.fluidtopics.net/8OtwlsmxrS3B8Ws3VcsQXw#r_SGU-getRoles "Retorna uma lista de funções que inclui funções concedidas explicitamente, funções herdadas e funções adquiridas por associação de grupo.").

## GlideUser -- getUserByID (ID da cadeia de caracteres) {#ariaid-title13}

Retorna o objeto de usuário associado ao ID de usuário passado (sys_id em sys_user) ou user_name.
{#GUser-getUserByID_S__table_wsx_qkr_h2b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| ID | Cadeia de caracteres | ID exclusivo (sys_id) ou user_name do registro de usuário desejado. |
[Tabela 23. Parâmetros]

{#GUser-getUserByID_S__table_wsx_qkr_h2b} {#GUser-getUserByID_S__table_xsx_qkr_h2b__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto | Objeto de usuário associado ao sys_id ou user_name especificado. |
[Tabela 24. Retorna]

{#GUser-getUserByID_S__table_xsx_qkr_h2b}  
Exemplo usando nome de usuário (user_name).

    var currentUser = gs.getUser();
    gs.info(currentUser.getFirstName()); // print the first name of the logged in user
    var newUser = currentUser.getUserByID('abel.tuter'); // fetch a different user using the user_name field
    gs.info(newUser.getFirstName()); // print the first name of the Abel Tuter user 

Exemplo usando o ID do usuário (sys_id).

    var currentUser = gs.getUser();
    gs.info(currentUser.getFirstName()); // print the first name of the logged in user
    var newUser = currentUser.getUserByID('62826bf03710200044e0bfc8bcbe5df1'); // fetch Abel Tuter user using sys_id from sys_user record
    gs.info(newUser.getFirstName()); // print the first name of the Abel Tuter user 

## GlideUser -- getUserRoles() {#ariaid-title14}

Retorna a lista de funções concedidas explicitamente ao usuário.
{#GUser-getUserRoles__table_pkf_xnm_xz__entry__3}

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

{#GUser-getUserRoles__table_pkf_xnm_xz} {#GUser-getUserRoles__table_qkf_xnm_xz__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto/cadeia de caracteres | Lista de funções separadas por vírgulas atribuídas explicitamente ao usuário. Nota: O tipo de dados do valor retornado é objeto, no entanto, as informações são retornadas como uma cadeia de caracteres. |
[Tabela 26. Retorna]

{#GUser-getUserRoles__table_qkf_xnm_xz}  

    var currentUser = gs.getUser(); 
    var userRoles = currentUser.getUserRoles();
    gs.info('User Roles: ' + userRoles);
    gs.info('Data type: ' + typeof userRoles);

    *** Script: User Roles: ,admin,security_admin
    *** Script: Data type: object

### Equivalente com escopo {#GUser-getUserRoles__section_fzj_lyh_xz}

Para usar o método getUserRoles() em uma aplicação com escopo, use o método com escopo correspondente: [getUserRoles()](https://servicenow-prod.fluidtopics.net/8OtwlsmxrS3B8Ws3VcsQXw#r_SGU-getUserRoles "Retorna a lista de funções concedidas explicitamente ao usuário.").

## GlideUser - hasRole(cadeia de caracteres função) {#ariaid-title15}

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

| Nome | Tipo | Descrição |
|-|-|-|
| função | Cadeia de caracteres | Função a ser verificada |
[Tabela 27. Parâmetros]

{#GUser-hasRole_S__table_xmz_mmm_xz} {#GUser-hasRole_S__table_ymz_mmm_xz__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Verdadeiro se o usuário tiver a função. |
[Tabela 28. Retorna]

{#GUser-hasRole_S__table_ymz_mmm_xz}  

    var currentUser = gs.getUser(); 
    gs.info(currentUser.hasRole('admin'));

### Equivalente com escopo {#GUser-hasRole_S__section_fzj_lyh_xz}

Para usar o método hasRole() em uma aplicação com escopo, use o método com escopo correspondente: [hasRole()](https://servicenow-prod.fluidtopics.net/8OtwlsmxrS3B8Ws3VcsQXw#r_ScopedGlideUserHasRole_String "Determina se o usuário atual tem a função especificada.").

## GlideUser - isExplicitMemberOf(cadeia de caracteres grupo) {#ariaid-title16}

Determina se o usuário atual é um membro explícito do grupo especificado. Somente grupos ativos são avaliados por este método.
O método isMemberOf() retornará verdadeiro para um grupo primário se o usuário for membro do grupo secundário. Use este método se quiser retornar verdadeiro somente para grupos primários.
{#GUser-isExplicitMemberOf_S__table_l1q_4lm_xz__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| grupo | Cadeia de caracteres | Sys_id do grupo de usuários a ser verificado. |
[Tabela 29. Parâmetros]

{#GUser-isExplicitMemberOf_S__table_l1q_4lm_xz} {#GUser-isExplicitMemberOf_S__table_m1q_4lm_xz__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se o usuário atual é um membro explícito do grupo especificado. Valores válidos: * verdadeiro: o usuário atual é um membro explícito do grupo especificado. * falso: o usuário atual não é um membro explícito do grupo especificado. {#GUser-isExplicitMemberOf_S__ul_gvv_fqf_nsb} |
[Tabela 30. Retorna]

{#GUser-isExplicitMemberOf_S__table_m1q_4lm_xz}  
O exemplo a seguir mostra como verificar se o usuário atual é um membro explícito do grupo especificado.

    var isExplMem = gs.getUser().isExplicitMemberOf('b8ef24616fc331003b3c498f5d3ee434');
    gs.info(isExplMem);

Saída:

    false

### Equivalente com escopo {#GUser-isExplicitMemberOf_S__section_wxy_xpz_kwb}

Não há equivalente com escopo para este método.

## GlideUser - isMemberOf(cadeia de caracteres grupo) {#ariaid-title17}

Determina se o usuário atual é membro do grupo especificado. Somente grupos ativos são avaliados por este método.
Este método retorna verdadeiro para um grupo primário se o usuário for membro do grupo secundário. Use isExplicitMemberOf() se quiser retornar verdadeiro somente para grupos primários.
{#GUser-isMemberOf_S__table_l1q_4lm_xz__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| grupo | Cadeia de caracteres | Sys_id do grupo de usuários a ser verificado. |
[Tabela 31. Parâmetros]

{#GUser-isMemberOf_S__table_l1q_4lm_xz} {#GUser-isMemberOf_S__table_m1q_4lm_xz__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se o usuário atual é membro do grupo especificado. Valores válidos: * verdadeiro: o usuário atual é membro do grupo especificado. * falso: o usuário atual não é membro do grupo especificado. {#GUser-isMemberOf_S__ul_gvv_fqf_nsb} |
[Tabela 32. Retorna]

{#GUser-isMemberOf_S__table_m1q_4lm_xz}  
O exemplo a seguir mostra como verificar se o usuário atual é membro do grupo especificado.

    var currentUser = gs.getUser(); 
    gs.info(currentUser.isMemberOf(­'Capacity Mgmt'));

### Equivalente com escopo {#GUser-isMemberOf_S__section_fzj_lyh_xz}

Para usar o método isMemberOf() em uma aplicação com escopo, use o método com escopo correspondente: [isMemberOf()](https://servicenow-prod.fluidtopics.net/8OtwlsmxrS3B8Ws3VcsQXw#r_ScopedGlideUserIsMemberOf_String "Determina se o usuário atual é membro do grupo especificado.").