---

Основные настройки

---

НАЧАЛО >> Электронная библиотека >> Руководство администратора модуля FT >> Настройка модуля и параметров отображения >> Основные настройки📄 Скачать в DOCX

---

В этом разделе описаны общие параметры конфигурации модуля «Электронная библиотека» (FT), не относящиеся к конкретным типам файлов.

1. Префикс имени файла с полнотекстовым индексом (idxprefix)

Префикс, который будет использоваться для файлов с полнотекстовым индексом (по умолчанию idx). При указании папки необходимо самостоятельно создать соответствующую директорию на сервере ИРБИС 64.

2. Запрещенные к загрузке типы файлов (deniedexts)

Позволяет задать список расширений файлов, загрузка которых будет заблокирована.

3. Ограничения на размер загружаемых файлов

Максимальный размер загружаемых полнотекстовых документов не регулируется настройками самого модуля. Он зависит от глобальных настроек интерпретатора PHP. Для увеличения лимитов необходимо изменить параметры upload_max_filesize, post_max_size и memory_limit в конфигурационном файле php.ini вашего веб-сервера.

4. Автоматическая обработка метаданных

Для удобства каталогизаторов модуль автоматически выполняет нормализацию данных при сохранении записи:

• Ключевые слова: Если в поле «Ключевые слова» (поле 6) ввести несколько терминов через запятую, система автоматически разобьет их на отдельные повторения поля.
• Определение формата файла: При загрузке документов система игнорирует заявленное расширение файла и выполняет глубокий анализ его бинарной сигнатуры (Magic Bytes), внутренней структуры ZIP-архивов (для офисных форматов) и метаданных медиафайлов. Это позволяет автоматически и безошибочно определять истинный тип документа (PDF, DOCX, XLSX, PPTX, JPG, WEBP, MP3 и др.), даже если файл был переименован с ошибкой.

5. Индивидуальные действия и свойства документа

В карточке редактирования отдельного документа (при ручной корректировке) каталогизаторам доступны дополнительные поля, такие как «Текст для ссылки» (текст, отображаемый вместо классического URL) и «Характер документа» (возможность классификации: текстовый, графический, аудио и др.).

Кроме того, в блоке «Действия с документом» предусмотрены специальные кнопки для ручного запуска фоновых задач по конкретной записи: вы можете принудительно запустить индексирование документа, пересоздать страницы для просмотра, обновить ссылки на полный текст в библиографической записи ИРБИС и инициировать процесс транскрибации для медиафайлов.

6. Пользовательские функции

Позволяет расширить стандартное поведение модуля за счет подключения пользовательских скриптов.

• Дополнительные поля для хранения (usrFuncFieldsModule / usrFuncFieldsFunc): PHP-функция для модификации списка полей редактора. Функция должна иметь вид array funcname(array $varlist). В качестве параметра она принимает текущий список полей редактора и должна вернуть модифицированный список.
• Дополнительные действия ПОСЛЕ сохранения документа (usrFuncOnAfterSaveModule / usrFuncOnAfterSaveFunc): PHP-функция, вызываемая сразу после успешного сохранения записи. Функция должна иметь вид funcname($db, $r), где $db — объект базы данных, в которую произошло сохранение, а $r — сохраняемая запись (объект полного текста).

7. Групповые права доступа (FTCollections)

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

В панели администрирования (в списке записей ЭБ) доступен удобный инструмент пакетного назначения прав: выделите несколько нужных документов галочками и нажмите кнопку «Установить группу прав» на верхней панели инструментов. В этом же окне можно включить «Очистить ненаследуемые права», чтобы при переносе документов на групповое право удалить локальные правила доступа и оставить только наследуемые права.

8. Специфичные права доступа

В подсистеме безопасности (в профиле группы или конкретного пользователя) для модуля "Электронная библиотека" можно настроить специфичные права доступа к документам:

