GlideUser - Global

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：18分

    • The GlideUser API provides methods to access information about the current user and current user roles.

    Using the GlideUser API avoids the need to use the slower GlideRecord queries to obtain user information.

    GlideUser - getCompanyID()

    Returns the current user's company sys_id.

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

    Scoped equivalent

    To use the getCompanyID() method in a scoped application, use the corresponding scoped method: getCompanyID().

    GlideUser - getDisplayName()

    Returns the current user's display name.

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

    Scoped equivalent

    To use the getDisplayName() method in a scoped application, use the corresponding scoped method: getDisplayName().

    GlideUser - getDomainDisplayValue()

    Returns the display value of the user's session domain.

    表 : 5. Parameters
    Name Type Description
    None
    表 : 6. Returns
    Type Description
    String The display value of the user's session domain. 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getDomainDisplayValue());

    Scoped equivalent

    There is no workaround for scoped applications.

    GlideUser - getDomainID()

    Returns the identifier of the user's current session domain.

    The identifier that is returned depends on the domain type and the instantiation of that domain.

    • If the user is configured in the global domain, and does not use the domain picker to switch domains, the method returns null.
    • If the user uses the domain picker to switch to the global domain, the method returns the string "global".
    • For all other domains, the method returns the sys_id of that domain.
    表 : 7. Parameters
    Name Type Description
    None
    表 : 8. Returns
    Type Description
    String Domain identifier. 
    var domain = new GlideRecord('domain');
domain.get(gs.getUser().getDomainID());
gs.info(domain.name);

    GlideUser - getEmail()

    Returns the user's email address.

    表 : 9. Parameters
    Name Type Description
    None
    表 : 10. Returns
    Type Description
    String User's email address 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getEmail());

    Scoped equivalent

    To use the getEmail() method in a scoped application, use the corresponding scoped method: getEmail().

    GlideUser - getFirstName()

    Returns the user's first name.

    表 : 11. Parameters
    Name Type Description
    None
    表 : 12. Returns
    Type Description
    Object/String User's first name.
    注:
    The data type for the returned value is object, however, the information is returned as a string.
    		 
    var currentUser = gs.getUser(); 
