---

[I128-2228] Функционал обработки заявок на продление срока пользования экземпляром издания читателем

---

НАЧАЛО >> Оглавление >> Общее описание >> История изменений >> Что нового в проекте I128 >> Версия 2026.2 >> [I128-2228] Функционал обработки заявок на продление срока пользования экземпляром издания читателем📄 Скачать в DOCX

---

Тип	Версия	Статус	Приоритет	Исполнитель
⚙️ Новые возможности	2026.2	🔘 Завершено	Средний	Ilya Mikhaylenko

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

Завершено: 07.03.2026 21:15

1. Интерфейс

В интерфейс АРМа добавлена вкладка "Продление" (при условии включенной настройки isbroneallow):

1. Основное назначение

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

1. Главное окно: Список заявок на продление

Основным элементом является таблица, в которой отображаются необработанные заявки на продление. Каждая строка в таблице представляет одну заявку и содержит следующие колонки:

• Свободных экземпляров: Показывает количество свободных экземпляров данного издания.

• Шифр: Шифр издания в библиотеке.

• Продлить до: Дата, до которой читатель просит продлить пользование.

• Описание издания: Краткое библиографическое описание книги.

• Дата заявки: Дата, когда была подана заявка.

• Идентификатор пользователя: Уникальный идентификатор читателя.

• Пользователь: ФИО или другое краткое представление читателя.

• Примечание пользователя: Дополнительный комментарий от читателя к заявке.

• БД: База данных, в которой находится описание издания.

  1. Панель инструментов

Над таблицей расположена панель с кнопками для выполнения основных действий:

• {}Кнопка "Редактировать текущую запись"{}: Иконка: irb-edit (иконка редактирования). Подсказка: "Редактировать текущую запись". Функционал: При нажатии открывается окно редактора текущей записи заявки.
• {}Кнопка "Списки..."{}: Иконка: irb-print (иконка печати). Подсказка: "Списки...". Функционал: При нажатии открывается окно печати списка записей с возможностью выбора формата печати.
• {}Кнопка "Таблицы..."{}: Иконка: irb-print (иконка печати). Подсказка: "Таблицы...". Функционал: При нажатии открывается окно печати выходных форм с возможностью выбора формы.
• {}Кнопка "Статистические формы..."{}: Иконка: irb-stat (иконка статистики). Подсказка: "Статистические формы...". Функционал: При нажатии открывается окно печати статистических форм с возможностью выбора формы.
• Кнопка "Выполнить": Иконка: {}irb-rqstexec{}. Подсказка: "Выполнить заказ". Функционал: Одобряет заявку и выполняет операцию продления в системе.

• Показать информацию о читателе: Иконка: {}irb-usrlist{}. Подсказка: "Показать информацию о читателе". Функционал: Открывает карточку с подробной информацией о читателе, подавшем заявку.

• Показать информацию об издании: Иконка: {}irb-booklist{}. Подсказка: "Показать информацию об издании". Функционал: Открывает карточку с полной библиографической информацией о заказанном издании.

• Примечание к заказу: Иконка: {}irb-info{}. Подсказка: "Примечание к заказу". Функционал: Позволяет просмотреть примечание, оставленное пользователем.

• {}Кнопка "Отказать"{}: Иконка: irb-rqstdecline (иконка отказа). Подсказка: "Отказать читателю в продлении издания". Функционал: При нажатии открывается выпадающее меню со списком стандартных причин отказа (например, "Издание пользуется повышенным спросом"). Выбор причины приводит к отклонению заявки.

• {}Кнопка "Выполненные заказы"{}: Иконка: irb~~cart~~check (иконка выполненной корзины). Подсказка: "Выполненные заказы". Функционал: Открывает новое окно со списком всех ранее одобренных заявок на продление.

• {}Кнопка "Отказы"{}: Иконка: irb~~cart~~x (иконка корзины с крестиком). Подсказка: "Отказы". Функционал: Открывает новое окно со списком всех ранее отклоненных заявок.

  1. Окна истории

Интерфейс также включает два отдельных окна для просмотра истории обработки заявок:

• {}Окно "Выполненные заказы"{}: Таблица с одобренными заявками, содержащая информацию о читателе, издании, дате заказа и дате фактической выдачи (продления).

