GlideSystem (gs) sample scripts
The scoped GlideSystem (referred to by the variable name 'gs' in any server-side JavaScript) API provides a number of convenient methods to get information about the system, the current logged in user, etc.
Refer the below operations for more details.
Get User
Returns a reference to the user object for the currently logged-in user.
var userObject = gs.getUser();
Get User By ID
Returns a reference to the user object for the user ID (or sys_id) provided.
var userObject = gs.getUser().getUserByID('john_smith');
Get User ID
Returns the sys_id string value for the currently logged-in user.
var userID = gs.getUserID();
Get User Name
Returns the User ID (user_name) for the currently logged-in user.
var userObject = gs.getUserName();
Get User Display Name
Returns the display value for the currently logged-in user. i.e. 'John Smith'
var userObject = gs.getUserDisplayName();
Get First Name
Returns the first name of the currently logged-in user.
var firstName = gs.getUser().getFirstName();
Get Last Name
Returns the last name of the currently logged-in user.
var lastName = gs.getUser().getLastName();
Get Email
Returns the email address of the currently logged-in user.
var email = gs.getUser().getEmail();
Get Department ID
Returns the department sys_id of the currently logged-in user.
var deptID = gs.getUser().getDepartmentID();
Get Language
Returns the language of the currently logged-in user.
var language = gs.getUser().getLanguage();
Get Location
Returns the location of the currently logged-in user.
var location = gs.getUser().getLocation();
Get Manager ID
Returns the manager sys_id of the currently logged-in user.
var managerID = gs.getUser().getManagerID();
Get My Groups
Returns a list of all groups that the currently logged-in user is a member of.
var groups = gs.getUser().getMyGroups();
isMemberOf
Returns true if the user is a member of the given group, false otherwise.
var isMember = gs.getUser().isMemberOf();
hasRole
Returns true if the user has the given role, false otherwise.
if (gs.hasRole('snc_internal')) {
// do something
}
(OR)
Returns true if the user has one of the given roles, false otherwise.
if (gs.hasRole('hr', 'itil')) {
// do something
}
hasRoles
Returns true if the user has any roles at all, false if the user has no role (i.e. an ess user).
if (gs.getUser.hasRoles() {
// do something
}
Log Info
Log an informational message.
gs.info('This is an informational message.');
Print the name of the current user.
gs.print('Current user: ' + userName);
setRedirect
The gs.setRedirect() method in ServiceNow is used to redirect users to a specified URL or ServiceNow page.
// Redirect the user to a specific URL
gs.setRedirect('https://www.example.com');
(OR)
// Redirect the user to a specific ServiceNow page (incident list)
gs.setRedirect('incident_list.do');