1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | ВерсииРасширений |
| Полное имя | Справочник.ВерсииРасширений / Catalogs.ВерсииРасширений |
| Синоним | «Версии расширений» |
| Конфигурация | Управление торговлей для Казахстана, ред. 3.4 (3.4.5.21) |
| Где найти | e1cib/list/Справочник.ВерсииРасширений |
| Назначение | Служебный справочник Библиотеки стандартных подсистем (БСП). Хранит реестр подключённых расширений конфигурации и версий, для которых уже отработали обработчики обновления данных. Используется механизмом «Обновление версии ИБ» для запуска обработчиков обновления расширений при смене их версии. |
Это технический (служебный) объект. Он не предназначен для ручного ведения пользователем, не связан с учётными данными, товарами, взаиморасчётами или налогами. В интерфейсе пользователя, как правило, скрыт и доступен только администратору/разработчику.
2. Реквизиты шапки и табличные части
Справочник иерархии не имеет, табличных частей не содержит. Стандартные и прикладные реквизиты:
| Реквизит | Тип | Назначение |
|---|---|---|
Код |
Строка/Число | Стандартный код элемента. Служебный, содержательной нагрузки для пользователя не несёт. |
Наименование |
Строка | Представление расширения (имя расширения). |
ПометкаУдаления |
Булево | Стандартный признак пометки на удаление. |
ИдентификаторРасширения |
Строка / УникальныйИдентификатор | GUID расширения, по которому оно однозначно идентифицируется в ИБ. Ключ сопоставления записи справочника с конкретным подключённым расширением. |
ХешСумма / КонтрольнаяСумма |
Строка | Хеш (контрольная сумма) состава расширения. По изменению хеша механизм обновления понимает, что расширение изменилось и нужно повторно отработать обработчики. |
ВерсияРасширения |
Строка | Версия расширения в формате X.X.X.X, зафиксированная на момент последнего успешного обновления данных. |
Требует проверки: точный состав прикладных реквизитов и их имена версионно-специфичны и зависят от редакции БСП, встроенной в 3.4.5.21. В части релизов версия/хеш хранятся не реквизитами справочника, а в связанном регистре сведений — сверяйте в конфигураторе. Учётной, ценовой или налоговой информации реквизиты справочника не содержат.
3. Формы
Как у типового служебного объекта, собственные (переопределённые) формы обычно не создаются — используются автогенерируемые:
| Форма | Назначение |
|---|---|
| Форма списка (авто) | Просмотр реестра расширений и их зафиксированных версий администратором. |
| Форма элемента (авто) | Просмотр реквизитов конкретной записи. Редактирование вручную не предполагается. |
| Форма выбора (авто) | Программный выбор элемента из служебного кода (в интерактивных сценариях практически не используется). |
4. Ключевые процедуры модулей
BSL-evidence для объекта не приложено (в исходных данных только фасет «назначение»), поэтому ниже — типовые обработчики для данного вида объекта и механизма БСП, в котором он участвует. Конкретные строки модулей уточняйте в конфигураторе.
- Модуль менеджера справочника — процедуры регистрации/актуализации записей о расширениях: поиск элемента по
ИдентификаторРасширения, создание при отсутствии, запись текущихВерсияРасширенияиХешСумма. - Механизм «Обновление версии ИБ» (БСП) — общие модули
ОбновлениеИнформационнойБазы,ОбновлениеИнформационнойБазыСлужебныйи связанный с расширениями обработчик обновления: при старте сеанса сравнивают текущую версию/хеш каждого подключённого расширения с сохранённой вВерсииРасширенийи при расхождении инициируют запуск обработчиков обновления данных расширения. - Работа в безопасном режиме — обращение к данным расширения выполняется через штатные механизмы БСП (
РаботаВБезопасномРежиме), без прямых интерактивных операций пользователя. - Стандартные обработчики формы/объекта (
ПередЗаписью,ОбработкаЗаполнения) — используются в минимальном, типовом объёме; прикладной логики проведения/расчётов не содержат.
5. Проведение и движения
Справочник не является документом: реквизита «Проведён» нет, движений по регистрам он не формирует и проводок по плану счетов не создаёт.
Как следствие, к этому объекту неприменимы учётные и налоговые параметры конфигурации (ставка НДС 16 %, МРП 4 325 ₸, МЗП 85 000 ₸, вычет по ИПН 30 МРП/мес, ставки ИПН 10 %/15 %, ОПВ, ОПВР, ВОСМС, ОСМС, СО, соцналог), а также счета типового плана РК (1210, 1030, 1330, 3310, 3130, 6010, 7010) и электронные документы ЭСФ/СНТ. Эти значения относятся к учётным документам и регистрам конфигурации, но не к служебному справочнику версий расширений.
«Движение» этого объекта в узком смысле — только служебная фиксация факта, что для расширения с данным идентификатором обработчики обновления отработали на указанной версии/хеше.
6. Связанные объекты и ввод на основании
- Подсистема БСП «Обновление версии ИБ» — основной потребитель данных справочника.
- Расширения конфигурации (платформенный механизм) — источник идентификаторов, версий и хешей, отражаемых в справочнике.
- Регистр сведений «ВерсииПодсистем» и обработчики обновления (
ОбновлениеИнформационнойБазы...) — работают в связке с этим справочником при обновлении данных.
Ввод на основании: не предусмотрен ни как основание, ни как результат. Интерактивное создание элементов пользователем в штатном сценарии не выполняется — записи ведёт механизм обновления.
7. Точки расширения
- Модификация служебного справочника собственными расширениями не рекомендуется: объект относится к инфраструктуре БСП, вмешательство может нарушить механизм обновления данных расширений.
- Допустимые (осторожные) варианты: подписки на события и обработчики модуля менеджера через собственное расширение — только для диагностики/логирования, без изменения логики фиксации версий.
- Прикладную бизнес-логику (учёт, налоги, ЭСФ/СНТ) следует размещать в соответствующих документах и регистрах конфигурации, а не в этом объекте.