• Разрешено скачивание исходного файла (ALLOWSOURCEDOWNLOAD) — дает пользователю право скачать оригинальный (исходный) файл документа, а не только просматривать его через вьювер.
• Разрешено скачивание процента страниц файла (ALLOWPERCENTDOWNLOAD) — дает пользователю право скачивать или распечатывать определенный процент от общего числа страниц (применимо для многостраничных документов).
• Право администрирования документа (ADMIN) — помимо общих прав на редактирование записи, позволяет пользователю переназначать логические номера страниц прямо в интерфейсе современного просмотрщика (Vanila).

8.1. Информация об авторских правах

Лимиты для прав доступа задаются администратором индивидуально для каждого документа в его метаданных. При редактировании записи полного текста раскройте блок «Информация об авторских правах». В нем доступны следующие поля:

• Файл авторского договора — возможность прикрепить скан-копию соглашения.
• Дата и Дата окончания действия — период легитимности прав на распространение.
• Процент страниц, разрешенных для скачивания и Процент страниц, разрешенных для печати — числовые лимиты. Если права группы разрешают частичное скачивание, система ограничит объем загрузки/печати указанным здесь процентом (по умолчанию 100%).

9. Внутренняя статистика просмотров

Независимо от интеграции с АРМ «Книговыдача» или другими модулями, Электронная библиотека ведет собственный лог обращений к документам. При каждом открытии полного текста система сохраняет запись в локальную базу статистики (FTStat), фиксируя точное время, логин пользователя, IP-адрес и краткое библиографическое описание документа.

10. Фоновая обработка задач (Очередь)

Большинство ресурсоемких операций электронной библиотеки (конвертация видеофайлов через FFMPEG, нарезка многостраничных документов на изображения для просмотра, извлечение текстового слоя) выполняется асинхронно. Для их успешного старта и завершения в системе должен корректно функционировать демон модуля «Очередь задач» (Queue). Задачи конвертации могут занимать длительное время в фоне (тайм-аут на некоторые операции до 24 часов).

11. Интеграция с Pandoc

Модуль содержит встроенные механизмы конвертации текстов из форматов Markdown (включая расширенную версию GitHub Flavored Markdown — GFM) в формат DOCX. Для работы используется поставляемая вместе с системой утилита Pandoc.

Интеграция состоит из нескольких уровней:

• PandocConvert — универсальный вызов Pandoc для преобразования файла из одного документного формата в другой. Действие принимает входной и выходной файлы, при необходимости явные форматы fromFormat/toFormat и объект параметров PandocOptions.
• MarkdownToDocx — специализированное действие для формирования DOCX из Markdown-текста. Оно создает временный Markdown-файл, передает его в PandocConvert, применяет DOCX-шаблон и удаляет временные данные после завершения.
• PandocOptions — объект настройки аргументов Pandoc. Через него включаются режим standalone, оглавление, глубина оглавления, reference-doc, resource-path и дополнительные аргументы.

Исполняемый файл Pandoc выбирается автоматически по платформе:

• Windows: modules/FT/bin/win64/pandoc/pandoc.exe;
• Linux: modules/FT/bin/nix64/pandoc/pandoc.

В этой же структуре bin/ размещаются и другие поставляемые внешние утилиты модуля FT, включая ffmpeg, ffprobe и mutool. Не переносите эти файлы вручную: код модуля рассчитывает их расположение относительно каталога modules/FT.

Для DOCX-конвертации можно передать файл-образец оформления reference.docx. Если шаблон указан, Pandoc использует его стили заголовков, таблиц и основного текста. Для корректной вставки изображений нужно передать resourcePath — базовый каталог, относительно которого находятся файлы, упомянутые в Markdown.

При ошибках модуль возвращает локализованные сообщения:

• Исполняемый файл pandoc не найден в системе — Pandoc отсутствует в ожидаемом пути или недоступен для выполнения;
• Входной файл не найден — исходный файл конвертации недоступен;
• Ошибка конвертации файла — Pandoc завершился с ненулевым кодом, подробности добавляются к сообщению исключения.

12. Дополнение по групповым правам

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