Настройка мастера интеграции для Битрикс24
3 минутное чтение
Мастер интеграции ETL позволяет настроить подключение к сервису Битрикс24, чтобы получать из него данные для их дальнейшей обработки и использования при построении визуализций.
Для успешной работы с этим инструментом необходимо выполнить первоначальные настройки, описанные в статье “Общие настройки мастера интеграции. Перед началом работы с Мастером интеграции необходимо непосредственно в сервисе Битрикс24 настроить вебхук для вызова REST API. Настройка вебхука требуется, чтобы Мастер интеграции смог подключиться к сервису Битрикс24. Для настройки вебхука пользователь должен иметь права администратора в рамках сервиса Битрикс24. Детальную инструкцию по настройке вебхука можно найти по ссылке: инструкция по настройке вебхука. https://helpdesk.bitrix24.ru/open/code_12337906/
1. Вкладка “Сервис-источник”
Для создания нового подключения к сервис-источнику в Битрикс24, Можно отказаться от загрузки файла. В меню необходимо ввести название конфигурации, за тем выбрать Вид объекта - Обработка конфигурации, основную обработку выбрать требуемую и нажать “Сохранить”. После этого, в разделе “Параметры” будет предложено ввести параметры подключения webhook, логин и пароль (параметры могут отличаться в зависимости от конфигурации). Нажмите на кнопку “Проверить подключение”. Если все данные введены верно, система выведет сообщение о том, что подключение успешно установлено. По завершении настройки необходимо нажать Сохранить и закрыть.
Важно отметить, что создание нового подключения к Сервису-источнику доступно исключительно для пользователя ETL, обладающего ролью Администратора. Пользователи с ролью аналитик могут только открывать существующие подключения, осуществлять их просмотр и выбирать подходящие для применения в рамках текущих настроек Мастера интеграции.
2. Вкладка “Разделы сервиса”
На этой вкладке пользователь выбирает необходимый раздел сервиса, используя кнопку Выбрать. Изначально список разделов отображается пустым. Чтобы отобразить список разделов сервиса в соответствии с данными драйвера, необходимо нажать кнопку Обновить по данным сервиса.
В структуре списка разделов, используемого при настройке Мастера интеграции, предусмотрены два смысловых уровня. Первый уровень представляет собой смысловые блоки из Битрикс24, такие как CRM, задачи, календари и так далее. Второй уровень обеспечивает более детализированное разделение в соответствии с логикой работы сервиса Битрикс24, включая более мелкие подразделы внутри каждого из блоков.
Для адаптации отображения и лучшего понимания иерархии разделов предусмотрена возможность выбора одного из трех режимов просмотра. Для этого необходимо воспользоваться кнопкой ЕЩЕ, затем выбрать опцию Режим просмотра. Этот шаг позволит увидеть и лучше понять разделение на уровни, облегчая процесс выбора необходимых разделов для работы в Мастере интеграции.
Пользователю предоставляется возможность выбора как разделов первого уровня, так и разделов второго уровня для настройки Мастера интеграции. Выбор раздела первого уровня автоматически предоставляет доступ ко всем объектам-источникам, относящимся к данному блоку, включая те, что находятся в разделах второго уровня. Важно помнить, что можно выбрать только один раздел для работы.
3. Вкладка “Параметры раздела”
Для Сервиса «Битрикс24» заполнение параметров не требуется и этот шаг следует пропускать, нажимая на кнопку Далее.
4. Вкладка “Объекты-источники”
На данной вкладке пользователь имеет возможность выбирать один или несколько объектов-источников для последующей настройки. Изначально список разделов отображается пустым. Чтобы отобразить список разделов сервиса в соответствии с данными драйвера, необходимо нажать кнопку Обновить по данным сервиса.
Для выбора доступно нажатие на кнопки Выбрать для подтверждения выбора или Отменить выбор для отказа от ранее выбранного объекта. Отображаются только те объекты, которые принадлежат выбранному разделу сервиса.
Для перехода к запросу примеров данных можно использовать кнопку Перейти, если драйвер поддерживает данную функциональность.
Создание объекта-источника вручную: пользователь имеет возможность самостоятельно создать объект-источник, заполнив необходимые параметры.
Заполнение по правилу разбора данных: Если драйвер предоставляет такую функцию, кнопка Заполнить по правилу разбора данных позволяет автоматически заполнить поля объекта сервиса в соответствии с установленными правилами разбора данных.
На этой вкладке предоставлена возможность просмотра сэмплов данных. При нажатии на ссылку «Перейти» (1) в строке соответствующего объекта открывается окно, где можно запросить (2) пример данных. После получения сэмпла доступен переход в конструктор (3), где предоставляется возможность просмотра и анализа полученного сэмпла данных. В конструкторе также можно настроить правила для разбора данных.
В остальных аспектах настройка Мастера интеграции для извлечения данных из сервиса «Битрикс24» выполняется в соответствии с предоставленными рекомендациями, приведёнными в статье “Общие настройки мастера интеграции