Интеграция с Power BI: Как быть, если мое пользовательское поле имеет тип "список"?

Сначала убедитесь, что пользовательское поле уже Вы видите в PowerBI (см. инструкцию).


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

Чтобы "подтянуть" в PowerBI значения, Вам нужны будут права администратора портала на Битрикс24, которые позволят создавать входящие вебхуки.


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

 

2. Выбираем сверху пункт "Вебхуки"

 

3. Нажимаем на кнопку "Добавить вебхук" -> "Входящий вебхук"

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


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

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

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


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


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

 

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


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



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

 


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



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



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

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


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