GlideURI - Scoped

The GlideURI API provides methods to handle URI parameters in a scoped 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: GlideURI - Global .

Scoped GlideURI - GlideURI()

Instantiates a GlideURI object.

Table 1. Parameters

Name	Type	Description
None

Scoped GlideURI - get(String name)

Returns the value of the specified parameter.

Table 2. Parameters

Name	Type	Description
name	String	The parameter name.

Table 3. Returns

Type	Description
String	The value for the specified parameter.

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

Output:

priority=2^active=true

Scoped GlideURI - getFileFromPath()

Returns the file name portion of the URI.

Table 4. Parameters

Name	Type	Description
None

Table 5. Returns

Type	Description
String	The file name portion of the URI.

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

Scoped GlideURI - set(String name, String value)

Sets the specified parameter to the specified value.

Table 6. Parameters

Name	Type	Description
name	String	The parameter name.
value	String	The value.

Table 7. Returns

Type	Description
None

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

Output:

priority=2^active=true

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

Table 8. Parameters

Name	Type	Description
path	String	The base portion of the system URL to which the URI is appended.

Table 9. Returns

Type	Description
String	The URL.

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