GlideURI - Global

. GlideURI A API fornece métodos para lidar com parâmetros de URI em uma aplicação global.

Nota:

Não use GlideURI API 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 (correspondência de cadeia de caracteres)

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(nome da cadeia de caracteres)

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. get() em uma aplicação com escopo, use o método com escopo correspondente: GlideURI - GET (nome da cadeia de caracteres) .

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. GetFileFromPath() em uma aplicação com escopo, use o método com escopo correspondente: GlideURI - getFileFromPath() .

GlideURI - GetMap()

Retorna um mapa (pares de valor de chave) 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 sysparm_query parâmetros. 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. set() em uma aplicação com escopo, use o método com escopo correspondente: GlideURI - Set (nome da cadeia de caracteres, valor da cadeia de caracteres) .

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

Adiciona o. sysparm_viewparâmetro para a 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. . sysparm_viewo parâmetro 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ção .

Consulte também:

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

Tabela 13. Parâmetros

Nome	Tipo	Descrição
exibição	Cadeia de caracteres	Nome do sysparm_viewParâmetro 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 Incidentes graves à consulta de URI na tabela Incidentes [incidente]. Por exemplo, _view_major%20Incidentes . 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 (caminho da cadeia de caracteres)

Reconstrói a cadeia de caracteres URI e executa a codificação de URL apropriada convertendo caracteres inválidos em seu código de URL. Por exemplo, convertendo & para '%26'.

Parâmetros definidos com set() Os métodos 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	O URL.

Os exemplos a seguir mostram como converter caracteres inválidos em código de URL em uma 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. ToString() em uma aplicação com escopo, use o método com escopo correspondente: GlideURI - toString (caminho da cadeia de caracteres) .