• Общие характеристики окна * Заголовок:* «Выполненные заказы». Тип: Модальное окно (блокирует работу с основным интерфейсом до закрытия). Размер: По умолчанию 700x410 пикселей, окно можно развернуть на весь экран (Maximizable). Фильтрация данных: В таблице отображаются записи из базы данных {}RQST{}, соответствующие условию: статус «Выполнен» ({}I=1{}) и тип заявки «Продление» ({}RQSTT=prolongation{}). ** Структура таблицы (Колонки) ***** Таблица содержит следующие столбцы с информацией о выполненных заявках:

1.

1.1.

1.1.1.

1.1.1.1. Идентификатор пользователя: Уникальный номер читателя (читательский билет).

1.1.1.2. Пользователь: ФИО читателя.

1.1.1.3. Шифр: Шифр издания.

1.1.1.4. Описание издания: Библиографическое описание книги.

1.1.1.5. Экземпляр: Инвентарный номер или штрих-код конкретного экземпляра, срок пользования которым был продлен.

1.1.1.6. Дата заказа: Дата, когда читатель подал заявку (формат: дд.мм.гггг или дд.мм.гггг чч:мм:сс).

1.1.1.7. Дата выдачи: Фактическая дата выполнения заявки (продления).

1.1.1.8. БД: Имя базы данных каталога, к которой относится издание.

1.1.1.9. Место хранения: Сигл места хранения экземпляра.

1.1.1.10. Примечание пользователя: Комментарий читателя к заявке (например, пометка «МБА» выделяется зеленым цветом).

• ** Дополнительные возможности * Так как компонент таблицы наследуется от WIrbis.RecListPanel128 и в конфигурации указаны соответствующие флаги, в этом окне также доступны: ** Печать: Кнопка для печати списка записей ({}showPrintRecs: true{}). ** Статистика: Возможность построения статистических форм по отображаемым данным ({}showStatForms: true{}). ** Сортировка: Возможность сортировки данных по клику на заголовок любого столбца.

• {}Окно "Отказы"{}: Таблица с отклоненными заявками, где дополнительно указываются причина отказа, дата отказа и ответственное лицо. Интерфейс окна «Отказы» представляет собой модальное окно, содержащее таблицу с историей отклоненных заявок на продление. Общие характеристики окна Заголовок: «Отказы». Тип: Модальное окно (блокирует работу с основным интерфейсом до закрытия). Размер: По умолчанию 700x410 пикселей, окно можно развернуть на весь экран (Maximizable). Фильтрация данных: В таблице отображаются записи из базы данных {}RQST{}, соответствующие условию: статус «Отказ» ({}I=3{}) и тип заявки «Продление» ({}RQSTT=prolongation{}). Структура таблицы (Колонки) ***** Таблица содержит следующие столбцы с информацией об отклоненных заявках:

2.

2.1.

2.1.1.

2.1.1.1. Идентификатор пользователя: Уникальный номер читателя (читательский билет).

2.1.1.2. Пользователь: ФИО читателя.

2.1.1.3. Шифр: Шифр издания.

2.1.1.4. Описание издания: Библиографическое описание книги.

2.1.1.5. Причина: Причина отказа в продлении (выбирается библиотекарем из справочника при отклонении заявки).

2.1.1.6. Дата заказа: Дата, когда читатель подал заявку.

2.1.1.7. Дата отказа: Дата, когда заявка была отклонена сотрудником библиотеки.

2.1.1.8. Ответственное лицо: ФИО или логин сотрудника, оформившего отказ.

2.1.1.9. БД: Имя базы данных каталога, к которой относится издание.

2.1.1.10. Примечание пользователя: Комментарий читателя к заявке (например, пометка «МБА» выделяется зеленым цветом).

• Дополнительные возможности * Аналогично окну выполненных заказов, компонент наследуется от {}WIrbis.RecListPanel128{}, поэтому доступны: ** Печать: Кнопка для печати списка записей ({}showPrintRecs: true{}). ** Статистика: Возможность построения статистических форм по отображаемым данным ({}showStatForms: true{}). ** Сортировка: Возможность сортировки данных по клику на заголовок любого столбца.

  1. Технические детали

• Добавлена новая таблица WIrbis.B.RqstProlongationTable для отображения списка заявок на продление (фильтр RQSTT=prolongation).

• Добавлено модальное окно WIrbis.B.RqstProlongationWindow для обработки заявки библиотекарем (выбор новой даты возврата).

• В интерфейс АРМа добавлена вкладка "Продление" (при условии включенной настройки isbroneallow).

• Скорректированы поисковые запросы в таблицах обычных заказов (RqstTable) и бронирования (Rqstbrtb), чтобы исключить из них заявки на продление.

• Зарегистрированы новые JS-файлы в WIrbis/api.php.

• Реализован новый Action RqstExecProlongation для выполнения продления.

• Обновлена функция Prodl (__call/Prodl.inc): Добавлена поддержка привязки к записи заявки ($rqstRec). Реализовано удаление признака запроса из записи читателя после выполнения. Исправлен расчет даты возврата (использование strtotime для корректной работы с переходом месяцев/лет). Добавлена блокировка файла (flock) при обновлении статистики.

• В стандартный RqstExec добавлено исключение ExceptionBooklandRqstExec_IsProlongation, которое перехватывает попытку выполнить продление как обычный заказ и открывает соответствующее окно.

• Добавлена функция Bookland::GetRdrOccByRqst для поиска экземпляра у читателя по данным из заявки.

-

I128~~2223 Функция Bookland::GetDbBookByRdrOcc(ObjectDataRecord $rdrRec, int $rdrOcc): ObjectDataDatabase I128~~2224 Новый раздел настроек АРМ Книговыдача "Настройка подсистемы заявок на продление срока пользования изданием" I128~~2225 Новый Action RQST/GetRqstProlongationForm: Возвращает HTML-форму для модального окна продления I128~~2226 Новый Action RQST/CreateRequestProlongationBS: Обрабатывает логику создания заявки на продление (валидация дат, обновление записи читателя, создание записи в БД заказов) I128~~2227 Возможность для читателей в разделе "Книги на руках" сформировать заявку на продление срока пользования экземпляром издания I128~~2228 Функционал обработки заявок на продление срока пользования экземпляром издания читателем

• Добавлена функция Bookland::GetDbBookByRdrOcc(ObjectDataRecord $rdrRec, int $rdrOcc): ObjectDataDatabase

• Оптимизация GetDbBookByRdrOcc.inc

• Добавлена настройка подсистемы заявок на продление в Bookland

  В модуль Bookland добавлены конфигурационные параметры для управления подсистемой заявок на продление срока пользования изданиями.

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

  • В ApplyGeneralVariablesConfig.inc добавлен новый раздел настроек "Настройка подсистемы заявок на продление срока пользования изданием".
  • Реализованы параметры для включения подсистемы (isprolongationallow), отправки уведомлений на email (isprolongationmail), настройки фильтрации, пагинации и форматов отображения.
  • Добавлена возможность настройки дополнительных колонок и пользовательских кнопок для списка заявок.
  • Добавлены настройки подполей для даты продления (rdrdelimprolongation) и даты заявки на продление (rdrdelimreturndaterequest).
  • В api.php обновлен класс BooklandAnswer: добавлены новые свойства в PHPDoc и уточнены сигнатуры методов работы с БД.

• Bookland: уточнение типов возвращаемых значений и исправление обработки тега шифра

  • В методах GetDbBook, GetDbRdr, GetDbRqst изменен тип возвращаемого значения с ObjectData на ObjectDataDatabase.
  • В RqstExec добавлено приведение dbntagshifr к целому числу (intval) при вызове GetSubField для корректной работы с полями.

• Реализована функциональность продления книг и рефакторинг подсистемы заказов (RQST)

  Подсистема заказов (RQST):

  • Рефакторинг типов заказов: Внедрена классовая структура для обработки типов заказов. Создан базовый класс RQSTExType и наследники ExTypeedd (ЭДД) и ExType_prolongation (Продление).
  • Фабрика типов: Добавлен RqstExTypeFactory для обеспечения обратной совместимости со старым форматом передачи параметров ($scaninfo в виде массива).
  • CreateRequestRecord:
    • Метод переписан с использованием строгой типизации аргументов (ObjectDataDatabase, ObjectDataRecord).
    • Добавлена поддержка объектов RQST_ExType для формирования поля 928.
    • Улучшена обработка ошибок и проверок (должники, лимиты, доступность экземпляров).
  • Новые Action-ы:
    • GetRqstProlongationForm: Возвращает HTML-форму для модального окна продления.
    • CreateRequestProlongationBS: Обрабатывает логику создания заявки на продление (валидация дат, обновление записи читателя, создание записи в БД заказов).
  • Добавлен статический метод RQST::getInstance() и подключение новых классов.

  Кабинет читателя и История чтения (Users):

  • В формат ReadHistory.pft128 добавлена кнопка "Продлить" для текущих выдач (страница GetKvInfo).
    • Оптимизирована функция highlight (использование preg_replace вместо рекурсии).
    • Исправлена логика фильтрации записей (долги/история) и передача номера повторения (occ) для корректной работы продления.

  АРМ Читатель (EC):

  • В irbis-advancedsearch.js добавлен метод WIrbis.EC.requestBookProlongation для вызова формы продления и обработки ответа сервера.
  • Мелкие исправления форматирования в JS.

