---
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 - com escopo

# GlideUser - com escopo {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 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 com escopo - getCompanyID() {#ariaid-title2}

Retorna o sys_id da empresa do usuário atual.
{#r_ScopedGlideUserGetCompanyID__table_vx2_525_jq__entry__3}

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

{#r_ScopedGlideUserGetCompanyID__table_vx2_525_jq} {#r_ScopedGlideUserGetCompanyID__table_qxf_p34_1r__entry__2}

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

{#r_ScopedGlideUserGetCompanyID__table_qxf_p34_1r}  

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

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

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

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

{#r_ScopedGlideUserGetDisplayName__table_vy2_524_jq} {#r_ScopedGlideUserGetDisplayName__table_asj_cj4_1r__entry__2}

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

{#r_ScopedGlideUserGetDisplayName__table_asj_cj4_1r}  

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

## GlideUser com escopo - getEmail() {#ariaid-title4}

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

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

{#r_SGU-getEmail__table_syp_shb_1x} {#r_SGU-getEmail__table_typ_shb_1x__entry__2}

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

{#r_SGU-getEmail__table_typ_shb_1x}  

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

## GlideUser com escopo - getFirstName() {#ariaid-title5}

Retorna o nome do usuário.
{#r_SGU-getFirstName__table_x5k_h3b_1x__entry__3}

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

{#r_SGU-getFirstName__table_x5k_h3b_1x} {#r_SGU-getFirstName__table_y5k_h3b_1x__entry__2}

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

{#r_SGU-getFirstName__table_y5k_h3b_1x}  

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

## GlideUser com escopo - getID() {#ariaid-title6}

Obtém o sys_id do usuário atual.
{#r_ScopedGlideUserGetID__table_vy2_521_jq__entry__3}

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

{#r_ScopedGlideUserGetID__table_vy2_521_jq} {#r_ScopedGlideUserGetID__table_bc1_4j4_1r__entry__2}

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

{#r_ScopedGlideUserGetID__table_bc1_4j4_1r}  

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

## GlideUser com escopo - getLastName() {#ariaid-title7}

Retorna o sobrenome do usuário.
{#r_SGU-getLastName__table_tkm_t3b_1x__entry__3}

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

{#r_SGU-getLastName__table_tkm_t3b_1x} {#r_SGU-getLastName__table_ukm_t3b_1x__entry__2}

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

{#r_SGU-getLastName__table_ukm_t3b_1x}  

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

## GlideUser com escopo - getName() {#ariaid-title8}

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

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

{#r_ScopedGlideUserGetName__table_vy2_525_eq} {#r_ScopedGlideUserGetName__table_ucq_xj4_1r__entry__2}

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

{#r_ScopedGlideUserGetName__table_ucq_xj4_1r}  

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

## GlideUser com escopo - getPreference(String name) {#ariaid-title9}

Obtém o valor de preferência do usuário especificado para o usuário atual.
{#r_ScopedGlideUserGetPreference_String__table_mtf_3k4_1r__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Nome da preferência. |
[Tabela 15. Parâmetros]

{#r_ScopedGlideUserGetPreference_String__table_mtf_3k4_1r} {#r_ScopedGlideUserGetPreference_String__table_otf_3k4_1r__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | Valor de preferência. |
[Tabela 16. Retorna]

{#r_ScopedGlideUserGetPreference_String__table_otf_3k4_1r}  

    var currentUser = gs.getUser(); 
    currentUser.savePreference(­'myPref','red'); 
    gs.info(currentUser.getPreference(­'myPref'));

## GlideUser com escopo - getRoles() {#ariaid-title10}

Retorna uma lista de funções que inclui funções concedidas explicitamente, funções herdadas e funções adquiridas por associação de grupo.
{#r_SGU-getRoles__table_ukj_xgb_1x__entry__3}

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

{#r_SGU-getRoles__table_ukj_xgb_1x} {#r_SGU-getRoles__table_vkj_xgb_1x__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz | Lista de todas as funções disponíveis para o usuário |
[Tabela 18. Retorna]

{#r_SGU-getRoles__table_vkj_xgb_1x}  

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

## GlideUser com escopo - getUserRoles() {#ariaid-title11}

Retorna a lista de funções concedidas explicitamente ao usuário.
Ao contrário do método getRoles(), este método não retorna funções que o usuário herda ou funções adquiridas da associação ao grupo.
{#r_SGU-getUserRoles__table_jhl_yfb_1x__entry__3}

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

{#r_SGU-getUserRoles__table_jhl_yfb_1x} {#r_SGU-getUserRoles__table_khl_yfb_1x__entry__2}

| Tipo | Descrição |
|-|-|
| Matriz | Lista de funções atribuídas explicitamente ao usuário. |
[Tabela 20. Retorna]

{#r_SGU-getUserRoles__table_khl_yfb_1x}  

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

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

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

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

{#r_ScopedGlideUserHasRole_String__table_gk4_5k4_1r} {#r_ScopedGlideUserHasRole_String__table_ik4_5k4_1r__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se o usuário tem a função especificada. Valores possíveis: * verdadeiro: o usuário tem a função especificada. * falso: o usuário não tem a função especificada. |
[Tabela 22. Retorna]

{#r_ScopedGlideUserHasRole_String__table_ik4_5k4_1r}  

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

## GlideUser com escopo - isMemberOf(cadeia de caracteres grupo) {#ariaid-title13}

Determina se o usuário atual é membro do grupo especificado.
{#r_ScopedGlideUserIsMemberOf_String__table_mck_gl4_1r__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| grupo | Cadeia de caracteres | Grupo a ser verificado. |
[Tabela 23. Parâmetros]

{#r_ScopedGlideUserIsMemberOf_String__table_mck_gl4_1r} {#r_ScopedGlideUserIsMemberOf_String__table_ock_gl4_1r__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Sinalizador que indica se o usuário é membro do grupo especificado. Valores possíveis: * verdadeiro: o usuário é membro do grupo especificado. * falso: o usuário não é membro do grupo especificado. {#r_ScopedGlideUserIsMemberOf_String__ul_ytn_2bf_z1c} |
[Tabela 24. Retorna]

{#r_ScopedGlideUserIsMemberOf_String__table_ock_gl4_1r}  

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

## GlideUser com escopo - savePreference (nome da cadeia de caracteres, valor da cadeia de caracteres) {#ariaid-title14}

Salva um valor de preferência do usuário no banco de dados.
{#r_ScopedGlideUserSavePreference_String_String__table_wyt_rl4_1r__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Preferência para salvar. |
| valor | Cadeia de caracteres | Valor de preferência. |
[Tabela 25. Parâmetros]

{#r_ScopedGlideUserSavePreference_String_String__table_wyt_rl4_1r} {#r_ScopedGlideUserSavePreference_String_String__table_xyt_rl4_1r__entry__2}

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

{#r_ScopedGlideUserSavePreference_String_String__table_xyt_rl4_1r}  

    var currentUser = gs.getUser(); 
    currentUser.savePreference('myPref','red'); 
    gs.info(currentUser.getPreference('myPref'));