Справочник полей

Приложение для администраторов, интеграторов, аналитиков и BI-специалистов Битрикс24. Работает прямо в интерфейсе портала, установка занимает минуту. Все сущности и их поля подтягиваются автоматически с вашего портала.

Приложение показывает все поля всех сущностей CRM в одной таблице: символьный код поля (ID), название, тип, значения списочных и справочных полей, сортировку, признак «системное / пользовательское», обязательность и множественность. Плюс — считает, в скольких записях CRM реально используется каждое пользовательское поле, умеет находить поля с нулевым использованием и искать дубли полей — кандидатов на удаление и объединение.

Стандартный интерфейс Битрикс24 не решает задачу «получить символьный код всех полей, а также ID значений полей типа „Список“». Приходится:

• искать символьный код поля в адресной строке его настроек;

• узнавать ID значений списочных полей через REST API или DevTools;

• проверять использование поля — вручную, перебором карточек;

• искать дубли и неиспользуемые поля — вообще без штатных инструментов.

Справочник полей закрывает все эти задачи в одном окне.

Кому полезно:

• BI-аналитикам — для быстрого поиска символьных кодов полей при настройке дашбордов, сопоставлении полей CRM с таблицами в аналитических системах и подготовке данных для BI-коннектора. Не нужно больше лазить в адресную строку или DevTools — все коды в одной таблице.

• Интеграторам — быстрый доступ к символьным кодам и ID полей для REST API, бизнес-процессов, роботов и внешних интеграций.

• Аналитикам — сопоставление символьных кодов полей CRM с таблицами в аналитических системах.

• Администраторам порталов — аудит пользовательских полей, поиск дублей и чистка неиспользуемых полей.

• Продвинутым пользователям — настройка роботов, бизнес-процессов, дашбордов.

Таблица полей с колонками:

Символьный код (ID) — техническое имя поля, символьный код, по которому поле вызывается в REST API, BI-коннекторе, бизнес-процессах и роботах: TITLE, PHONE, UF_CRM_..., ufCrm.... Копируется одним кликом.

Название — человекочитаемое название. У пользовательских полей — активная ссылка на страницу редактирования в Битрикс24.

Тип — Строка, Число, Список, Справочник, Дата, Файл, Пользователь, Деньги, Адрес и другие.

Значения списка — количество доступных значений у списочных и справочных полей. По клику открывается полный список ID → Значение.

Сортировка — порядок вывода поля. Для пользовательских полей — из настроек Битрикс24; для системных и полей смарт-процессов — прочерк (REST не отдаёт этот параметр).

Обязательное — флаг «Да» / «—».

Множественное — флаг «Да» / «—».

Действия — кнопка подсчёта использования поля.

Главная задача приложения — выдать символьный код каждого поля и ID каждого значения списочных полей. Это то, что стандартный интерфейс Битрикс24 не умеет: код поля приходится искать в адресной строке настроек, а ID значений — через REST API или DevTools.

Здесь и то, и другое видно сразу: символьный код — в первой колонке, ID значений — по клику на «N значений». Код копируется одним кликом.

Приложение автоматически подтягивает актуальный список сущностей с портала:

• Базовые CRM: Лиды, Сделки, Контакты, Компании.

• Стандартные смарт-процессы: Счета, Предложения.

• Все пользовательские смарт-процессы — включая КЭДО, Подпись, Бриф, Тендеры и любые другие, заведённые на портале.

Набор сущностей обновляется сам: добавили новый смарт-процесс — он появился в списке без правок кода.

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

Для полей типа «Список» и «Справочник» приложение подтягивает значения — как пользовательских (созданных вручную), так и системных (типы компаний, источники, стадии).

Клик по «N значений» открывает таблицу ID → Значение — например, CUSTOMER → B2B, SUPPLIER → B2G.

Кнопка-калькулятор у каждого пользовательского поля. По клику приложение обращается к CRM и показывает, в скольких записях поле заполнено.

Работает для всех базовых сущностей и всех смарт-процессов (включая Счета и Предложения).

Кнопка «Найти нулевые» запускает последовательную проверку всех пользовательских полей текущей сущности и оставляет в таблице только те, что нигде не используются.

• Работает в фоне — интерфейс остаётся отзывчивым, можно продолжать работать.

• Кнопка показывает прогресс: 12/169, потом — количество найденных полей.

• Повторный клик — «Показать все», фильтр снимается. Результаты подсчёта при этом сохраняются.

Что это даёт: список полей, которые можно безопасно удалить из Битрикс24 — данные по ним не заполнены ни в одной записи.

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

Как это работает:

