GlideURI - Global

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
• Pilha de navegação

Consulte também Ação - getGlideURI().

GlideURI – deleteMatchingParameter(cadeia de caracteres correspondente)

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

Tabela 1. Parâmetros

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 2. Retornos

Tipo	Descrição
Nenhum(a)

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

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

GlideURI – deleteParameter(cadeia de caracteres nome)

Remove um parâmetro especificado da parte de consulta do URI.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
nome	Cadeia de caracteres	Nome do parâmetro a ser removido da parte de consulta de um URI.

Tabela 4. Retornos

Tipo	Descrição
Nenhum(a)

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

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

GlideURI - get(nome da cadeia de caracteres)

Retorna o valor do parâmetro especificado.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
nome	Cadeia de caracteres	O nome do parâmetro.

Tabela 6. Retornos

Tipo	Descrição
Cadeia de caracteres	O valor do parâmetro especificado.

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

Para usar o método get() em uma aplicação com escopo, use o método com escopo correspondente: GlideURI - get(String name).

GlideURI – getFileFromPath()

Retorna a parte do nome do arquivo do URI.

Tabela 7. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 8. Retorna

Tipo	Descrição
Cadeia de caracteres	A parte do nome do arquivo do URI.

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

Equivalente com escopo

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

GlideURI – getMap()

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

Tabela 9. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 10. Retorna

Tipo	Descrição
Objeto

O exemplo a seguir mostra como obter parâmetros sysparm_query. Consulte também Ação - getGlideURI().

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

Equivalente com escopo

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)

Define o parâmetro especificado com o valor especificado.

Tabela 11. Parâmetros

Nome	Tipo	Descrição
nome	Cadeia de caracteres	O nome do parâmetro.
valor	Cadeia de caracteres	O valor.

Tabela 12. Retornos

Tipo	Descrição
Nenhum(a)

O exemplo a seguir mostra como definir o valor de um campo sysparm_query. Consulte também Ação - getGlideURI().

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

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

GlideURI - setView (exibição de cadeia de caracteres)

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 de exibições.

Consulte também:

• Ação - getGlideURI()
• GlideModalV3 – switchView()

Tabela 13. Parâmetros

Nome	Tipo	Descrição
exibição	Cadeia de caracteres	Nome do parâmetro sysparm_view a ser definido na consulta de URI.

Tabela 14. Retornos

Tipo	Descrição
Nenhum(a)

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().

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

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

GlideURI - toString (cadeia de caracteres "path")

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.

Tabela 15. Parâmetros

Nome	Tipo	Descrição
caminho	Cadeia de caracteres	A parte base da URL do sistema à qual o URI está anexado.

Tabela 16. Retornos

Tipo	Descrição
Cadeia de caracteres	A URL.

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().

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

Equivalente com escopo

Para usar o método toString() em uma aplicação com escopo, use o método com escopo correspondente: GlideURI - toString(String path).