Пользовательская инструкция по настройке приложения «Интеграция с Power BI»


Установка приложения в Битрикс24

Чтобы начать использовать приложение «Интеграция с Power BI» на вашем портале Битрикс24, необходимо скачать его по ссылке или выполнить следующие действия:

1. Поиск приложения

Перейдите в раздел Маркет вашего портала Битрикс24, в строке поиска введите название «Интеграция с Power BI» и выберите его из предложенного списка.


2. Открытие страницы приложения

После выбора приложения вы попадете на страницу с его описанием. Здесь можно ознакомиться с его функционалом и возможностями.


3. Установка приложения 

Нажмите кнопку «Установить» и проставьте галочки в чекбоксах условий соглашения, а затем снова нажмите на кнопку «Установить». 


4. Доступ к приложению

После завершения установки приложение будет доступно в главном меню вашего портала Битрикс24.



Интерфейс в Битрикс24

На главной странице приложения в левом верхнем углу расположена информация:

  • Количество доступных записей.
  • Срок действия: в базовой версии приложения отображается дата установки приложения. В случае приобретения дополнительных строк в данном поле указывается дата действия приобретенного пакета. 
  • Кнопка «Привязать Telegram-чат». 


Кнопка «Привязать Telegram-чат» позволяет подключить отслеживание логов (истории) приложения. Чтобы использовать данную функцию, выполните следующие шаги:

1. Нажмите на кнопку «Привязать Telegram-чат».

2. Выберите чат, в котором вы хотите просматривать логи. 

После выполнения данных действий в выбранный чат будет добавлен чат-бот Telegram — @powerbi_integration_bot.


Обратите внимание, что привязать Telegram-чат может только администратор портала.


Также на главной странице расположено 5 вкладок:

1. Демо отчет — примеры того, как может выглядеть отчет.

2. С чего начать — инструкция для интеграции шаблона отчета с вашим порталом Битрикс24.

3. Настройки загрузки — выбор пользовательских полей для отображения в отчете.

4. Инструкции — переход к инструкциям по приложению «Интеграция с Power BI».

5. Режим отладки — отображение логов сбора данных, а также актуальный кеш приложения по пользователям.



Первичная настройка Интеграции

1. Перейдите во вкладку «С чего начать» в приложении «Интеграция с Power BI» и скачайте приложение «Power BI Desktop» от Microsoft, воспользовавшись ссылкой из пункта №1. 


В появившемся окне выберите «Открыть приложение».


Установите программу на свой компьютер, нажав кнопку «Получить».


2. На той же вкладке «С чего начать» скачайте актуальный шаблон отчета, воспользовавшись ссылкой из пункта №2. 


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


3. Вернитесь к приложению «Power BI Desktop» и нажмите кнопку «Открыть».


4. В открывшемся окне нажмите на пункт «Открыть», затем в левом нижнем углу выберите «Обзор этого устройства» и укажите файл, который вы скачали ранее. 


5. При открытии шаблона в поле «Токен» вставьте ваш собственный токен, который указан на вкладке «С чего начать» в пункте №3, и нажмите кнопку «Загрузить».


6. В открывшемся окне «Доступ к веб-содержимому» выберите первую строку — https://powerbi.it-solution.ru/ и нажмите кнопку «Подключение».


Если появится уведомление «В запросах есть ожидающие изменения. которые не были применены», необходимо нажать «Применить изменения».


7. После завершения обновления отобразится отчет на основе данных CRM вашего портала Битрикс24. 


Обратите внимание, что демонстрационный отчет строится на основании последних 2000 записей из каждой таблицы.


После того, как все данные будут выгружены, они сохранятся во временный четырехчасовой кеш. Проверить это можно, перейдя в приложение «Интеграция с Power BI» и открыв вкладку «Настройки загрузки» (конец страницы) или вкладку «Режим отладки» — пункт «Кеш».


Если у вас есть актуальный кеш, а вы хотите загрузить новые данные из Битрикс24, необходимо воспользоваться кнопкой «Сбросить кеш».


После этого загрузить данные можно через интерфейс «PowerBI Desktop», перейдя на вкладку «Главная» и нажав кнопку «Обновить».



Первичная настройка Интеграции для пользователей Mac ОС

Если вы пользуетесь устройством на базе Mac ОС или есть другие причины, по которым нет возможности установить приложение «Power BI Desktop», вы можете использовать наш шаблон отчета в веб-версии.

1. Создайте учетную запись в Power BI.

  • Рекомендуем при создании учетной записи использовать общую корпоративную почту, которую в вашей компании применяют для регистрации ПО, а не привязывать к почте определенного сотрудника.
  • При указании страны Россия временную учетную запись создать нельзя. Для этого вы можете выбрать, например, Казахстан.  
  • Предпочтительно указывать электронную почту вместо номера телефона.


2. Перейдите в приложение «Интеграция с Power BI» на вашем портале Битрикс24 во вкладку «С чего начать» и скачайте файл отчета с расширением pbix.


3. В веб-версии Power BI перейдите во вкладку «Моя рабочая область», нажмите «Импортировать» — «Отчет или отчет с разбивкой на страницы» — «С этого компьютера» и выберите ранее скачанный файл.


4. Также во вкладке «Моя рабочая область» найдите семантическую модель только что загруженного файла. Нажмите на три точки рядом с семантической моделью, а затем выберите пункт «Параметры».


В открывшемся окне раскройте пункт «Параметры» и поменяйте токен на свой, который указан в приложении «Интеграция с Power BI» на вкладке «С чего начать» в пункте №3, и нажмите «Применить».


Обратите внимание, если всплывет предупреждение «Не удается обновить источник данных, поскольку указаны неверные учетные данные. Измените свои учетные данные и повторите попытку», то необходимо выбрать «Изменить учетные данные». А затем нажать «Войти» в новом окне.


6. Вернитесь к вкладке «Моя рабочая область» и нажмите на значок обновления около семантической модели, чтобы загрузить данные с портала Битрикс24.


7. После завершения обновления вы сможете увидеть в новом отчете свои данные.


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



Краткое руководство просмотра отчета

1. С помощью кнопки «Обновить» на вкладке «Главная страница» происходит обновление данных в отчете.


2. Нажав правой кнопкой мыши на любой показатель и выбрав пункт «Показать как таблицу», будет показана детальная информация.


3. Нажав правой кнопкой мыши на любой показатель и выбрав пункт «Показать точку данных как таблицу», вы можете просмотреть все записи этого отчета по всем существующим столбцам.


4. После просмотра деталей с помощью кнопки «Назад к отчету» можно вернуться к основному отчету.


5. В отчетах по датам, нажав на любой показатель правой кнопкой мыши и выбрав «Детализация углублением», вы можете просмотреть отчет по кварталам, месяцам и дням.


6. Если необходимо выбрать несколько показателей, можно воспользоваться зажатием клавиши Ctrl.