Настройка мастера интеграции для Битрикс24 - Продукт Modus BI
Мастер интеграции ETL позволяет настроить подключение к сервису Битрикс24, чтобы получать из него данные для их дальнейшей обработки и использования при построении визуализаций.
Для успешной работы с этим инструментом необходимо выполнить первоначальные настройки, описанные в статье «Общие настройки мастера интеграции». Перед началом работы с Мастером интеграции необходимо непосредственно в сервисе Битрикс24 настроить вебхук для вызова REST API. Настройка вебхука требуется, чтобы Мастер интеграции смог подключиться к сервису Битрикс24. Для настройки вебхука пользователь должен иметь права администратора в рамках сервиса Битрикс24, подробнее о настройке в инструкции на сайте Битрикс24.
Вкладка «Сервис-источник»
Создание нового подключения к Сервису-источнику доступно только для пользователя ETL с ролью Администратор. Пользователи с ролью Аналитик могут только открывать существующие подключения, просматривать их и выбирать подходящие для применения в рамках текущих настроек Мастера интеграции.
Для создания нового подключения перейдите в раздел «Мастер интеграции», на вкладке «Сервис-источник» нажмите на кнопку «Создать».
В открывшемся окне заполните поля:
- Укажите наименование конфигурации и выберите:
- «Вид объекта» — Обработка конфигурации;
- «Основная обработка» — Взаимодействие с сервисом Битрикс.
- Нажмите «Сохранить».
- В разделе «Параметры» введите параметры подключения Webhook для REST API, Логин и Пароль (параметры могут отличаться в зависимости от конфигурации).
- Нажмите на кнопку «Проверить подключение». Если все данные введены верно, система выведет сообщение о том, что подключение успешно установлено.
- По завершении настройки нажмите «Записать и закрыть».
Вкладка «Разделы сервиса»
На этой вкладке выберите необходимый раздел сервиса, используя кнопку «Выбрать». Изначально список разделов отображается пустым. Чтобы отобразить список разделов сервиса в соответствии с данными драйвера, нажмите на кнопку «Обновить по данным сервиса».
В структуре списка разделов, используемого при настройке Мастера интеграции, предусмотрены два смысловых уровня:
- Первый уровень — смысловые блоки из Битрикс2: CRM, задачи, календари и так далее.
- Второй уровень обеспечивает более детализированное разделение в соответствии с логикой работы сервиса Битрикс24, включая более мелкие подразделы внутри каждого из блоков.
Для адаптации отображения и лучшего понимания иерархии разделов предусмотрена возможность выбора одного из трех режимов просмотра. Для этого нажмите на кнопку «ЕЩЕ», затем выберите опцию «Режим просмотра». Этот шаг позволит увидеть и лучше понять разделение на уровни, облегчая процесс выбора необходимых разделов для работы в Мастере интеграции.
Вы можете выбрать как разделы первого уровня, так и разделы второго уровня для настройки Мастера интеграции. Выбор раздела первого уровня автоматически предоставляет доступ ко всем объектам-источникам, относящимся к данному блоку, включая те, что находятся в разделах второго уровня. Для работы возможно выбрать только один раздел.
Вкладка «Параметры раздела»
Для Сервиса «Битрикс24» заполнение параметров не требуется. Пропустите шаг, нажав на кнопку «Далее».
Вкладка «Объекты-источники»
На данной вкладке вы можете выбрать один или несколько объектов-источников для последующей настройки.
Изначально список разделов отображается пустым. Чтобы отобразить список разделов сервиса, нажмите на кнопку «Обновить по данным сервиса».
Чтобы выбрать объект-источник, нажмите на кнопку «Выбрать», нажмите «Отменить» для отказа от ранее выбранного объекта. Отображаются только те объекты, которые принадлежат выбранному разделу сервиса.
Для перехода к запросу примеров данных нажмите на кнопку «Перейти».
Для создания объекта-источника вручную заполните необходимые параметры.
Заполнение по правилу разбора данных: Если драйвер предоставляет такую функцию. Нажмите на кнопку «Заполнить по правилу разбора данных», чтобы автоматически заполнить поля объекта сервиса в соответствии с установленными правилами разбора данных.
На вкладке есть возможность просмотра сэмплов данных. Нажмите на ссылку «Перейти» (1) в строке соответствующего объекта, откроется окно, в котором возможно «Запросить» (2) пример данных. После получения сэмпла доступен переход в «Конструктор» (3), где предоставляется возможность просмотра и анализа полученного сэмпла данных. В конструкторе вы также можете настроить правила для разбора данных.
В остальных аспектах настройка Мастера интеграции для извлечения данных из сервиса «Битрикс24» выполняется в соответствии с предоставленными рекомендациями, приведенными в разделе «Общие настройки мастера интеграции».