Кастомные поля Битрикс24
В этой статье описана работа с кастомными полями Битрикс24 в LightLead.
Обнаружение кастомных полей
Кастомные поля загружаются из CF_ или UF_CRM_. Кастомные поля в Битрикс24 имеют префикс CF_ (новый формат) или UF_CRM_ (старый формат). При обнаружении LightLead считывает оба типа. Переименование поля не меняет его идентификатор, сопоставление сохраняется.
Сопоставление полей
LightLead использует идентификатор поля (field_id или field_code) для сопоставления. Это обеспечивает:
Устойчивость к переименованию: при изменении названия поля в CRM сопоставление сохраняется
Уникальность: каждое поле идентифицируется однозначно
Кросс-аккаунтность: поля из разных аккаунтов не пересекаются
Типы кастомных полей
| Тип поля | Поддержка | Использование |
|---|---|---|
| Текст (text) | Полная | Группировка, фильтрация |
| Число (number) | Полная | Метрики, фильтрация по диапазону |
| Дата (date) | Полная | Фильтрация по периоду |
| Список (select) | Полная | Группировка, фильтрация |
| Множественный выбор (multi-select) | Частичная | Фильтрация по вхождению |
| Флажок (checkbox) | Полная | Фильтрация (да/нет) |
| Телефон (phone) | Полная | Группировка, фильтрация |
| Email (email) | Полная | Группировка, фильтрация |
| Файл (file) | Не поддерживается | — |
| Изображение (image) | Не поддерживается | — |
Влияние на сохранённые отчёты
Важные аспекты при изменении кастомных полей:
Переименование поля: отчёты продолжают работать, название обновляется автоматически
Изменение типа поля: может привести к ошибкам в отчётах, использующих это поле как метрику
Удаление поля: отчёты с этим полем будут показывать ошибку, поле помечается как недоступное
Добавление поля: новое поле становится доступно после повторного обнаружения
Рекомендации
Планируйте структуру кастомных полей заранее
Не меняйте тип существующего поля без необходимости
При удалении поля предварительно проверьте, какие отчёты его используют
Используйте осмысленные названия полей для удобства поиска в интерфейсе