Провайдер пользователей

Провайдер пользователей

Сущность "пользователь" или "сотрудник" имеет идентификатор user и реализуется классом Bitrix\Socialnetwork\Integration\UI\EntitySelector\UserProvider.

Данный провайдер реализует поиск и выбор пользователей, а также заполняет данными вкладку "Последние", чтобы она не была пустой.

Диалог выбор пользователя

const button = document.getElementById('responsible-button');
const dialog = new Dialog({
	targetNode: button,
	enableSearch: true,
	context: 'MY_MODULE_CONTEXT',
	entities: [
		{
			id: 'user', // пользователи
			options: {
				inviteEmployeeLink: false // не выводить ссылку "Пригласить сотрудника"
			}
		},
		{
			id: 'department', // структура компании: выбор только пользователей
		},
	],
});
    
button.addEventListener('click', function() {
	dialog.show();
});

Настройки провайдера

• extranetUsersOnly: bool

  Выводить только экстранет-пользователей.



• intranetUsersOnly: bool

  Выводить только интранет-пользователей.



• emailUsers: bool

  Выводить "почтовых пользователей". По умолчанию false — почтовые пользователи не выводятся.



• myEmailUsers: bool

  Выводить почтовых пользователей, которых пригласил текущий пользователь. По умолчанию true. Опция имеет смысл, если emailUsers=true.



• emailUsersOnly: bool

  Выводить только "почтовых" пользователей.



• inviteEmployeeLink: bool

  Выводить ссылку "Пригласить сотрудника". По умолчанию true.



• inviteGuestLink: bool

  Выводить ссылку "Пригласить гостя". По умолчанию false.



• userId: string | int | string[] | int[]

  Идентификатор(ы) пользователей, которые необходимо выбрать (белый список).



• !userId: string | int | string[] | int[]

  Идентификатор(ы) пользователей, которые необходимо исключить (черный список).



• nameTemplate: string

  Шаблон вывода имени пользователя. Допустимые макросы:

  • #NAME# - имя.
  • #LAST_NAME# - фамилия.
  • #SECOND_NAME# - отчество.
  • #NAME_SHORT# - сокращенное имя.
  • #SECOND_NAME_SHORT# - сокращенная фамилия.


• onlyWithEmail: bool

  Выводить пользователей, у которых указан e-mail.



• selectFields: string[]

  Список дополнительных полей профиля пользователя, которые провайдер выберет в customData.

  По умолчанию провайдер выбирает следующие поля:

  • name: string — Имя.
  • lastName: string — Фамилия.
  • secondName: string — Отчество.
  • email: string — E-mail.
  • login: string — Логин.
  • gender: 'M' | 'F' — Пол.
  • position: string — Должность.
  • invited: boolean — Принимает значение true, если пользователь статусе "приглашен".
  • isOnVacation: boolean — Принимает значение true, если пользователь находится в отпуске.

  Дополнительно можно выбрать следующее:

  • lastLogin: string или LAST_LOGIN: string — Дата последнего входа.
  • dateRegister: string или DATE_REGISTER: string — Дата регистрации.
  • lastActivityDate: string или LAST_ACTIVITY_DATE: string — Дата последней активности.
  • online: boolean или IS_ONLINE: boolean — Статус онлайн.
  • name: string или NAME: string — Имя.
  • lastName: string или LAST_NAME: string — Фамилия.
  • secondName: string или SECOND_NAME: string — Отчество.
  • email: string или EMAIL: string — E-mail.
  • login: string или LOGIN: string — Логин.
  • profession: string или personalProfession: string или PERSONAL_PROFESSION: string — Профессия.
  • www: string или personalWww: string или PERSONAL_WWW: string — WWW-страница.
  • birthday: string или personalBirthday: string или PERSONAL_BIRTHDAY: string — Дата рождения.
  • gender: 'M' | 'F' или personalGender: string или PERSONAL_GENDER: string — Пол.
  • icq: string или personalIcq: string или PERSONAL_ICQ: string — ICQ.
  • phone: string или personalPhone: string или PERSONAL_PHONE: string — Телефон.
  • fax: string или personalFax: string или PERSONAL_FAX: string — Факс.
  • mobile: string или personalMobile: string или PERSONAL_MOBILE: string — Мобильный телефон.
  • pager: string или personalPager: string или PERSONAL_PAGER: string — Пейджер.
  • street: string или personalStreet: string или PERSONAL_STREET: string — Улица, дом.
  • city: string или personalCity: string или PERSONAL_CITY: string — Город.
  • state: string или personalState: string или PERSONAL_STATE: string — Область / край.
  • zip: string или personalZip: string или PERSONAL_ZIP: string — Почтовый индекс.
  • mailbox: string или personalMailbox: string или PERSONAL_MAILBOX: string — Почтовый ящик.
  • country: string или personalCountry: string или PERSONAL_COUNTRY: string — Страна.
  • timeZoneOffset: number или TIME_ZONE_OFFSET: number — Смещение таймзоны.
  • company: string или WORK_COMPANY: string — Компания.
  • position: string или WORK_POSITION: string — Должность.
  • workPhone: string или WORK_PHONE: string — Рабочий телефон.
  • workCity: string или WORK_CITY: string — Город компании.
  • workCountry: string или WORK_COUNTRY: string — Страна компании.
  • workDepartment: string или WORK_DEPARTMENT: string — Департамент / Отдел.
  • workMailbox: string или WORK_MAILBOX: string — Почтовый
  • workCity: string или WORK_CITY: string — Город компании.
  • workCountry: string или WORK_COUNTRY: string — Страна компании.
  • workStreet: string или WORK_STREET: string — Улица, дом компании.
  • workState: string или WORK_STATE: string — Область / край компании.
  • workZip: string или WORK_ZIP: string — Почтовый индекс компании.
  • workMailbox: string или WORK_MAILBOX: string — Почтовый ящик компании.
  • ufPhoneInner: string или UF_PHONE_INNER: string — Внутренний телефон.
  • ufDistrict: string или UF_DISTRICT: string — Район.
  • ufSkype: string или UF_SKYPE: string — Логин Skype.
  • ufSkypeLink: string или UF_SKYPE_LINK: string — Ссылка на чат в Skype.
  • ufZoom: string или UF_ZOOM: string — Zoom.
  • ufTwitter: string или UF_TWITTER: string — Twitter.
  • ufFacebook: string или UF_FACEBOOK: string — Facebook*.

    * Социальная сеть признана экстремистской и запрещена на территории Российской Федерации.

  • ufLinkedin: string или UF_LINKEDIN: string — LinkedIn.
  • ufXing: string или UF_XING: string — Xing.
  • ufWebSites: string или UF_WEBSITES: string — Другие сайты.
  • ufSkills: string или UF_SKILLS: string — Навыки.
  • ufInterests: string или UF_INTERESTS: string — Интересы.
  • ufEmploymentDate: string или UF_EMPLOYMENT_DATE: string — Дата принятия на работу.