var userName = currentUser.getFirstName();
gs.info('User First Name: + userName);
gs.info('Data type: ' + typeof userName);
    *** Script: User First Name: John
*** Script: Data type: object

    Scoped equivalent

    To use the getFirstName() method in a scoped application, use the corresponding scoped method: getFirstName().

    GlideUser - getID

    Returns the sys_id of the current user.

    表 : 13. Parameters
    Name Type Description
    None
    表 : 14. Returns
    Type Description
    String User's sys_id 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getID());

    Scoped equivalent

    To use the getID() method in a scoped application, use the corresponding scoped method: getID().

    GlideUser - getLastName()

    Returns the user's last name.

    表 : 15. Parameters
    Name Type Description
    None
    表 : 16. Returns
    Type Description
    Object/String User's last name.
    注:
    The data type for the returned value is object, however, the information is returned as a string.
    		 
    var currentUser = gs.getUser(); 
var userName = currentUser.getLastName();
gs.info('User Last Name: + userName);
gs.info('Data type: ' + typeof userName);
    *** Script: User Last Name: Smith
*** Script: Data type: object

    Scoped equivalent

    To use the getLastName() method in a scoped application, use the corresponding scoped method: getLastName().

    GlideUser - getMyGroups()

    Returns an iterator containing the list of all groups to which the user belongs. Only active groups are returned.

    表 : 17. Parameters
    Name Type Description
    None
    表 : 18. Returns
    Type Description
    iterator A list of sys_ids for the active groups to which the user belongs.

    The following example shows how to return a list of groups the user belongs to.

    var groupsArray = gs.getUser().getMyGroups().toArray();
gs.info(groupsArray[0]);
    Output:
    cfcbad03d711110050f5edcb9e61038f

    Scoped equivalent

    There is no scoped equivalent for this method.

    GlideUser - getName()

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

    表 : 19. Parameters
    Name Type Description
    None
    表 : 20. Returns
    Type Description
    String User ID 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getName());

    Scoped equivalent

    To use the getName() method in a scoped application, use the corresponding scoped method: getName().

    GlideUser - getRoles()

    Returns a list of roles associated with the user. Includes explicitly granted roles, inherited roles, and roles acquired by group membership.

    表 : 21. Parameters
    Name Type Description
    None
    表 : 22. Returns
    Type Description
    Object Comma-separated list of user roles. 
    var currentUser = gs.getUser(); 
gs.info(currentUser.getRoles());

    Output:

    admin,hr_fulfiller,itsa_fulfiller,security_admin

    Scoped equivalent

    To use the getRoles() method in a scoped application, use the corresponding scoped method: getRoles().

    GlideUser - getTimeZoneLabel()

    Returns the current user's time zone label in the current user's preferred language.

    For more information about setting a user's preferred language, see User specific language.

    表 : 23. Parameters
    Name Type Description
    None
    表 : 24. Returns
    Type Description
    String The current user's time zone label.

    This example shows how to return the current user's time zone label in their preferred language.

    gs.info(gs.getUser().getTimeZoneLabel());

    Output:

    Europe/Dublin

    GlideUser - getTimeZoneLabelLang(String language)

    Returns the current user's time zone label in the specified language.

    表 : 25. Parameters
    Name Type Description
    language String Language to use for the time zone label. Located in the ID column of the Language [sys_language] table.

    If a valid language isn't provided, the time zone label is returned in English.
    表 : 26. Returns
    Type Description
    String The current user's time zone label.

    This example shows how to return the current user's time zone label in a specified language.

    gs.info(gs.getUser().getTimeZoneLabelLang("es")); //Spanish
gs.info(gs.getUser().getTimeZoneLabelLang("ja")); //Japanese
gs.info(gs.getUser().getTimeZoneLabelLang("jksjsjks")); //invalid

    Output:

    Europa/Dublín
ヨーロッパ/ダブリン
Europe/Dublin

    GlideUser - getUserByID (String id)

    Returns the user object associated with the passed-in user ID (sys_id in sys_user) or user_name.

    表 : 27. Parameters
    Name Type Description
    id String Unique ID (sys_id) or user_name of the desired user record.
    表 : 28. Returns
    Type Description
    Object User object associated with the specified sys_id or user_name.

    Example using user name (user_name).

    var currentUser = gs.getUser();
gs.info(currentUser.getFirstName()); // print the first name of the logged in user
var newUser = currentUser.getUserByID('abel.tuter'); // fetch a different user using the user_name field
gs.info(newUser.getFirstName()); // print the first name of the Abel Tuter user

    Example using user ID (sys_id).

    var currentUser = gs.getUser();
gs.info(currentUser.getFirstName()); // print the first name of the logged in user
var newUser = currentUser.getUserByID('62826bf03710200044e0bfc8bcbe5df1'); // fetch Abel Tuter user using sys_id from sys_user record
gs.info(newUser.getFirstName()); // print the first name of the Abel Tuter user

    GlideUser - getUserRoles()

    Returns the list of roles explicitly granted to the user.

    表 : 29. Parameters
    Name Type Description
    None
    表 : 30. Returns
    Type Description
    Object/String List of comma-separated roles explicitly assigned to the user.
    注:
    The data type for the returned value is object, however, the information is returned as a string.
    		 
    var currentUser = gs.getUser(); 
var userRoles = currentUser.getUserRoles();
gs.info('User Roles: ' + userRoles);
gs.info('Data type: ' + typeof userRoles);
    *** Script: User Roles: ,admin,security_admin
*** Script: Data type: object

    Scoped equivalent

    To use the getUserRoles() method in a scoped application, use the corresponding scoped method: getUserRoles().

    GlideUser - hasRole(String role)

    Determines if the current user has the specified role.

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

    Scoped equivalent

    To use the hasRole() method in a scoped application, use the corresponding scoped method: hasRole().

    GlideUser - isExplicitMemberOf(String group)

    Determines if the current user is an explicit member of the specified group. Only active groups are evaluated by this method.

    The isMemberOf() method returns true for a parent group if the user is a member of the child group. Use this method if you only want to return true for parent groups.

    表 : 33. Parameters
    Name Type Description
    group String Sys_id of the user group to check.
    表 : 34. Returns
    Type Description
    Boolean

    Flag that indicates whether the current user is an explicit member of the specified group.

    Valid values:
    • true: The current user is an explicit member of the specified group.
    • false: The current user is not an explicit member of the specified group.

    The following example shows how to check if the current user is an explicit member of the specified group.

    var isExplMem = gs.getUser().isExplicitMemberOf('b8ef24616fc331003b3c498f5d3ee434');
gs.info(isExplMem);

    Output:

    false

    Scoped equivalent

    There is no scoped equivalent for this method.

    GlideUser - isMemberOf(String group)

    Determines if the current user is a member of the specified group. Only active groups are evaluated by this method.

    This method returns true for a parent group if the user is a member of the child group. Use the isExplicitMemberOf() if you only want to return true for parent groups.

    表 : 35. Parameters
    Name Type Description
    group String Sys_id or name of the group to check.
    表 : 36. Returns
    Type Description
    Boolean Flag that indicates whether the user is a member of the specified group.
    Possible values:
    • true: User is a member of the group.
    • false: User isn't a member of the group.

    The following example checks if the current user is a member of the Capacity Mgmt group.

    var currentUser = gs.getUser(); 
gs.info(currentUser.isMemberOf('Capacity Mgmt'));

    Output:

    false

    Scoped equivalent

    To use the isMemberOf() method in a scoped application, use the corresponding scoped method: isMemberOf().