Подключение интеграций с издательствами «МИФ» и «Альпина»

Подключение интеграций выполняется в настройках модуля «Библиотека». Права на настройку интеграции есть только у администраторов портала. Шаги для подключения интеграции:

  1. Перейдите по пути: адрес_портала/bitrix/admin

  2. В левом меню выберите «Настройки» > «Настройки модулей» > «Улей: Библиотека».

  3. Перейдите на вкладку «Интеграция с МИФ/Альпина»

На данной вкладке выберите одно из издательств, через интеграцию с которым вы планируете автоматически обновлять каталог Библиотеки. Важно: подключить интеграцию можно только с одним издательством.

После указания издательства поставьте галочку в поле «Активность». В этот момент во вкладке появятся поля, которые нужно заполнить, чтобы интеграция начала работать. В зависимости от типа интеграции (МИФ или Альпина) поля будут различаться.

Интеграция с МИФ

Для интеграции Библиотеки с каталогом МИФа нужно заполнить семь полей, которые перечислены на примере ниже. Важно: значения для полей 2-6 берутся из личного кабинета вашей организации на сайте издательства «МИФ».

  1. Время запуска. Точное время, в которое данные с сайта МИФа синхронизируются с данными модуля «Библиотека». Поле заполняется на усмотрение пользователя.

Периодичность (день недели) обновления Библиотеки настраивается администратором отдельно. По умолчанию модуль синхронизируется с каталогом МИФа каждый день в 00:00.

  1. ID библиотеки. Предоставляется издательством «МИФ».

  2. Email адрес администратора библиотеки. Предоставляется издательством «МИФ».

  3. Ссылка на api miflib. Предоставляется издательством «МИФ».

  4. Secret key для пользования API. Предоставляется издательством «МИФ».

  5. Company Name (задается МИФом и соответствует полю Audience в ЛК). Предоставляется издательством «МИФ».

  6. Учитывать период активности книги. Данная опция влияет на возможность скачивания материалов. Если галочка поставлена, в карточке книги появятся ссылки на скачивание файлов. Ссылки будут активны до тех пор, пока у компании действует подписка на издательство «МИФ».

После заполнения полей нажмите на кнопку «Сохранить». Электронный каталог Библиотеки начнет автоматически пополняться в указанное время.

Интеграция с Альпина Паблишер

Чтобы интегрировать Библиотеку с каталогом Альпины, требуется заполнить пять полей. Важно: значения для полей 2-5 берутся из личного кабинета вашей организации на сайте издательства «Альпина».

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

Периодичность (день недели) обновления Библиотеки настраивается администратором отдельно. По умолчанию модуль синхронизируется с каталогом МИФа каждый день в 00:00.

  1. API Key. Предоставляется издательством «Альпина».

  2. API Secret. Предоставляется издательством «Альпина».

  3. Адрес API. Предоставляется издательством «Альпина».

  4. Адрес хранилища. Предоставляется издательством «Альпина».

После заполнения полей нажмите на кнопку «Сохранить». Электронный каталог Библиотеки начнет автоматически пополняться в указанное время.

Периодичность обновления Библиотеки

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

Период синхронизации указывается через Агентов — это базовая технология Битрикс24, подробнее о которой можно узнать здесь.

Для настройки Агентов выполните следующие шаги:

  1. Перейдите по пути: адрес_портала/bitrix/admin

  2. В левом меню выберите «Настройки» > «Настройки продукта» > «Агенты».

  1. В поле «Модуль» введите наименование «ithive.library».

  2. Из списка выберите Агента, который соответствует вашей интеграции:

    а. Агент интеграции с МИФ: ITHive\Library\Service\Miflib::initImport(1);

    b. Агент интеграции с Альпина Паблишер: ITHive\Library\Service\Alpina::executeImport();

  3. Слева от нужного Агента нажмите на бургер-меню (≡) и кликните «Изменить».

Страница настроек Агента идентична для любой из двух интеграций. Здесь обратите внимание на два поля:

  1. Дата и время следующего запуска. Дата и время следующей синхронизации Библиотеки с каталогом издательства. По умолчанию самый первый запуск происходит в 00:00 на следующий день после подключения интеграции. Например, если интеграцию подключили первого января в 10 утра, то первая синхронизация с издательством произойдет второго января в полночь.

Если в настройках модуля было выбрано другое время синхронизации, в данном поле отобразится именно оно. Что касается даты следующего запуска, то она рассчитывается автоматически исходя из интервала, который задан ниже (см. пункт 2).

  1. Интервал (сек.). Интервал, через который происходит регулярное обновление Библиотеки. Интервал задается в секундах. Значение по умолчанию — 86400 секунд, что равно одним суткам.

С помощью настройки даты и времени вы можете задать конкретную дату и день недели для следующей синхронизации. А настройки интервала помогут установить периодичность, с которой каталог Библиотеки будет автоматически обновляться, начиная с указанной даты.

Предыдущая
Управление таймингом рассылки
Следующая
Установка, обновление и удаление модуля