This class provides methods and properties for operating information about the current user. SimpleUser API is faster than SimpleRecord queries in terms of accessing user information.

Propereties

s_user.accessToken


Use this class property to get an access token of the current user.

Return:

TypeDescription
StringReturns an access token of the current user.

Example:

s_user.accessToken
const url = new URL(`${API_BASE_URL}/export/json/${s_list.getTablesName()[0]}`);
url.searchParams.set('access-token', s_user.accessToken);
url.searchParams.set('condition', s_list.getQuery());
window.open(url, "_blank");

s_user.firstName


Use this property to get the first name of the current user.

Return:

TypeDescription
StringReturns the first name of the current user.

Example:

s_user.firstName
console.log(s_user.firstName);
//John

s_user.lastName


Use this property to get the last name of the current user.

Return:

TypeDescription
StringReturns the last name of the current user.

Example:

s_user.lastName
console.log(s_user.lastName);
//Doe

s_user.userID


Use this property to get the ID of the current user.

Return:

TypeDescription
StringReturns the ID value for the current user.

Example:

s_user.userID
const currentCaller = new SimpleRecord(s_user.user.essence);
currentCaller.get(s_user.userID, ()=> {
  s_form.setValue('email', currentCaller.email);
});

s_user.user


This property stores an object with the user data of the current user, such as first name, last name, ID value, and other. 

Return:

TypeDescription
ObjectReturns an object that contains user information.

Example:

s_user.user
console.log(JSON.stringify(s_user.user, null, 2));
/*"{
  "sys_id": "155931135900000001",
  "first_name": "Admin",
  "last_name": "Admin",
  "username": "admin",
  "essence": "user",
  "timezone": "Europe/Moscow",
  "language": "en",
  "photo_path": null,
  "elevate_access": -1,
  "version": "1.3.6",
  "dictionary": {...},
  "impersonate_state": null
}"*/

s_user.userName


Use this property to get the login (username) of the current user (for example, helpdesk.agent).

Return:

TypeDescription
StringReturns the username of the current user.

Example:

s_user.userName
console.log(s_user.userName);
//"admin"

Methods

s_user.getFullName()


Use this method to get the full name of the current user (the values of the First name and Last name fields).

Return:

TypeDescription
StringThis method returns the first and the last name of the current user.

s_user.getPreference(name)


Use this method to get the specified preference values for the current user.

Note that this method is asynchronous; for better performance, use the await keyword, as in the code example below.

Parameter(s):

NameTypeMandatoryDefault value
nameArray of StringsYN

Return:

TypeDescription
ObjectThis method returns a Promise object that contains specific data.

It is possible to pass a single preference name as a string. To pass more than one preference names, use the Array type, as shown in the code example below.

Example:

getPreference (String type)
const getMyPreference = async () => {
    const response = await s_user.getPreference('preference_name');
};
getPreference (Array type)
const getMyPreference = async () => {
    const response = await s_user.getPreference(['preference_name', 'preference2_name']);
};

s_user.setPreference(name, value)


Use this method to define a value to the specified preference for the current user. To get a value of a previously set preference, use the s_user.getPreference(name) method.

Note that this method is asynchronous; for better performance, use the  await keyword, as shown in the code example below.

Parameters:

NameTypeMandatoryDefault value
nameStringYN
valueStringYN

Return:

TypeDescription
ObjectThis method returns a Promise object that contains specific data.

Example:

setPreference
const setMyPreference = async () => {
    const response = await s_user.setPreference('menu.tab', 1);
};