Данный класс предоставляет методы , которые возвращают информацию и свойства для взаимодействия с информацией о текущем пользователе. Доступ к информации о пользователе осуществляется быстрее при помощи запросов SimpleUser API, чем SimpleRecord.
Свойства
s_user.accessToken
Используйте данный методэто свойство, чтобы получить токен доступа текущего пользователя.
ВозвратВозвращаемое значение:
Токен Возвращает токен доступа текущего пользователя. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | s_user.accessToken |
---|
linenumbers | true |
---|
|
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
Данный метод возвращает Используйте это свойство, чтобы вернуть имя текущего пользователя.
ВозвратВозвращаемое значение:
Имя Возвращает имя текущего пользователя. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | s_user.firstName |
---|
linenumbers | true |
---|
|
console.log(s_user.firstName);
//JohnИван |
s_user.
getPreference(name)lastName
Используйте этот методданное свойство, чтобы получить указанные значения преференций для вернуть фамилию текущего пользователя.
Note |
---|
Это асинхронный метод. Для оптимальной работы используйте ключевое слово async/await, как показано в примере ниже. |
Параметр:
Название | Тип | Обязательный | Дефолтное значение |
---|
name | String или Array | Д | Н |
Возвращаемое значение
Возврат:
Строкой можно передать название только одного предпочтения. В случае, если необходимо передать названия большего количества предпочтений, используйте тип Array, как показано ниже. Тип | Описание |
---|
Object | Этот метод возвращает promise object, содержащий определенные данные. |
Info |
---|
title | getPreference (Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
type)linenumbers | true |
---|
const getMyPreference = async () => {
const response = await s_user.getPreference('preference_name');
}; |
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | getPreference (Array type) |
---|
linenumbers | true |
---|
|
const getMyPreference = async () => {
const response = await s_user.getPreference(['preference_name', 'preference2_name']);
}; |
s_user.getFullName()
Используйте этот метод, чтобы получить полное имя текущего пользователя (значения полей Имя и Фамилия).
Возврат:
Тип | Описание |
---|
String | Имя и фамилия текущего пользователя |
s_user.lastName
Данный метод возвращает фамилию текущего пользователя.
Возврат:
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | s_user.lastName |
---|
linenumbers | true |
---|
|
console.log(s_user.lastName);
//Doe |
s_user.setPreference(name, value)
Данный метод позволяет установить значение указанного предпочтения для текущего пользователя. Для того чтобы получить ранее заданное значение предпочтения, используйте метод s_user.getPreference(name).
Note |
---|
Это асинхронный метод. Для оптимальной работы используйте ключевое слово async/await, как показано в примере ниже. |
Параметры:
Название | Тип | Обязательный | Дефолтное значение |
---|
name | String | Д | Н |
value | String | Д | Н |
Возврат:
Тип | Описание |
---|
Object | Метод возвращает promise object, содержащий указанные данные. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | setPreference |
---|
linenumbers | true |
---|
|
const setMyPreference = async () => {
const response = await s_user.setPreference('menu.tab', 1);
};
// Promise {<pending>}
// [[PromiseState]]: "fulfilled"
// [[PromiseResult]]: ObjectИванов |
s_user.userID
Используйте данный методданное свойство, чтобы получить ID текущего пользователя.
ВозвратВозвращаемое значение:
Значение sys_id Возвращает значение ID текущего пользователя. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | s_user.userID |
---|
linenumbers | true |
---|
|
const currentCaller = new SimpleRecord(s_user.user.essence);
currentCaller.get(s_user.userID, ()=> {
s_form.setValue('email', currentCaller.email);
}); |
s_user.user
Данный метод позволяет получить данные Используйте данное свойство, чтобы получить объект с данными о текущем пользователе, такие такими как имя, фамилия, значение sys_id ID и другие. Метод возвращает SimpleRecord объект в формате JSON.другими.
Возвращаемое значениеВозврат:
Объект SimpleRecord | Объект, содержащий информацию Object | Возвращает объект с информацией о пользователе. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | s_user.user |
---|
linenumbers | true |
---|
|
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
Данный метод позволяет Используйте данное свойство, чтобы получить логин (username) текущего пользователя (например, helpdesk.agent).
ВозвратВозвращаемое значение:
Логин Возвращает логин текущего пользователя. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | s_user.userName |
---|
linenumbers | true |
---|
|
console.log(s_user.userName);
//"admin" |
Методы
s_user.getFullName()
Используйте этот метод, чтобы получить полное имя текущего пользователя (значения полей Имя и Фамилия).
Возвращаемое значение:
Тип | Описание |
---|
String | Метод возвращает имя и фамилию текущего пользователя. |
s_user.getPreference(name)
Используйте этот метод, чтобы получить указанные значения настроек для текущего пользователя.
Note |
---|
Метод является асинхронным. Для оптимальной работы используйте ключевое словоawait,как в примере ниже. |
Параметр:
Название | Тип | Обязательный | Значение по умолчанию |
---|
name | Array of Strings | Да | Нет |
Возвращаемое значение:
Тип | Описание |
---|
Object | Метод возвращает объект Promise, содержащий массив строк. |
Info |
---|
Строкой можно передать название только одной пользовательской настройки. Для того чтобы передать названия большего количества настроек, используйте тип Array, как показано ниже. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | s_user.getFullName(getPreference (String type) |
---|
linenumbers | true |
---|
|
const commentValue getMyPreference = async () => `${{
const response = await s_user.getFullNamegetPreference('preference_name');
}; |
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | getPreference (Array type) |
---|
linenumbers | true |
---|
|
const getMyPreference = async () => {
const response = await s_user.getPreference(['preference_name', 'preference2_name']);
}; |
s_user.setPreference(name, value)
Используйте данный метод, чтобы установить значение указанной настройки для текущего пользователя. Для того чтобы получить ранее заданное значение настройки, используйте метод s_user.getPreference(name).
Note |
---|
Метод является асинхронным. Для оптимальной работы используйте ключевое словоawait,как в примере ниже. |
Параметры:
Название | Тип | Обязательный | Значение по умолчанию |
---|
name | String | Да | Нет |
value | String | Да | Нет |
Возвращаемое значение:
Тип | Описание |
---|
Object | Метод возвращает объект Promise, содержащий данные. |
Пример:
Code Block |
---|
language | js |
---|
theme | Eclipse |
---|
title | setPreference |
---|
linenumbers | true |
---|
|
const setMyPreference = async () => {
const response = await s_user.setPreference('menu.tab', 1);
};
}: "${s_form.getValue('comment')}"`;
s_form.setValue('additional_comment', commentValue); |