system.user.getUser
Looks up a specific user in a user source, by username. The full User object is returned except for the user's password.
system.user. getUser( userSource, username )
-
Parameters
String userSource - The name of the user source to search for the user in.
String username - The username of the user to search for.
-
Returns
User - A User object.
-
Scope
All
The "User" object that is returned contains all of the information about that user, except for the user's password. You can access most of the basic user properties via a call to "get" or "getOrDefault" which returns a default value if the requested item is not present. For example:
user.getOrDefault(user.Schedule)
...will return that user's schedule, or the value of "Always" if no schedule has been set as that is the default schedule. The following are the various values you may use in this manner:
-
user.Username
-
user.FirstName
-
user.LastName
-
user.Notes
-
user.Schedule
-
user.Language
In addition to these properties, the user object has other methods on it to retrieve more information:
-
user.getId() - returns the internal identifier object that the backing user source needs to identify this user
-
user.getRoles() - returns a sequence of strings representing the roles that this user belongs to
-
user.getContactInfo() - returns a sequence of ContactInfo objects. Each of these objects will have a contactType and valueproperty representing the contact information, both strings.
-
user.getScheduleAdjustments() - returns a sequence of ScheduleAdjustment objects. Each of these objects will have two date properties, "start" and "end", a boolean property, "available", and a string property called "note".
-
user.getPath() - returns a QualifiedPath object that represents this user in a deterministic manner.
#This example will print the first and last name of the current user using the default datasource:
userName
=
system.security.getUsername()
user
=
system.user.getUser("", userName)
print
user.get(user.FirstName)
+
" "
+
user.get(user.LastName)