Как узнать название поля UF_CRM в BI-отчёте Битрикс24
Вместо понятного названия в отчёте виден технический код. Найдите исходное поле, проверьте его сущность и отделите название CRM от подписи графика.
В списке колонок BI встречаются имена вроде uf_crm_1645431691305. По ним трудно понять, что хранится в поле и можно ли использовать его в показателе. Начните с поиска исходного описания: иначе под понятной подписью легко оставить совсем другое значение.
Сначала определите источник колонки
Посмотрите, на каком наборе данных построен график. Если это виртуальный набор, откройте его SQL-запрос и проследите колонку до исходной таблицы: видимое имя могло появиться после AS, вычисления или объединения данных. Подпись «Срок оплаты» сама по себе не доказывает, что колонка связана с одноимённым полем сделки.
Для основных сущностей в каталоге BI-наборов Битрикс24 предусмотрены отдельные наборы пользовательских полей. Используйте их как подсказку, в какой сущности искать описание.
| Набор данных | Где искать поле |
|---|---|
| crm_deal_uf | Сделки |
| crm_lead_uf | Лиды |
| crm_contact_uf | Контакты |
| crm_company_uf | Компании |
При объединении нескольких наборов проверьте, из какой таблицы взята именно ваша колонка. Найденное поле контакта не заменяет поле сделки с похожим названием. Уточните также портал: код из отчёта другой организации нельзя сопоставлять с текущим каталогом только по подписи.
Как найти название в справочнике полей
Если «Справочник полей CRM» от TrueTell уже подключён к нужному порталу, откройте его. В текущей версии доступны сделки, лиды, контакты и компании. Счета и смарт-процессы этим каталогом не охвачены.
Выберите сущность из источника отчёта.
Например, для crm_deal_uf начните со вкладки «Сделки». Не ищите сразу во всех каталогах по похожей подписи.
Сбросьте лишние фильтры.
Тип и категория применяются вместе с поиском. Для первой проверки оставьте «Все типы» и «Все поля».
Вставьте код в «Поиск поля».
Для строки вида uf_crm_… поиск без учёта регистра может найти исходный код UF_CRM_…, если различие только в регистре. Другой формат имени требует отдельной сверки.
Сравните полный код и прочитайте название.
Поиск находит и частичные совпадения. Убедитесь, что выбрана нужная строка, затем запишите сущность, название, техническое имя и тип.
На скриншоте поиск связывает конкретное техническое имя с названием и типом. Он не доказывает, что колонка отчёта использует это поле без преобразований. После поиска вернитесь к источнику BI и сверьте его с найденным описанием.
Справочник ищет по названию, основному коду и дополнительному имени API, если оно получено. Он не преобразует автоматически все варианты UF_CRM, ufCrm и псевдонимы SQL. Для REST метод crm.item.fields отдельно управляет форматом пользовательских имён через useOriginalUfNames; правила другого инструмента проверяют по его документации.
Как проверить название через настройки CRM
Без справочника откройте CRM → Ещё → Настройки → Настройки CRM → Настройки форм и отчётов → Пользовательские поля. Выберите нужный тип элемента, откройте существующее поле через его меню → Изменить и сопоставьте код в адресе страницы с колонкой BI. Названия пунктов зависят от интерфейса и доступных прав.
Не выбирайте поле по порядку в списке или сходству подписи. Проверяйте техническое имя целиком. В инструкции о коде поля Битрикс24 показано, где он находится и чем отличается от числового ID. Для чтения сведений сохранять изменения поля не нужно.
Если полей много, попросите администратора или интегратора помочь с сопоставлением. После проверки нескольких колонок можно подготовить каталог названий и кодов в CSV и использовать его как рабочий список. Это не резервная копия CRM и не выгрузка значений для отчёта.
Как сделать подпись в отчёте понятной
Найденное название сначала согласуйте с владельцем показателя. Условное «Дата оплаты» может означать план, поступление или дату ручного подтверждения менеджером. Подпись должна объяснять смысл колонки, а не просто повторять короткое имя из CRM.
В BI Конструкторе подпись задают на уровне SQL, датасета или отдельного графика; официальная справка описывает эти способы. Для виртуального набора путь начинается с «Датасеты» → нужный набор → «Редактировать» → «Столбцы». Измените нужную подпись и сохраните результат. Для формул разумно сохранять технические имена на латинице. Если меняете системный отчёт, сначала создайте его копию. Для другой BI-системы используйте её собственные настройки названий.
Выберите область изменения: подпись только одного графика или общее обозначение в наборе данных. После сохранения проверьте отображение и зависимые формулы. Смена подписи не меняет значение поля CRM, не исправляет тип данных и не настраивает расчёт показателя.
Что делать, если соответствие не найдено
Проверьте исходное имя. В отчёте может использоваться SQL-псевдоним или расчётная колонка. Найдите исходное выражение. Не пытайтесь восстановить код поля только по цифрам из видимого названия.
Проверьте портал, сущность и фильтры. Снимите ограничения поиска и обновите каталог. Если приложение показывает ошибку чтения API, это не результат «поле отсутствует»; выполните предложенный в интерфейсе шаг восстановления или обратитесь к администратору.
Проверьте историю поля. Название могли изменить, а поле — удалить и создать заново. Сверьте текущие настройки с документацией интеграции. Старый скриншот или прежняя подпись не подтверждают, что новое поле имеет тот же код и смысл.
Не подменяйте неизвестное похожим. До подтверждения оставьте колонку в списке вопросов к автору отчёта. Для передачи задачи достаточно указать набор данных, исходный код, предполагаемую сущность и что именно не удалось проверить.
Название найдено: что проверить перед расчётом
Отдельно проверьте представление значений в BI. Например, официальный набор crm_deal_uf описывает пользовательские колонки как строки. Тип double в метаданных CRM сам по себе не делает колонку BI числом, пригодным для суммирования. Преобразование, пустые и некорректные значения проверяют отдельно на выбранных данных.
Зафиксируйте связь «портал → сущность → исходный код → название CRM → подпись BI» и назначение показателя. Это поможет следующему сотруднику отличить переименование графика от изменения источника данных. Для подготовки самого отчёта используйте пошаговый разбор первого BI-отчёта.
Для проверки найденного описания пригодится разбор типов и свойств полей CRM. Он объясняет происхождение поля, множественность и отличие технической обязательности API от настроек стадии.
Если найденное имя нужно передать в REST API, используйте разбор UF_CRM, ufCrm и системных ключей. Формат колонки BI не заменяет правила REST-метода.
Частые вопросы
Что означает UF_CRM в названии колонки BI?
Так выглядит часть технического имени пользовательского поля CRM. Сам код не объясняет бизнес-смысл данных. Чтобы найти название, определите сущность и портал, а затем сопоставьте полное имя с описанием поля.
Можно ли найти название поля по коду в справочнике?
Да, если описание поля возвращено API и проходит фильтры. Выберите нужную сущность и вставьте код в «Поиск поля». Поиск допускает частичные совпадения, поэтому проверьте полное техническое имя в найденной строке.
Почему поиск по UF_CRM ничего не нашёл?
Возможны другой портал или сущность, оставшиеся фильтры, ошибка чтения API либо отсутствие поля в текущем каталоге. Если в отчёте используется SQL-псевдоним или расчётная колонка, сначала найдите исходный столбец в настройках датасета или запросе.
Название поля в CRM совпадает с подписью графика?
Не обязательно. Подпись графика может быть задана вручную, а колонка — получена выражением или переименована в SQL. Проверяйте источник колонки, прежде чем связывать подпись с определённым полем CRM.
Справочник сам заменит UF_CRM понятным названием в BI?
Нет. Справочник показывает описания полей четырёх сущностей CRM. Он не читает настройки BI, не подключает наборы данных и не меняет подписи графиков.
Можно ли по названию определить, как считать показатель?
Нет. Дополнительно нужны тип и смысл данных в BI, обработка пустых значений, фильтры и правила расчёта. Технический тип поля CRM сам по себе не подтверждает тип колонки набора данных или корректность суммы.