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


---

# GlideURI - Global

# GlideURI - Global {#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 GlideURI fornece métodos para lidar com parâmetros de URI em uma aplicação global.  
Nota:  
Não use a API GlideURI em scripts que são executados durante a exportação ou em trabalhos em segundo plano.  
Para obter mais informações sobre como usar URIs:

* [Navegar por URL](https://www.servicenow.com/docs/access?context=navigate-using-url&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)
* [Pilha de navegação](https://www.servicenow.com/docs/access?context=c_NavigationStack&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)
{#GlideURIGlobalAPI__ul_swn_bjb_rmb}

Consulte também [Ação - getGlideURI()](https://servicenow-prod.fluidtopics.net/iqfcZAyryA1nZzOgFW2HpQ#Action_getGlideURI "Obtém um objeto GlideURI para determinar a exibição do usuário.").

## GlideURI -- deleteMatchingParameter(cadeia de caracteres correspondente) {#ariaid-title2}

Exclui um ou mais parâmetros do URI que correspondem ao início da cadeia de caracteres fornecida.
{#GlideURI_deleteMatchingParameter_S__table_vh4_ftg_rmb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| correspondência | Cadeia de caracteres | Nome parcial de um ou mais parâmetros a serem removidos da parte de consulta de um URI. |
[Tabela 1. Parâmetros]

{#GlideURI_deleteMatchingParameter_S__table_vh4_ftg_rmb} {#GlideURI_deleteMatchingParameter_S__table_wh4_ftg_rmb__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 2. Retorna]

{#GlideURI_deleteMatchingParameter_S__table_wh4_ftg_rmb}  
O exemplo a seguir mostra como excluir parâmetros de URI que correspondem parcialmente ao nome fornecido.

    // create the GlideURI object
    var uri = action.getGlideURI();

    uri.deleteMatchingParameter('sysparm_list_');
    uri.deleteMatchingParameter('sysparm_record_');

### Equivalente com escopo {#GlideURI_deleteMatchingParameter_S__section_bct_nbs_mcb}

Este método não está disponível em aplicações com escopo.

## GlideURI -- deleteParameter(cadeia de caracteres nome) {#ariaid-title3}

Remove um parâmetro especificado da parte de consulta do URI.
{#GlideURI_deleteParameter_S__table_vh4_ftg_rmb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | Nome do parâmetro a ser removido da parte de consulta de um URI. |
[Tabela 3. Parâmetros]

{#GlideURI_deleteParameter_S__table_vh4_ftg_rmb} {#GlideURI_deleteParameter_S__table_wh4_ftg_rmb__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 4. Retorna]

{#GlideURI_deleteParameter_S__table_wh4_ftg_rmb}  
O exemplo a seguir mostra como excluir um parâmetro de URI.

    // create the GlideURI object
    var uri = action.getGlideURI(); 

    uri.deleteParameter('sysparm_referring_url');

### Equivalente com escopo {#GlideURI_deleteParameter_S__section_bct_nbs_mcb}

Este método não está disponível em aplicações com escopo.

## GlideURI - get(nome da cadeia de caracteres) {#ariaid-title4}

Retorna o valor do parâmetro especificado.
{#GlideURI_get_S__table_bff_yp3_ks__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | O nome do parâmetro. |
[Tabela 5. Parâmetros]

{#GlideURI_get_S__table_bff_yp3_ks} {#GlideURI_get_S__table_cff_yp3_ks__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | O valor do parâmetro especificado. |
[Tabela 6. Retorna]

{#GlideURI_get_S__table_cff_yp3_ks}  

    // create the GlideURI object
    var uri = action.getGlideURI();
    uri.set('sysparm_query', 'priority=2^active=true' );
    var fileString = uri.get('sysparm_query');
    gs.info(fileString);

Saída:

    priority=2^active=true

### Equivalente com escopo {#GlideURI_get_S__section_q2n_wgs_mcb}

Para usar o método get() em uma aplicação com escopo, use o método com escopo correspondente: [GlideURI - get(String name)](https://servicenow-prod.fluidtopics.net/Ehj6XjrIV60ftyiV4ve7FA#r_ScopedGlideURIGet_String "Retorna o valor do parâmetro especificado.").

## GlideURI -- getFileFromPath() {#ariaid-title5}

Retorna a parte do nome do arquivo do URI.
{#GlideURI_getFileFromPath__table_nzz_gs3_ks__entry__3}

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

{#GlideURI_getFileFromPath__table_nzz_gs3_ks} {#GlideURI_getFileFromPath__table_ozz_gs3_ks__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | A parte do nome do arquivo do URI. |
[Tabela 8. Retorna]

{#GlideURI_getFileFromPath__table_ozz_gs3_ks}  

    var gURI = action.getGlideURI();
            
    var fileString = gURI.getFileFromPath();
    gs.info(fileString);

### Equivalente com escopo {#GlideURI_getFileFromPath__section_q2n_wgs_mcb}

Para usar o método getFileFromPath() em uma aplicação com escopo, use o método com escopo correspondente: [GlideURI - getFileFromPath()](https://servicenow-prod.fluidtopics.net/Ehj6XjrIV60ftyiV4ve7FA#r_ScopedGlideURIGetFileFromPath "Retorna a parte do nome do arquivo do URI.").

## GlideURI -- getMap() {#ariaid-title6}

Retorna um mapa (pares de chave-valor) que contém cada parâmetro na consulta e seu valor associado.
{#GlideURI_getMap__table_g2b_b5g_rmb__entry__3}

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

{#GlideURI_getMap__table_g2b_b5g_rmb} {#GlideURI_getMap__table_h2b_b5g_rmb__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto |   |
[Tabela 10. Retorna]

{#GlideURI_getMap__table_h2b_b5g_rmb}  
O exemplo a seguir mostra como obter parâmetros `sysparm_query`. Consulte também [Ação - getGlideURI()](https://servicenow-prod.fluidtopics.net/iqfcZAyryA1nZzOgFW2HpQ#Action_getGlideURI "Obtém um objeto GlideURI para determinar a exibição do usuário.").

    gs.action.getGlideURI().getMap().get('sysparm_query');

### Equivalente com escopo {#GlideURI_getMap__section_bct_nbs_mcb}

Este método não está disponível em aplicações com escopo.

## GlideURI - set (nome da cadeia de caracteres, valor da cadeia de caracteres) {#ariaid-title7}

Define o parâmetro especificado com o valor especificado.
{#GlideURI_set_S_S__table_z2w_tq3_ks__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| nome | Cadeia de caracteres | O nome do parâmetro. |
| valor | Cadeia de caracteres | O valor. |
[Tabela 11. Parâmetros]

{#GlideURI_set_S_S__table_z2w_tq3_ks} {#GlideURI_set_S_S__table_afw_tq3_ks__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 12. Retorna]

{#GlideURI_set_S_S__table_afw_tq3_ks}  
O exemplo a seguir mostra como definir o valor de um campo sysparm_query. Consulte também [Ação - getGlideURI()](https://servicenow-prod.fluidtopics.net/iqfcZAyryA1nZzOgFW2HpQ#Action_getGlideURI "Obtém um objeto GlideURI para determinar a exibição do usuário.").

    var gURI = action.getGlideURI();
    gURI.set('sysparm_query', 'priority=2^active=true' );
    var fileString = gURI.get('sysparm_query');
    gs.info(fileString);

Saída:

    priority=2^active=true

### Equivalente com escopo {#GlideURI_set_S_S__section_q2n_wgs_mcb}

Para usar o método set() em uma aplicação com escopo, use o método com escopo correspondente: [GlideURI - set(String name, String value)](https://servicenow-prod.fluidtopics.net/Ehj6XjrIV60ftyiV4ve7FA#r_ScopedGlideURISet_String_String "Define o parâmetro especificado com o valor especificado.").

## GlideURI - setView (exibição de cadeia de caracteres) {#ariaid-title8}

Adiciona o parâmetro sysparm_view à consulta com a exibição nomeada.
Uma exibição define os elementos que aparecem quando um usuário abre um formulário ou uma lista. O parâmetro sysparm_view especifica a exibição a ser usada para uma lista ou um formulário. Para obter mais informações sobre exibições, consulte [Gestão](https://www.servicenow.com/docs/access?context=view-management-overview&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)de exibições .  
Consulte também:

* [Ação - getGlideURI()](https://servicenow-prod.fluidtopics.net/iqfcZAyryA1nZzOgFW2HpQ#Action_getGlideURI "Obtém um objeto GlideURI para determinar a exibição do usuário.")
* [GlideModalV3 -- switchView()](https://servicenow-prod.fluidtopics.net/JlYMvzrSg495XDgCziTWCA#r_GMODV3-switchView_S "Mude a exibição e recarregue o modal.")
{#GlideURI_setView_S__ul_bll_frk_smb}
{#GlideURI_setView_S__table_tgr_g5g_rmb__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| exibição | Cadeia de caracteres | Nome do parâmetro sysparm_view a ser definido na consulta de URI. |
[Tabela 13. Parâmetros]

{#GlideURI_setView_S__table_tgr_g5g_rmb} {#GlideURI_setView_S__table_ugr_g5g_rmb__entry__2}

| Tipo | Descrição |
|-|-|
| Nenhum(a) |   |
[Tabela 14. Retorna]

{#GlideURI_setView_S__table_ugr_g5g_rmb}  
O exemplo a seguir mostra como adicionar a exibição de incidentes graves à consulta de URI na tabela Incidentes \[incidente\]. Por exemplo, `sysparm_view=Major%20Incidents`. Consulte também [Ação - getGlideURI()](https://servicenow-prod.fluidtopics.net/iqfcZAyryA1nZzOgFW2HpQ#Action_getGlideURI "Obtém um objeto GlideURI para determinar a exibição do usuário.").

    // create the GlideURI object
    var uri = action.getGlideURI(); 

    // Adds the Major incidents to the query
    uri.setView('Major Incidents');

    // https://instance.service-now.com/incident.do?sys_id=0&sysparm_view=Major%20Incidents ...

### Equivalente com escopo {#GlideURI_setView_S__section_bct_nbs_mcb}

Este método não está disponível em aplicações com escopo.

## GlideURI - toString (cadeia de caracteres "path") {#ariaid-title9}

Reconstrói a cadeia de caracteres do URI e executa a codificação de URL apropriada convertendo caracteres inválidos em seu código de URL. Por exemplo, convertendo \& em '%26'.
Os parâmetros definidos com o método set() também são codificados com o URI.
{#GlideURI_toString_S__table_zjw_4r3_ks__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| caminho | Cadeia de caracteres | A parte base da URL do sistema à qual o URI está anexado. |
[Tabela 15. Parâmetros]

{#GlideURI_toString_S__table_zjw_4r3_ks} {#GlideURI_toString_S__table_akw_4r3_ks__entry__2}

| Tipo | Descrição |
|-|-|
| Cadeia de caracteres | A URL. |
[Tabela 16. Retorna]

{#GlideURI_toString_S__table_akw_4r3_ks}  
Os exemplos a seguir mostram como converter caracteres inválidos em código URL em um URL de instância. Consulte também [Ação - getGlideURI()](https://servicenow-prod.fluidtopics.net/iqfcZAyryA1nZzOgFW2HpQ#Action_getGlideURI "Obtém um objeto GlideURI para determinar a exibição do usuário.").

    var gURI = action.getGlideURI();
    fileString = gURI.toString('https://<your instance>.service-now.com/navpage.do');

### Equivalente com escopo {#GlideURI_toString_S__section_q2n_wgs_mcb}

Para usar o método toString() em uma aplicação com escopo, use o método com escopo correspondente: [GlideURI - toString(String path)](https://servicenow-prod.fluidtopics.net/Ehj6XjrIV60ftyiV4ve7FA#r_ScopedGlideURIToString_String "Reconstrói a cadeia de caracteres do URI e executa a codificação de URL apropriada convertendo caracteres inválidos em seu código de URL. Por exemplo, convertendo & em '%26'.").