GlideUser - Scoped

The scoped GlideUser API provides access to information about the current user and current user roles. Using the scoped GlideUser API avoids the need to use the slower GlideRecord queries to get user information.

Scoped GlideUser - getCompanyID()

Returns the current user's company sys_id.

Table 1. Parameters
Name Type Description
None
Table 2. Returns
Type Description
String Company sys_id
var currentUser = gs.getUser(); 
gs.info(currentUser.getCompanyID());

Output:

Scoped GlideUser - getDisplayName()

Returns the current user's display name.

Table 3. Parameters
Name Type Description
None
Table 4. Returns
Type Description
String User's display name
var currentUser = gs.getUser(); 
gs.info(currentUser.getDisplayName());

Output:

Scoped GlideUser - getEmail()

Returns the user's email address.

Table 5. Parameters
Name Type Description
None
Table 6. Returns
Type Description
String User's email address
var currentUser = gs.getUser(); 
gs.info(currentUser.getEmail());

Scoped GlideUser - getFirstName()

Returns the user's first name.

Table 7. Parameters
Name Type Description
None
Table 8. Returns
Type Description
String User's first name
var currentUser = gs.getUser(); 
gs.info(currentUser.getFirstName());

Scoped GlideUser - getID()

Gets the sys_id of the current user.

Table 9. Parameters
Name Type Description
None
Table 10. Returns
Type Description
String User's sys_id
var currentUser = gs.getUser(); 
gs.info(currentUser.getID());

Output:

Scoped GlideUser - getLastName()

Returns the user's last name.

Table 11. Parameters
Name Type Description
None
Table 12. Returns
Type Description
String User's last name
var currentUser = gs.getUser(); 
gs.info(currentUser.getLastName());

Scoped GlideUser - getName()

Returns the user ID, or login name, of the current user.

Table 13. Parameters
Name Type Description
None
Table 14. Returns
Type Description
String User ID
var currentUser = gs.getUser(); 
gs.info(currentUser.getName());

Scoped GlideUser - getPreference(String name)

Gets the specified user preference value for the current user.

Table 15. Parameters
Name Type Description
name String The name of the preference.
Table 16. Returns
Type Description
String The preference value.
var currentUser = gs.getUser(); 
currentUser.savePreference(­'myPref','red'); 
gs.info(currentUser.getPreference(­'myPref'));

Output:

Scoped GlideUser - getRoles()

Returns a list of roles that includes explicitly granted roles, inherited roles, and roles acquired by group membership.

Table 17. Parameters
Name Type Description
None
Table 18. Returns
Type Description
Array List of all roles available to the user
var currentUser = gs.getUser(); 
gs.info(currentUser.getRoles());

Scoped GlideUser - getUserRoles()

Returns the list of roles explicitly granted to the user.

Unlike the getRoles() method, this method does not return roles the user inherits or roles acquired from group membership.

Table 19. Parameters
Name Type Description
None
Table 20. Returns
Type Description
Array List of roles explicitly assigned to the user
var currentUser = gs.getUser(); 
gs.info(currentUser.getUserRoles());

Scoped GlideUser - hasRole(String role)

Determines if the current user has the specified role.

Table 21. Parameters
Name Type Description
role String Role to check
Table 22. Returns
Type Description
Boolean True if the user has the role.
var currentUser = gs.getUser(); 
gs.info(currentUser.hasRole('admin'));

Output:

Scoped GlideUser - isMemberOf(String group)

Determines if the current user is a member of the specified group.

Table 23. Parameters
Name Type Description
group String Group to check
Table 24. Returns
Type Description
Boolean True if the user is a member of the group.
var currentUser = gs.getUser(); 
gs.info(currentUser.isMemberOf(­'Capacity Mgmt'));

Output:

Scoped GlideUser - savePreference(String name, String value)

Saves a user preference value to the database.

Table 25. Parameters
Name Type Description
name String The preference to save.
value String The preference value.
Table 26. Returns
Type Description
void
var currentUser = gs.getUser(); 
currentUser.savePreference('myPref','red'); 
gs.info(currentUser.getPreference('myPref'));

Output: