---

Настройка формы проверки фонда

---

НАЧАЛО >> Документация >> Руководство администратора >> Настройка формы проверки фонда📄 Скачать в DOCX

---

Специальный блок для конфигурации сервиса инвентаризации («Проверка фонда»).

1. БД по которым проводить проверку фонда (checkFondDatabases)

Позволяет ограничить инвентаризацию конкретными базами каталога.

• Влияет на:
  • Экшен ShowCheckFondForm (Страница «Проверка фонда») — поиск сканируемых штрих-кодов или инвентарных номеров и обновление данных в найденных экземплярах. Если не задан, используется БД по умолчанию.
  • Страницу Complectator/ProvFondReport («Отчет о проверке фонда») — перебор указанных баз для формирования отчета о недостачах и проверенном фонде.

2. Разделитель подполя для идентификатора полки (checkFondShelfSubField)

Символ подполя, в которое будет записываться штрих-код полки (по умолчанию +).

• Влияет на:
  • Экшен ShowCheckFondForm — при сканировании полки её номер записывается в указанное подполе поля 910 найденного экземпляра.
  • Страницу Complectator/ProvFondReport — используется для фильтрации результатов по конкретной полке при формировании отчета.

3. Использовать единую форму проверки фонда (одно поле ввода) (checkFondUnifiedMode)

Переключает интерфейс проверки фонда в современный режим. По умолчанию эта настройка отключена (значение 0), и используется классическая форма.

• Влияет на: Экшен ShowCheckFondForm — меняет внешний вид формы ввода. При включении выводится одно большое текстовое поле для сканирования штрих-кодов полок и книг вперемешку, вместо классических раздельных полей.

4. Частота звука ошибки (Гц) (checkFondErrorSoundFreq)

Тональность звукового сигнала при ошибке сканирования (по умолчанию 150).

• Влияет на: Экшен ShowCheckFondForm — генерация звука через Web Audio API (форма волны sawtooth). Воспроизводится прямо в браузере, если сканируемая книга не найдена или произошла ошибка статуса. Загрузка дополнительных аудиофайлов на сервер не требуется. Если указать значение 0 или отрицательное число, система автоматически применит значение по умолчанию (150 Гц).

5. Воспроизводить звуковой сигнал при ошибке (checkFondPlayErrorSound)

Включает или выключает звуковые оповещения об ошибках при проверке фонда.

• Влияет на: Экшен ShowCheckFondForm — задает первоначальное состояние кнопки управления звуком на странице. При этом пользователи могут вручную переключать звук в интерфейсе — их личный выбор сохранится в памяти браузера (localStorage под ключом checkFondPlayErrorSoundLocal) и будет иметь приоритет над системной настройкой.

6. Настройка полей и подполей для проверки фонда

Маппинг полей библиографической записи (обычно поле 910 для экземпляров). Данный блок настроек напрямую влияет на логику обновления записи и формирование отчетов.

6.1. Подполе для штрих-кода (checkFondBarcodeSubfield)

Символ подполя, содержащего штрих-код экземпляра (по умолчанию H).

• Влияет на:
  • Экшен ShowCheckFondForm — поиск библиографической записи и конкретного повторения поля экземпляра для обновления статуса.
  • Страницу Complectator/ProvFondReport — поиск экземпляров, а также проверка выдачи читателям (поиск в БД RDR по штрих-коду).

6.2. Подполе для инвентарного номера (checkFondInvNumSubfield)

Символ подполя, содержащего инвентарный номер экземпляра (по умолчанию B).

• Влияет на:
  • Экшен ShowCheckFondForm — альтернативный идентификатор для поиска записи и её обновления.
  • Страницу Complectator/ProvFondReport — поиск экземпляров и проверка задолженностей в БД RDR.

6.3. Подполе для даты проверки (checkFondDateSubfield)

Символ подполя, в которое записывается дата проверки (по умолчанию S).

• Влияет на:
  • Экшен ShowCheckFondForm — обновление данного подполя текущей датой сервера в формате Ymd (например, 20260415) при сканировании.
  • Страницу Complectator/ProvFondReport — отбор проверенных и непроверенных экземпляров путем сравнения данного подполя с датой начала проверки, указанной в фильтре.

6.4. Подполе для ФИО проверявшего (checkFondUserSubfield)

Символ подполя для записи ФИО сотрудника, проводившего инвентаризацию (по умолчанию ().

• Влияет на: Экшен ShowCheckFondForm — при успешном сканировании заполняется ФИО текущего пользователя системы (берется из полей 10, 11, 12 профиля сотрудника, либо берется логин из 30^A при их отсутствии). В отчетах используется для отображения ответственного.

6.5. Подполе для фактического места хранения (checkFondMhrSubfield)

Символ подполя, куда записывается подтвержденное место хранения (по умолчанию !).

• Влияет на:
  • Экшен ShowCheckFondForm — актуализация места хранения (полученного из правил полок или выбранного из списка) в записи экземпляра.
  • Страницу Complectator/ProvFondReport — отбор экземпляров для отчета по месту хранения (при этом система также проверяет стандартные подполя D и d, что позволяет корректно учитывать еще не проверенный фонд).

6.6. Подполе для истории проверки (checkFondHistorySubfield)

Символ подполя для хранения предыдущих дат проверок (по умолчанию )).

• Влияет на: Экшен ShowCheckFondForm — в это подполе переносится старая дата проверки, инвентарный номер (если отсутствует, используется штрих-код) и ФИО проверявшего в формате инвентарь/дата/ФИО. История сохраняется только в том случае, если у экземпляра уже была заполнена дата предыдущей проверки или ФИО проверявшего. При первичной проверке пустая история не создается.

6.7. Поле для копии с историей (checkFondHistoryField)

Метка поля (по умолчанию 9101), в которое полностью копируется поле экземпляра для сохранения истории.

• Влияет на: Экшен ShowCheckFondForm — после актуализации данных о текущей проверке в поле 910, обновленное поле копируется в указанную метку (например, 9101). Добавление нового повторения происходит только если его содержимое отличается от последнего добавленного, что предотвращает дублирование идентичных исторических записей при случайном повторном сканировании.

6.8. Подполе для цены (checkFondPriceSubfield)

Символ подполя цены экземпляра (по умолчанию E).

• Влияет на: Экшен ShowCheckFondForm — вывод цены в результатах на странице инвентаризации. Если цена в 910 поле отсутствует, система автоматически попытается подставить значение из поля 10^D библиографического описания.

6.9. Лимит записей в архиве проверок (checkFondArchiveLimit)

Количество последних сеансов сканирования, которые хранятся в архиве (по умолчанию 100). Если указать значение 0 или отрицательное число, система проигнорирует его и применит лимит в 100 записей (сделать архив безлимитным или отключить его таким образом нельзя).

• Влияет на:
  • Экшен ShowCheckFondForm — автоматическая очистка старых сеансов из локальной БД ProvFondArchive.db при добавлении новых.
  • Страницу Complectator/ProvFondArchive — ограничивает максимальное количество доступных для просмотра записей в архиве.

7. Правила определения места хранения по полке (shelfMhrRules)

Позволяет задать диапазоны штрих-кодов полок и соответствующее им место хранения. Список доступных мест хранения для правил подгружается из справочника mhr.mnu базы данных комплектования. Сравнение диапазонов происходит по принципу сравнения строк, поэтому для корректной работы диапазонов важно соблюдать ведущие нули (например, от 00000010 до 09999999).

• Влияет на:
  • Класс Complectator (функция GetMhrByShelf в api.php) — определение места хранения по штрих-коду полки. Если диапазоны пересекаются, применяется первое совпавшее правило (порядок расположения правил имеет значение).
  • Экшен ShowCheckFondForm — при включенной единой форме ввода автоматически подставляет место хранения по отсканированному штрих-коду полки, применяя найденное место ко всем последующим книгам до сканирования новой полки.

8. Важные технические особенности (для системного администратора)

Хотя большинство параметров гибко настраивается, некоторые поисковые алгоритмы проверки жестко зашиты в коде модуля. Для корректной работы сервиса убедитесь, что ваши поисковые словари (FST) в базах данных соответствуют следующим требованиям:

