В пользовательском поле вместо названий только цифры / Как быть, если мое пользовательское поле имеет тип "список"?

Если Ваше пользовательское поле имеет тип "список", то Вы видите только ID значений, а не сами значения.

Чтобы "подтянуть" в PowerBI значения, нам нужно создать вебхук и (специальный url), по нему сможем получить русские названия списка.


1. Создаем входящий вебхук - открываем в меню слева "Разработчикам"  и выбираем "Другое"

 

2. Выбираем "Входящий вебхук"

 

3. Даем право на раздел CRM и сохраняем

Выбирать методы не нужно! Эта часть служит для демонстрации и тестирования

4. Генерируем ссылку для получения значений списка нашего пользовательского поля 

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


ВАШ_ПОРТАЛ - например, b24-svxeii.bitrix24.ru

ВАШ_ID_НА_ПОРТАЛЕ - последняя цифра в URL-адресе при открытии Вашей карточки на портале


ВАШ_СЕКРЕТНЫЙ_ТОКЕН_ВЕБХУКА - после создании вебхука Вы его видели

МЕТОД - зависит от того, к какой CRM-сущности относится пользовательское поле

для лида - crm.lead.userfield.list

для компании - crm.company.userfield.list

для контакта - crm.contact.userfield.list

для сделки - crm.deal.userfield.list


КОД_ПОЛЬЗОВАТЕЛЬСКОГО_ПОЛЯ  - можно найти при редактировании этого пользовательского поля в URL-адресе (начинается с UF_CRM)

Открываем в меню CRM -> Настройки -> Настройка форм и отчетов -> Пользовательские поля

 

Далее выбираем какой список нас интересует (например, список полей у сделок) -> и выбираем конкретное поле 

И видим, что в URL-адресе отображается интересующий нас код пользовательского поля - UF_CRM_1584970188

Итого на примере пользовательского поля для сделки получаю ссылку в виде 

https://b24-svxeii.bitrix24.ru/rest/1/tnadisufns8/crm.deal.userfield.list/?FILTER[FIELD_NAME]=UF_CRM_1584970188

Проверяю, открыв её в браузере. Если в Вашем примере нет примерно такого же ответа - что-то пошло не так, напишите нам.


5. Открываем PowerBI Desktop и создаем новый Интернет-запрос


6. В URL-адресе указываем полностью нашу сгенерированную ссылку и нажимаем "Ок"

 

7. Дальше просто нажимаем (применяем шаги с навигацией) как на скриншотах


8. Для удобства переименуем запрос (например, "Формат сделки"), чтобы потом было понятно, что это за модель.



9. Нажмите "Закрыть и применить", чтобы модель загрузилась в отчет.

 


10. Нам осталось только создать связь между новой моделью (на примере это "Формат сделки")  и моделью, которая с ней должна быть связана (так как на примере это пользовательское поле относится к сделке, то мы свяжем его с моделью "Сделки". Если Ваше поле связано с лидом, контактом или компанией - выбирайте модель "Клиенты".



11. Проверяем, что связь работает корректно



Если на каком-то шаге возникли вопросы - пишите нам, мы Вам с удовольствием подскажем

Если у Вас всё получилось - Вы молодец и эта инструкция хорошая!


P.S. Все токены из примера недействительны ради сохранения данных на демо-портале в целостности.