Диагностика и обслуживание

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

1. Проверка целостности связей (CheckECLinks)

Для поддержания актуальности данных в системе предусмотрен инструмент CheckECLinks (Action FT/CheckECLinks).

Назначение: Массовая проверка соответствия между объектами электронных документов и ссылками в библиографических записях электронного каталога.
Выполняемые проверки:
- Поиск "битых" ссылок (ссылка в ЭК есть, а объекта в FT нет).
- Поиск объектов без привязки к ЭК (сиротские записи).
- Валидация контрольных сумм (MD5) исходных документов для подтверждения идентичности файлов.
Результат: Система формирует отчет со списком расхождений, что позволяет администратору оперативно исправить ошибки связывания.

2. Экспорт документации в DOCX

Модуль FT предоставляет системную возможность конвертации текстового контента в формат Microsoft Word с использованием Pandoc. Эта функция используется, например, в модуле Справки для скачивания разделов руководства в виде готовых документов.

Базовый механизм: действие MarkdownToDocx принимает Markdown-текст и целевой DOCX-файл, подготавливает временный входной файл и вызывает PandocConvert.
Шаблон оформления: если передан reference.docx, итоговый документ наследует стили заголовков, таблиц и основного текста из этого файла.
Изображения и ресурсы: параметр resourcePath задает базовую директорию для поиска изображений и других файлов, на которые ссылается Markdown.
Оглавление и режим документа: параметры передаются через PandocOptions, включая standalone, toc и toc-depth.
Диагностика: если Pandoc не найден, входной файл отсутствует или конвертация завершается ошибкой, модуль FT возвращает русскоязычное сообщение об ошибке.

Подробное описание расположения Pandoc, структуры каталога bin/ и API-оберток приведено в разделе Основные настройки.

3. Мониторинг фоновых процессов

Для каждого документа в его Sid-файлах сохраняются индикаторы состояния:

prepareViewerProcessId: Если файл содержит значение queued или ID задачи, значит процесс подготовки еще идет. Если файл отсутствует — подготовка завершена.
ExecFFMPEG.log / ExecFFMPEGV.log: Файлы журналов процесса конвертации медиафайлов. Находятся в папке логов сервера.
OCRTesseract.log: Основной лог-файл процесса распознавания текста. Находится в папке логов сервера.

4. Структура хранилища объектов

Все данные документов хранятся по пути: [DataPath]/OBJECTS/FT/[Первые 2 символа SID]/[Следующие 2 символа SID]/[Остаток SID]/

Внутри папки документа создаются поддиректории:

FT/Paged/img: Изображения страниц (PNG).
FT/Paged/txt: Текстовое содержимое страниц.
FT/Paged/coord: Координаты слов для подсветки.
FT/idx.txt: Полный текст всего документа (используется для индексации).

5. Очистка данных

При удалении записи FT система автоматически удаляет все связанные с ней файлы и директории из хранилища OBJECTS/FT/.