GlideURI- Global

The GlideURI API provides methods to handle URI parameters in a global application.

Note: Do not use the GlideURI API in scripts that are executed during export or in background jobs.

For more information on using URIs:

• Navigate by URL
• Navigation stack

See also Action - getGlideURI().

Parent Topic:Server API reference

GlideURI - deleteMatchingParameter(String match)

Deletes one or more parameters from the URI that match the beginning of the provided string.

The following example shows how to delete URI parameters that partially match the name provided.

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

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

Scoped equivalent

This method is not available in scoped applications.

GlideURI - deleteParameter(String name)

Removes a specified parameter from the query portion of the URI.

The following example shows how to delete a URI parameter.

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

uri.deleteParameter('sysparm_referring_url');

Scoped equivalent

This method is not available in scoped applications.

GlideURI - get(String name)

Returns the value of the specified parameter.

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

Output:

priority=2^active=true

Scoped equivalent

To use the get() method in a scoped application, use the corresponding scoped method: GlideURI - get(String name) .

GlideURI - getFileFromPath()

Returns the file name portion of the URI.

var gURI = action.getGlideURI();

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

Scoped equivalent

To use the getFileFromPath() method in a scoped application, use the corresponding scoped method: GlideURI - getFileFromPath() .

GlideURI - getMap()

Returns a map (key value pairs) containing each parameter in the query and its associated value.

The following example shows how to get sysparm_query parameters. See also Action - getGlideURI() .

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

Scoped equivalent

This method is not available in scoped applications.

GlideURI - set(String name, String value)

Sets the specified parameter to the specified value.

The following example shows how to set value of a sysparm_query field. See also Action - getGlideURI() .

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

Output:

priority=2^active=true

Scoped equivalent

To use the set() method in a scoped application, use the corresponding scoped method: GlideURI - set(String name, String value) .

GlideURI - setView(String view)

Adds the sysparm_view parameter to the query with the named view.

A view defines the elements that appear when a user opens a form or a list. The sysparm_view parameter specifies the view to be used for a list or a form. For more information on views, see View management.

See also:

• Action - getGlideURI()
• GlideModalV3 - switchView()

The following example shows how to add the major incidents view to the URI query in the Incidents [incident] table. For example, sysparm_view=Major%20Incidents. See also Action - 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 ...

Scoped equivalent

This method is not available in scoped applications.

GlideURI - toString(String path)

Reconstructs the URI string and performs the proper URL encoding by converting non-valid characters to their URL code. For example, converting & to '%26'.

Parameters set with the set() method are encoded with the URI as well.

The following examples shows how to convert invalid characters to URL code in an instance URL. See also Action - getGlideURI() .

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

Scoped equivalent

To use the toString() method in a scoped application, use the corresponding scoped method: GlideURI - toString(String path) .