• Поиск изданий в электронном каталоге: При сканировании система ищет библиографическую запись в выбранных базах каталога с использованием префиксов IN= (штрих-код) и B= (инвентарный номер). После нахождения записи обновляется то повторение поля 910, где значение совпало с настроенным подполем штрих-кода (checkFondBarcodeSubfield) или инвентарного номера (checkFondInvNumSubfield).
• Поиск сводного описания журнала: При сканировании номеров журналов (тип записи NJ) система для полноты отображения пытается найти сводное описание журнала по префиксу I= (ищется шифр, указанный в поле 933 номера). Из найденной сводной записи извлекаются город (210^A) и первые сведения об ответственности (200^A), а год, том и номер берутся из самой записи экземпляра (934, 935, 936).
• Различение ошибок отсутствия: Если библиографическая запись вовсе не найдена по префиксам IN= или B=, система выдаст ошибку «ЗАПИСЬ НЕ НАЙДЕНА». Если же запись найдена, но внутри неё нет повторения 910 поля с указанным штрих-кодом/инвентарным номером, ошибка будет детализирована как «НЕ НАЙДЕНО В ЭКЗЕМПЛЯРАХ».
• Дублирование штрих-кодов в записи: Если в библиографической записи из-за ошибки каталогизации заведено несколько повторений 910 поля с одинаковым штрих-кодом или инвентарным номером, система обновит статус и данные проверки только у последнего найденного повторения.
• Формирование отчета: Для успешной генерации отчета по фонду (ProvFondReport) в электронном каталоге обязательно должен присутствовать поисковый индекс с префиксом MHR= (Место хранения). Без него отчет не сможет отбирать экземпляры проверяемого фонда. Для стабильной работы при больших объемах данных система извлекает и обрабатывает записи порциями по 5000 штук.
• Фильтрация отчета по полке: При запросе отчета с указанием номера полки фильтрация по ней происходит программно (в оперативной памяти). Система сначала загружает все записи выбранного места хранения по индексу MHR=, а затем отсеивает экземпляры с неподходящей полкой. При значительных объемах фонда в одном месте хранения это может требовать дополнительного времени (что объясняет системное увеличение лимита времени выполнения отчета до 10 минут).
• Поиск информации о выдаче в базе читателей: При формировании отчета для проверки корректности статуса «Выдано» (Статус 1), система ищет читателя с данным экземпляром на руках по префиксам H= (по штрих-коду) и B= (по инвентарному номеру) среди выданной литературы. Название базы читателей берется из настроек модуля Bookland, а если не задано — по умолчанию используется БД RDR. Если книга числится выданной, но была найдена при проверке на полке, система сверяет дату выдачи (извлекается из подполей 40^D или 40^d записи читателя) с датой проверки. Если книга выдана в день проверки или позже, это не фиксируется как ошибка (так как книга могла быть отсканирована утром, а выдана читателю днем). Если дата выдачи отсутствует или имеет некорректный формат, система пометит такую книгу как ошибочную (найденную на полке). Имя читателя в отчете строится из полей 10, 11, 12, а при их отсутствии — из 30^A (иначе выводится «Неизвестный читатель» с указанием содержимого поля 30).
• Очистка формата даты выдачи: При извлечении даты выдачи из подполей 40^D или 40^d система удаляет все нечисловые символы и берет первые 8 цифр. Для корректного сравнения дата в базе должна начинаться с года (в формате YYYYMMDD или YYYY.MM.DD). Использование форматов вида DD.MM.YYYY приведет к ошибкам валидации дат (в том числе к ложным срабатываниям об ошибках выдачи).
• Кросс-проверка штрих-кодов в БД читателей: В отчете при сопоставлении найденного читателя система использует дополнительную страховку: штрих-код экземпляра из ЭК сверяется не только со штрих-кодом в читательском билете (40^H), но и с инвентарным номером читательского билета (40^B). Это предотвращает ложные ошибки, если при выдаче штрих-код был ошибочно занесен в подполе инвентарного номера. В случае полного отсутствия инвентарного номера и штрих-кода у самого издания, в отчете ему будет присвоен технический идентификатор Без номера.
• Автоматический зачет выданных изданий: Если в отчете экземпляр числится как выданный (статус 1) и за ним найдена запись читателя, система автоматически перенесет его в список «Найденные / Проверенные» даже в том случае, если его штрих-код вообще не сканировался в ходе проверки.
• Статусы экземпляров: Аналитический отчет (ProvFondReport) опирается на системный справочник ste.mnu и базовые коды статусов для выявления проблем: 0 (или пустое значение) — свободен/на полке, 1 — выдан читателю, 4 — утерян, 6 — списан. При проверке статусов в 910 поле система учитывает как заглавное подполе ^A, так и строчное ^a. Если справочник ste.mnu отсутствует или статус в нем не найден, пустой статус (или 0) будет отображен как «Свободен (на полке)», а неизвестный код — как «Статус N».
• Очистка данных при экспорте в CSV: При выгрузке отчета ProvFondReport в формате CSV библиографическое описание (которое возвращается форматом brief) автоматически очищается от HTML-тегов (strip_tags) и HTML-сущностей, чтобы текст в Excel отображался без служебной разметки.
• Очистка вводимых данных: При обработке введенного вручную списка (или загруженного из файла) система автоматически обрезает пробелы и невидимые символы по краям (trim()), а также игнорирует пустые строки. Это гарантирует бесперебойную работу при смешанном формате окончаний строк (Windows/Linux) в файлах ТСД.
• Тестирование звукового сигнала: Кнопка управления звуком на странице проверки фонда при ручном переключении воспроизводит короткий тестовый сигнал (синусоида 440 Гц, 0.1 с). Это позволяет проверить работоспособность аудио в браузере без необходимости искусственно вызывать реальную ошибку (которая звучит дольше и с использованием формы волны sawtooth).
• Физическое хранение архива: История проведенных сеансов сохраняется в базу SQLite независимо от основного каталога. Файл базы данных располагается на сервере по пути [DataPath]/SQLiteData/ProvFondArchive/ProvFondArchive.db. При необходимости его можно архивировать или удалять для полного сброса.
• Режим журналирования базы архива (WAL): Так как SQLite база архива инициализируется в режиме Write-Ahead Logging (PRAGMA journal_mode=WAL;), рядом с файлом ProvFondArchive.db будут автоматически создаваться временные файлы ProvFondArchive.db-wal и ProvFondArchive.db-shm. При ручном резервном копировании базы администратору необходимо копировать все три файла.
• Разблокировка Web Audio API: Так как современные браузеры блокируют автоматическое воспроизведение звука, в скрипт встроен механизм принудительной разблокировки аудиоконтекста (AudioContext) при первом клике или нажатии любой клавиши на странице.
• Таймауты веб-сервера: Скрипты проверки штрих-кодов (ShowCheckFondForm.inc) и генерации отчетов (ProvFondReport.page) могут выполняться долго. Они принудительно увеличивают внутренний лимит выполнения PHP до 10 минут (ini_set('max_execution_time', 10 * 60);). Системному администратору нужно убедиться, что таймауты фронтенд-сервера (например, proxy_read_timeout в Nginx или TimeOut в Apache) также допускают ожидание ответа до 600 секунд, чтобы пользователи не сталкивались с ошибкой 504 Gateway Time-out.
• Загрузка штрих-кодов из файла: Прикрепленный пользователем текстовый файл (.txt) обрабатывается путем прямого добавления его содержимого в конец списка, введенного в текстовое поле вручную, через перенос строки (\n). К нему применяются ровно те же правила разбора, что и к тексту в форме (включая работу режима единой формы).
• Оптимизация при отсутствии полки: В едином режиме ввода, если в массиве штрих-кодов встречаются книги до того, как была отсканирована первая корректная полка, скрипт вообще не выполняет запросы к БД для этих книг, сразу помечая их ошибкой Для этой книги не была указана полка, что существенно экономит ресурсы сервера.

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