В пользовательском поле типа «Список» отображаются ID вместо значений

---

При загрузке пользовательского поля типа «Список» Power BI может отображать идентификаторы элементов вместо их названий. 

Чтобы получить названия, необходимо дополнительно загрузить справочник соответствий между ID и значениями списка.

Перед началом

Убедитесь, что:

• пользовательское поле добавлено в выгрузку приложения;
• поле уже отображается в Power BI;
• вам известен код поля вида UF_CRM_...;
• у вас есть доступ к редактированию запросов и модели Power BI.

Если поле ещё не появилось в Power BI, сначала выполните инструкцию «Как увидеть пользовательские поля в отчёте».

Как найти код пользовательского поля

1. Откройте настройки CRM в Битрикс24.
2. Перейдите в раздел настройки пользовательских полей.
3. Выберите сущность, к которой относится поле: сделку, лид, контакт или компанию.
4. Откройте настройки нужного поля.
5. Найдите в адресной строке браузера код, начинающийся с UF_CRM_.

Пример кода: UF_CRM_1584970188.

Способ 1. Получение значений через restproxy

Для получения справочника можно использовать restproxy приложения «Интеграция с Power BI».

Общий вид запроса:

https://powerbi.it-solution.ru/powerbi/restproxy/?token=ВАШ_ТОКЕН&method=МЕТОД&filter={"FIELD_NAME":"КОД_ПОЛЯ"}

В запросе необходимо заменить:

• ВАШ_ТОКЕН — на токен из приложения;
• МЕТОД — на метод для нужной CRM-сущности;
• КОД_ПОЛЯ — на код пользовательского поля вида UF_CRM_....

Доступные методы

• лиды — crm.lead.userfield.list;
• сделки — crm.deal.userfield.list;
• контакты — crm.contact.userfield.list;
• компании — crm.company.userfield.list.

Пример запроса для пользовательского поля сделки:

https://powerbi.it-solution.ru/powerbi/restproxy/?token=ВАШ_ТОКЕН&method=crm.deal.userfield.list&filter={"FIELD_NAME":"UF_CRM_1584970188"}

Откройте сформированный адрес в браузере и проверьте, что в ответе присутствуют ID и названия элементов списка.

Важно: не передавайте сформированный URL другим пользователям, не публикуйте его и не показывайте на скриншотах. Адрес содержит токен доступа.

Способ 2. Получение значений через входящий вебхук

Если получить справочник через restproxy невозможно, используйте входящий вебхук Битрикс24. Для его создания потребуются права администратора.

1. Откройте раздел для разработчиков или управления вебхуками в Битрикс24.
2. Создайте входящий вебхук.
3. Предоставьте вебхуку права на работу с CRM.
4. Сохраните вебхук и скопируйте его адрес.

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

Общий вид запроса через вебхук:

https://ВАШ_ПОРТАЛ/rest/ID_ПОЛЬЗОВАТЕЛЯ/СЕКРЕТНЫЙ_ТОКЕН/МЕТОД/?FILTER[FIELD_NAME]=КОД_ПОЛЯ

Замените:

• ВАШ_ПОРТАЛ — на адрес портала Битрикс24;
• ID_ПОЛЬЗОВАТЕЛЯ — на идентификатор пользователя вебхука;
• СЕКРЕТНЫЙ_ТОКЕН — на секрет из адреса вебхука;
• МЕТОД — на метод нужной CRM-сущности;
• КОД_ПОЛЯ — на код пользовательского поля.

Откройте сформированный адрес в браузере и проверьте полученный ответ.

Важно: адрес входящего вебхука предоставляет доступ к данным портала в рамках назначенных прав. Не публикуйте его и не используйте реальные адреса вебхуков в примерах или на скриншотах.

Подключение справочника в Power BI

1. Откройте отчёт в Power BI Desktop.

2. Выберите получение данных из Интернета.

3. Вставьте URL, сформированный одним из способов выше.

4. Подтвердите подключение к источнику.

5. Преобразуйте полученный JSON в таблицу.

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

7. Нажмите «Закрыть и применить».

Создание связи

1. Откройте представление модели в Power BI.
2. Найдите созданный справочник и таблицу сущности, которой принадлежит пользовательское поле.
3. Создайте связь по столбцам с идентификаторами элементов списка.
4. Примените изменения.
5. Проверьте, что в отчёте вместо ID отображаются названия элементов.

Если значения не появились

• проверьте правильность кода UF_CRM_...;
• убедитесь, что выбран метод для нужной CRM-сущности;
• проверьте ответ запроса в браузере;
• обновите предварительный просмотр данных в Power Query;
• проверьте связь справочника с основной таблицей;
• нажмите «Закрыть и применить», затем обновите отчёт.