• Включите фильтр «Только пользовательские» и отсортируйте таблицу по названию или типу.

• Дублирующиеся поля видны сразу — одинаковые названия, одинаковый тип, разные символьные коды.

• Для каждого поля можно посчитать использование (кнопка-калькулятор) и понять, какое из полей-клонов реально заполняется, а какое — мёртвый дубль.

• Сканер нулевых полей покажет, какие из дублей не используются вообще.

Что это даёт: вы находите пары «поле-оригинал / поле-дубль», оставляете рабочее и удаляете лишнее — без риска потерять данные.

• Фильтр по типу поля (Строка, Число, Список, Дата, Файл и т.д.).

• Чекбокс «Только пользовательские» — скрыть системные поля.

Единая строка поиска ищет одновременно по символьному коду, названию, типу и значениям списка. При активном поиске группы раскрываются автоматически — найденные поля видны сразу.

Клик по любому сортируемому заголовку таблицы. Повторный клик меняет направление, третий — сбрасывает сортировку к исходному порядку.

Выгружает текущий список полей (с учётом всех фильтров и поиска) в файл CSV, который корректно открывается в Excel. В файле — все колонки таблицы, включая символьные коды полей, обязательность и множественность.

Приложение автоматически регистрирует себя во всех местах встраивания при запуске:

• карточка Контакта,

• карточка Компании,

• карточка Сделки,

• карточка Лида,

• карточка Счёта,

• карточка смарт-процесса,

• карточка группы соцсети (проект).

Открыть приложение можно прямо из карточки, без перехода в левое меню.

• Работает в облачном и коробочном Битрикс24.

• Все данные получаются через официальный REST API — никаких прямых запросов к базе.

• Кэширование. Список полей загружается один раз и хранится до нажатия «Обновить».

Ограничения REST API Битрикс24:

• Для системных полей и полей смарт-процессов не отдаётся порядок сортировки — в колонке будет прочерк.

• Массовый подсчёт использования полей у смарт-процессов работает медленнее, чем у базовых сущностей, из-за особенностей метода crm.item.list.

• Поиск дублей полей — находите поля-клоны с одинаковыми названиями и типами, сравнивайте их использование и удаляйте лишнее.

• Сканер полей с нулевым использованием — массовый подсчёт с прогрессом и фильтром «только нулевые».

• Режим «Все сущности» — поля всех сущностей в одной таблице, с группировкой.

• Признаки «Обязательное» и «Множественное» — отдельные колонки с фильтрацией.

• Значения системных справочников (типы компаний, источники, стадии) — теперь с ID и названиями, как у пользовательских списков.

• Индикация прогресса в кнопке сканера — видно, сколько полей проверено и сколько осталось.

• Ссылки на пользовательские поля — сразу в настройки конкретного поля.

• Экспорт CSV с полным набором колонок, включая символьные коды полей, обязательность и множественность.

• Автоматическая регистрация в карточках — без отдельной настройки.

• Тёмная тема.

• Сравнение полей двух сущностей — для поиска дубликатов между разными сущностями.

• Расширенный поиск по значениям списочных полей.

• Экспорт в XLSX с форматированием.

• Массовые действия — выбрать поля и выгрузить только их.

• Автоматическое предложение объединения дублей.

• Копирование полей

Приложение решает главную боль при настройке BI-дашбордов — поиск символьных кодов полей. Вместо того чтобы:

• открывать настройки каждого поля и копировать символьный код из адресной строки,

• лазить в DevTools за ID значений списочных полей,

• сверять поля вручную с таблицами BI-системы,

— вы открываете «Справочник полей», находите нужное поле через поиск, копируете символьный код одним кликом и сразу видите все значения списочных полей с их ID.

Сценарии для BI:

• Сопоставление символьных кодов полей CRM с таблицами BI. Откройте «Все сущности» → «Экспорт» — получите полную структуру полей всех сущностей в CSV с символьными кодами. Используйте как маппинг при настройке BI-коннектора.

• Проверка перед выгрузкой в аналитику. Убедитесь, что поле не является дублем и реально используется — иначе в дашборд попадут пустые колонки.

• Поиск ID значений для фильтров. Для списочных полей (источники, стадии, типы) сразу видны все ID — можно строить фильтры и разрезы без дополнительных запросов к API.

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

Для работы приложения нужны права на чтение структуры CRM. Обычно это права администратора портала. Если приложение не показывает поля какой-либо сущности — проверьте, что у вашей учётной записи есть доступ к этой сущности в Битрикс24.

Приложение для порталов любого тарифа.

Если у вас до сих пор нет Битрикс24, самое время создать Битрикс24 по этой ссылке.