Класс DialogManager

Используется для отображения стандартных диалогов.

TIP

Работу с B24Frame.parent можно протестировать в примере.

Методы

selectUser

async selectUser(): Promise<null|SelectedUser>

Отображает стандартный диалог выбора одного пользователя.

Показывает только сотрудников компании.

Возвращает Promise, который разрешается в null или объект SelectedUser

Аналог функции

// ... /////
$b24 = await initializeB24Frame()
// ... /////
const makeSelectUsers = async() => {
	const selectedUser = await $b24.dialog.selectUser()
	$logger.info(selectedUser)
}

selectUsers

async selectUsers(): Promise<SelectedUser[]>

Отображает стандартный диалог выбора нескольких пользователей.

Показывает только сотрудников компании.

Возвращает Promise, который разрешается в массив объектов SelectedUser

Аналог функции

// ... /////
$b24 = await initializeB24Frame()
// ... /////
const makeSelectUsers = async() => {
	const selectedUsers = await $b24.dialog.selectUsers()
	
	const list = selectedUsers.map((row: SelectedUser): string => {
		return [ `[id: ${row.id}]`, row.name ].join(' ')
	})
	
	$logger.info(selectedUsers, list)
}

Типы данных

SelectedUser

Используется для представления информации о выбранном пользователе в приложении Битрикс24. Он содержит несколько полей, которые описывают идентификатор пользователя, его имя, фото, должность и другие характеристики.

Поля sub и sup помогают определить иерархические отношения между текущим пользователем и выбранным пользователем.

• id: NumberString: Идентификатор пользователя. Представлен в виде строки, содержащей числовое значение.
• name: string: Отформатированное имя пользователя.
• photo: string: URL фотографии пользователя.
• position: string: Должность пользователя в компании.
• url: string: URL профиля пользователя.
• sub: boolean: Флаг, указывающий, что выбранный пользователь является подчиненным текущего пользователя. Значение true означает, что пользователь подчиненный.
• sup: boolean: Флаг, указывающий, что выбранный пользователь является руководителем текущего пользователя. Значение true означает, что пользователь руководитель.