home

Интеграция с ЭБС Лань

ebs_lan_book_site.png

Интеграция с ЭБС Лань позволяет авторизовать пользователей ELiS в ЭБС Лань и отобразить учебники из ЭБС Лань на сайте ELiS как удаленный ресурс.

Как работает для пользователя[править]

  • Пользователь заходит на сайте ELiS и по метаданным находит учебник.
  • ELiS автоматически авторизует пользователя в ЭБС Лань. Если у пользователя не был создан аккаунт в ЭБС Лань, он автоматически создается.
  • ELiS показывает удаленный учебник из ЭБС Лань в своем сайте (пользователю один раз надо будет принять пользовательское соглашение ЭБС Лань при первом просмотре учебника).
  • Пользователь может открыть учебник в новой вкладке на весь экран, перейдя на сайт ЭБС Лань, или читать его в ELiS.

Когда нужна интеграция с ЭБС Лань[править]

Интеграция оптимальна при покнижном комплектовании, когда в ЭБС Лань закупается относительно небольшое число учебников.

Интеграцию также можно использовать и при покупке больших коллекций, но система автоматического импорта не импортирует иерархию и все книги будут в плоском каталоге.

Плюсы:

  • пользователю не надо вводить логин и пароль в ЭБС Лань и не надо его знать. Также поиск по метаданным будет находить учебники Лань в ELiS.

Минусы:

  • необходимо импортировать учебники Лань в ELiS как удаленный ресурс и администрировать их;
  • книги из ЭБС Лань в ELiS доступны только для авторизованных пользователей;
  • есть подсистема массового импорта, но не удаления учебников, срок действия аренды на которые истёк.

Настройка интеграции[править]

  1. В ЭБС Лань надо получить API-токен (token - секретный пароль) http://developers.lanbook.com;
  2. Включить в ELiS модуль ELiS Lan;
  3. Ввести в настройках модуля ELiS Lan полученные настройки на сайте https://example.com/admin/config/content/elis_lan.

ELiS настроена, можно приступать к импорту удаленных ресурсов.

Импорт[править]

Вы можете импортировать в ручном режиме и автоматическом.

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

ebs_lan_import.png

При автоматическом импорте:

  1. создайте папку каталога, в которую произведёте импорт всех изданий плоским списком;
  2. перейдите в папку и нажмите кнопку "Импорт";
  3. добавьте к URL "/lanbook" так, чтобы получилось URL вида: https://example.com/node/$nid/import/lanbook, где вместо $nid будет стоять идентификатор ноды каталога в который будет произведён импорт;
  4. вы увидите команду, которую надо выполнить на сервере для запуска импорта (подключившись к серверу по SSH). Пример команды:
    sudo -u elis php /usr/lib64/elis/drupal/importFromLanbook.php catalogNid=221680
    ;
  5. выполните команду на сервере и дождитесь окончания импорта. В случае сбоя импорта команду можно запустить повторно.

Внимание! Если вы импортируете слишком много книг в один каталог ELiS, этот каталог начнёт медленно открываться или не сможет открыться вообще. Перед автоматическим импортом уточните число импортируемых книг у технической поддержки Лани. Не рекомендуется превышать число импортированных книг больше 100. При импорте более 1000 книг пользователь может не дождаться открытия каталога с таким количеством книг.

ebs_lan_catalog.png

Авторизованный в приложении пользователь также окажется авторизован и в ЭБС для чтения удалённых книг:

lanbook_book.png