---

[I128-2330] При возврате на бронеполку изданий, выданных по МБА, появляется некорректное сообщение об ошибке

---

НАЧАЛО >> Оглавление >> Общее описание >> История изменений >> Что нового в проекте I128 >> Версия 2026.1.1 >> [I128-2330] При возврате на бронеполку изданий, выданных по МБА, появляется некорректное сообщение об ошибке📄 Скачать в DOCX

---

Тип	Версия	Статус	Приоритет	Исполнитель
⚙️ Исправление ошибок	2026.1.1	🔘 Завершено	Средний	Ilya Mikhaylenko

Компоненты: ИРБИС 128. Модуль Bookland - АРМ Книговыдача

Завершено: 23.04.2026 10:08

Симптом: 

 

При попытке вернуть издание на бронеполку, выданное по МБА появляется сообщение "Экземпляр МБА может быть возвращен только держателем документа (БД: ИмяБД)".

 

Причины:

 

Возврат на бронеполку состоял из двух операций - возврата в фонд и последующего бронирования экземпляра. При этом при возврате в фонд проводилась проверка возможности выполнения такого возврата что и приводило к сообщению о невозможности вернуть экземпляр (и его действительно нельзя вернуть).

 

Решение:

 

Для процесса возврата на бронеполку реализована собственная логика с отделением проверки возможности возврата на бронеполку от проверки возможности возврата в фонд - теперь у каждого из этих процессов собственные проверки.

-

Основные изменения:

• Изменение логики возврата на бронеполку: в BookReturnAndBroneByRdrOcc добавлена предварительная проверка возможности возврата, а вызов BookReturn заменен на прямую пошаговую трансформацию и сохранение записей читателя и книги (TransformRdrOccAsReturn, TransformBookOccAsReturn). Почему понадобилось сделать именно так:
  • Исключение конфликтов валидации и её дублирования. Монолитный метод BookReturn содержит собственную зашитую логику валидации (через RdrOccReturnPossibleCheck). У операции «Возврат на бронеполку» теперь появилась своя специфическая проверка — RdrOccReturnAndBronePossibleCheck. Если бы после новой проверки мы всё равно вызывали BookReturn, система выполняла бы валидацию дважды. Использование «чистых» функций трансформации (TransformRdrOccAsReturn и TransformBookOccAsReturn) позволяет применить нужные изменения к записям в обход стандартных проверок BookReturn, опираясь только на ту валидацию, которая была выполнена в начале метода.
  • Ранняя валидация (Early Fail) и экономия запросов к БД В старом варианте кода сначала происходило обращение к базе данных для получения записи каталога книги (GetDbBook, GetBookRecordByRdrOcc), и только потом вызывался BookReturn, внутри которого скрывались проверки. Если возврат был невозможен (например, книга не на руках), система выбрасывала исключение, но ресурсы на лишние запросы к БД уже были потрачены. В новом коде проверка RdrOccReturnAndBronePossibleCheck вынесена в самое начало метода. Если операция возврата на бронеполку для данного читателя невозможна, процесс прерывается мгновенно, до ресурсоемких обращений к базе данных каталога.
  • Прозрачность процесса и атомарность операций Разворачивание BookReturn в явную цепочку действий делает код гораздо более предсказуемым
• Декомпозиция валидации: логика проверок вынесена в отдельные атомарные функции для повторного использования (RecordOccCheck, RdrOccCheckIssued, RdrOccStrongReturnCheck, RdrOccReturnAndBronePossibleCheck).
• Поддержка режима "Только выдача": в проверки возврата (RdrOccReturnPossibleCheck, RdrOccReturnAndBronePossibleCheck) добавлена блокировка операций, если АРМ Книговыдача работает в режиме locklanddirection == 1.
• Самодокументирование (API метаданные): добавлены или расширены методы GetTitle, GetDescription и GetParamInfo во множестве файлов (включая RdrOccOutFilter, SetCurRdrAppBySearch и новые классы проверок) для улучшения описания исключений и параметров в интерфейсе/справке.
• Типизация: в файле api.php обновлены phpdoc-аннотации (@method) для новых методов, а в BookReturn.inc исправлены типы дефолтных значений с числовых строк на Integer.