Поля с фильтрами

Поля с фильтрами — что это

Приложение добавляет в Битрикс24 новый тип пользовательского поля. Такое поле связывает карточку CRM с другими записями портала, но в отличие от обычной привязки показывает не весь справочник, а только те записи, которые прошли заданный вами фильтр.

Какие задачи решает

• Сотрудник выбирает нужное значение сразу, не пролистывая сотни лишних записей.
  
• Исключены ошибки выбора: в списке физически нет записей, которые в этой ситуации выбирать нельзя.
  
• Один и тот же справочник можно подать по-разному в разных полях — например, «Ответственный монтажник» и «Ответственный водитель» берут сотрудников из одного источника, но с разными фильтрами.
  
• Фильтр можно оставить открытым — тогда сотрудник сам задаёт значение прямо в карточке, а не только администратор при настройке.
  

Что можно выбирать в поле

• Элементы CRM: лиды, сделки, контакты, компании, а также смарт-процессы и другие типы CRM портала.
  
• Элементы универсальных списков.
  
• Элементы процессов в ленте новостей.
  
• Сотрудников портала — с фильтрами по полям профиля, включая пользовательские. Как приложение работает с полями профиля, описано в отдельном разделе ниже.
  

Как приложение работает с полями профиля сотрудника

Это касается только полей, где источником выбраны сотрудники портала. Приложение не изменяет профили сотрудников, не создаёт в них поля и не записывает в них значения — взаимодействие только на чтение.

• При настройке поля администратором приложение читает описание полей профиля: названия, типы и наборы значений у списочных полей (методы user.fields и user.userfield.list, право «Пользовательские поля пользователя»), а также названия подразделений (department.get). По этим данным администратор выбирает поле профиля, условие и значение фильтра — например, «Должность равно Монтажник» — из готового справочника, без ввода внутренних идентификаторов.
  
• При выборе значения в карточке CRM приложение запрашивает список подходящих сотрудников (user.get) с заданным фильтром — имя, фамилию и должность для показа в окне выбора. Если условие оставлено открытым, сотрудник выбирает его значение из того же справочника полей профиля.
  

Список сотрудников запрашивается от имени текущего пользователя, с его правами доступа. Описание полей профиля Битрикс24 отдаёт только администратору портала, поэтому для остальных сотрудников оно запрашивается от имени приложения — это справочная информация о структуре полей, без данных сотрудников.

Список сотрудников формируется в момент показа и на сервере приложения не сохраняется. Хранятся только настройки фильтра: код поля, условие и значение.

Право «Пользовательские поля пользователя» необязательное: без него приложение работает, но пользовательские поля профиля обрабатываются как обычный текст — без выбора значения из справочника.

Условия фильтра

Равно, Не равно, Содержит, Не содержит, Заполнено, Не заполнено, Больше, Меньше. Сравнения «больше/меньше» работают и для чисел, и для дат. Условие «Не равно» включает записи с незаполненным значением — то есть работает как настоящее отрицание равенства, а не как «заполнено и не равно».

Как работает в карточке

• Выбор одного значения или нескольких — задаётся при создании поля.
  
• Список подгружается порциями по мере прокрутки, ничего не выгружается заранее: окно выбора открывается одинаково быстро и на сотне записей, и на сотнях тысяч.
  
• Поиск по названию и по ID.
  
• Выбранные записи показываются ссылками — переход в карточку в один клик.
  

Требования и ограничения

• Приложение не работает в мобильном приложении Битрикс24. Поле не отображается в карточках CRM на телефоне и планшете — ни для просмотра, ни для редактирования. Это ограничение платформы: мобильное приложение Битрикс24 не отрисовывает пользовательские типы полей, которые предоставляются приложениями через REST. Работать с полем можно в веб-версии портала. Уже сохранённые значения при этом не теряются — они хранятся в самом Битрикс24, и остальные поля карточки на мобильном отображаются как обычно.
  
• Поле размещается только на сущностях CRM: лиды, сделки, контакты, компании, смарт-процессы. На задачах, в универсальных списках и в других разделах портала поле создать нельзя — там их можно только выбирать как источник.
  
• Создавать и настраивать поля может только администратор портала. Пользоваться готовыми полями в карточках может любой сотрудник в рамках своих прав доступа.
  
• Универсальные списки и процессы в ленте новостей доступны не во всех тарифах Битрикс24. Если раздел на портале недоступен, соответствующий источник в списке не появится.
  
• Сотрудник видит в списке выбора только те записи, к которым у него есть доступ по правам CRM: приложение выполняет запросы от его имени, а не от имени администратора.
  
• Дополнительное ПО, сторонние сервисы и установка других решений не требуются.
  

Данные

Значения полей хранятся в самом Битрикс24. Приложение хранит только настройки фильтров и служебные ключи подключения к порталу. Персональные данные сотрудников и клиентов на стороне приложения не сохраняются — в том числе списки сотрудников и данные их профилей: они запрашиваются у Битрикс24 в момент показа.

Удаление

Поля удаляются из настроек приложения по одному. Удаление самого приложения поля не удаляет — данные в карточках остаются на месте.