• Изменения касаются реализации функционала заявок на продление книг в модуле АРМ Книговыдача (Bookland) и Кабинете читателя.

  • АРМ Книговыдача: Реализация функционала заявок на продление книг
    • Добавлена новая таблица WIrbis.B.RqstProlongationTable для отображения списка заявок на продление (фильтр RQSTT=prolongation).
    • Добавлено модальное окно WIrbis.B.RqstProlongationWindow для обработки заявки библиотекарем (выбор новой даты возврата).
    • В интерфейс АРМа добавлена вкладка "Продление" (при условии включенной настройки isbroneallow).
    • Скорректированы поисковые запросы в таблицах обычных заказов (RqstTable) и бронирования (Rqstbrtb), чтобы исключить из них заявки на продление.
    • Зарегистрированы новые JS-файлы в WIrbis/api.php.
    • Реализован новый Action RqstExecProlongation для выполнения продления.
    • Обновлена функция Prodl (__call/Prodl.inc):
      • Добавлена поддержка привязки к записи заявки ($rqstRec).
      • Реализовано удаление признака запроса из записи читателя после выполнения.
      • Исправлен расчет даты возврата (использование strtotime для корректной работы с переходом месяцев/лет).
      • Добавлена блокировка файла (flock) при обновлении статистики.
    • В стандартный RqstExec добавлено исключение ExceptionBooklandRqstExec_IsProlongation, которое перехватывает попытку выполнить продление как обычный заказ и открывает соответствующее окно.
    • Добавлен хелпер GetRdrOccByRqst для поиска экземпляра у читателя по данным из заявки.
  • RQST (Создание заявок):
    • Обновлен класс RqstExTypeprolongation: расширен набор сохраняемых данных в поле 928 (БД читателя, идентификатор, шифр книги, инвентарный номер и т.д.).
    • CreateRequestProlongationBS: Добавлена проверка на существование уже активной заявки на продление для данного экземпляра.
    • GetRqstProlongationForm: Добавлена проверка на дубликаты заявок и расчет даты по умолчанию.
  • Кабинет читателя (Users):
    • Обновлен формат ReadHistory.pft128:
      • Оптимизирована загрузка записей книг (пакетный запрос вместо цикла).
      • Добавлено отображение статуса "в обработке заявка на продление".
      • Добавлена кнопка "Продлить" для выданных книг.

• Функционал продления:

  • Исправлена логика отображения вкладки продления: теперь она зависит от настройки isprolongationallow, а не isbroneallow (отвязана от бронирования).
  • В таблицу заявок на продление добавлена колонка «Продлить до» (формат RqstProlongationRequestDate).
  • Колонка «Дата заказа» переименована в «Дата заявки».
  • Добавлены настройки для конфигурации колонок в списках выполненных заявок на продление и отказов (prolongationcolumnlistissue, prolongationcolumnlistdeny).

  Рефакторинг и оптимизация:

  • Show.inc: Переход на использование getInstance(), оптимизация передачи конфигурации колонок в JS (устранение дублирования кода).
  • JS: Оптимизирован рендеринг статусов МБА (замена множественных if/else на карту статусов).

  Исправление ошибок:

  • Исправлена опечатка в названии настройки «Номер поля читательского билета» и код подполя (C кириллическое -> C латинское).
  • Изменен код подполя для настройки checkoutdefaultdays (Z -> 3).

  Форматы:

  • Обновлены форматы RQSTHTML.pft128, full.pft128, rqsthtml_bookland.pft128:
    • Добавлена логика определения типа заявки (Заказ или Заявка на продление).
    • Вывод даты, до которой запрашивается продление.
    • Добавлено экранирование спецсимволов (htmlspecialchars) для безопасности и корректного отображения.
  • Добавлен новый формат RqstProlongationRequestDate.pft128 для вывода даты продления (поле 928^B).

3. Связанные задачи

3.1. 🔗 Соответствует задача: I128-2229