1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | ВерсииФайлов |
| Полное имя | Catalogs.ВерсииФайлов / Справочник.ВерсииФайлов |
| Синоним | Версии файлов (в интерфейсе отдельно почти не выводится) |
| Конфигурация | Бухгалтерия для Казахстана, редакция 3.0.74.2 |
| Подсистема-владелец | Библиотека стандартных подсистем (БСП), подсистема «Работа с файлами» |
| Назначение | Хранение истории изменений присоединённых файлов: каждая правка файла порождает новую версию, что обеспечивает откат к предыдущим вариантам, сравнение и контроль авторства |
Характер объекта. Это служебный (технический) справочник инфраструктуры хранения файлов. Он не является учётным объектом: не содержит хозяйственных данных, не участвует в бухгалтерских проводках, не привязан к плану счетов, НДС, ИПН и прочим налоговым механизмам РК. Справочник ведётся автоматически подсистемой работы с файлами и, как правило, не требует прямого вмешательства пользователя.
Где найти: навигационная ссылка e1cib/list/Справочник.ВерсииФайлов. В штатном интерфейсе доступ к версиям осуществляется из карточки присоединённого файла (кнопка/команда «Версии»), а не через отдельный пункт меню. Контроль доступа наследуется от прав на объект-владелец файла (документ или справочник, к которому прикреплён файл).
2. Реквизиты и табличные части
2.1 Реквизиты шапки
| Имя | Тип | Обязательность | Назначение |
|---|---|---|---|
| Автор | Справочник.ВнешниеПользователи, Справочник.УчетныеЗаписиСинхронизацииФайлов, Справочник.Пользователи (составной) | Не обязательно | Пользователь или учётная запись синхронизации, создавшая данную версию файла |
| ДатаМодификацииУниверсальная | ДатаВремя | Не обязательно | Дата и время последнего изменения файла в универсальном времени (UTC); используется для синхронизации и сравнения версий |
| ДатаМодификацииФайла | ДатаВремя | Не обязательно | Дата и время последнего изменения файла в местном времени; отображается пользователю |
| ДатаСоздания | ДатаВремя | Не обязательно | Дата и время создания данной версии |
| ИндексКартинки | Число | Не обязательно | Индекс иконки для визуального отображения типа файла в интерфейсе |
| Комментарий | Строка | Не обязательно | Текстовое описание изменений в версии; единственное поле, доступное для массового редактирования |
| НомерВерсии | Число | Не обязательно | Порядковый номер версии (1, 2, 3…), автоматически увеличивается при создании новой версии |
| УдалитьПолноеНаименование | Строка | Не обязательно | Устаревшее поле (префикс «Удалить…»), в текущей версии не используется |
| ПутьКФайлу | Строка | Не обязательно | Путь к файлу на томе хранения либо идентификатор в хранилище |
| Размер | Число | Не обязательно | Размер файла версии в байтах |
| Расширение | Строка | Не обязательно | Расширение файла (например, «docx», «pdf»); определяет тип и иконку |
| РодительскаяВерсия | Справочник.ВерсииФайлов | Не обязательно | Ссылка на предыдущую версию; образует цепочку версий |
| СтатусИзвлеченияТекста | Перечисление.СтатусыИзвлеченияТекстаФайлов | Не обязательно | Состояние извлечения текста для полнотекстового поиска (не извлечён / извлекается / извлечён / ошибка) |
| ТекстХранилище | Хранилище значений | Не обязательно | Извлечённый текст файла для полнотекстового поиска |
| ТипХраненияФайла | Перечисление.ТипыХраненияФайлов | Не обязательно | Способ хранения (в базе данных или на томе) |
| Том | Справочник.ТомаХраненияФайлов | Не обязательно | Том хранения файлов (при хранении на диске) |
| ФайлХранилище | Хранилище значений | Не обязательно | Временное хранилище двоичных данных файла (при хранении в базе) |
Стандартные реквизиты. Помимо перечисленных, объект имеет типовые для справочника поля: Код, Наименование (обычно формируется из имени файла и номера версии), Владелец (владельцем версии выступает элемент справочника присоединённых файлов, например Справочник.<Объект>ПрисоединённыеФайлы), ПометкаУдаления, Предопределённый, Ссылка.
2.2 Табличные части
Табличные части у справочника отсутствуют. Вся информация о версии хранится в реквизитах шапки; последовательность версий выстраивается через реквизит РодительскаяВерсия и НомерВерсии, а не через ТЧ.
3. Формы
Справочник использует набор форм БСП. Как правило присутствуют:
| Форма | Назначение |
|---|---|
| ФормаЭлемента | Карточка версии: просмотр атрибутов (автор, даты, размер, расширение, номер версии, комментарий). Служебная, редактирование ограничено полем «Комментарий» |
| ФормаСписка | Список версий, обычно вызывается в контексте конкретного файла (e1cib/list/Справочник.ВерсииФайлов); показывает цепочку версий с автором и датами |
| ФормаВыбора | Выбор конкретной версии (например, при откате или сравнении) |
Основное взаимодействие пользователя с версиями происходит не через собственные формы справочника, а через управляемые формы подсистемы «Работа с файлами»: карточку присоединённого файла и форму «Версии файла», которые обращаются к данному справочнику программно.
4. Ключевые процедуры модулей
Собственный код в evidence для данного объекта не приложен, поэтому ниже — типовые обработчики и обслуживающие процедуры, характерные для этого служебного справочника БСП. Конкретные имена процедур и модулей уточняются по версии БСП, поставляемой с 3.0.74.2 (версионно-специфично).
- ОбработкаЗаполнения / ПередЗаписью (модуль объекта) — заполнение служебных полей:
НомерВерсии,ДатаСоздания,Автор, привязкаРодительскаяВерсия. - Модуль менеджера / общий модуль
РаботаСФайлами,РаботаСФайламиСлужебный— создание новой версии (СоздатьВерсию/ДобавитьВерсиюФайла), получение актуальной и произвольной версии, откат к версии, удаление устаревших версий. - Извлечение текста — процедуры, заполняющие
ТекстХранилищеиСтатусИзвлеченияТекстадля полнотекстового поиска (фоновое задание извлечения текста). - Работа с хранением — размещение двоичных данных в
ФайлХранилище(в базе) либо наТомс записьюПутьКФайлуиТипХраненияФайла; используется при переносе файлов между томами и базой. - Синхронизация файлов — сравнение по
ДатаМодификацииУниверсальная, привязкаАвторкСправочник.УчетныеЗаписиСинхронизацииФайлов.
5. Проведение и движения
Справочник не проводится и не формирует движений. Это документо-независимый служебный справочник:
- нет режима проведения, нет обработчика
ОбработкаПроведения; - не формирует бухгалтерских проводок и не затрагивает план счетов РК (счета 1210, 1030, 1330, 3310, 3130, 6010, 7010 и т. п. к нему отношения не имеют);
- не влияет на регистры накопления/сведений учётного контура;
- не участвует в расчёте НДС (ставка РК 2026 — 16 %), ИПН, ОПВ, ОПВР, ВОСМС, ОСМС, СО и соцналога.
Единственные «движения» в широком смысле — это изменение самих данных хранения файлов: запись двоичных данных в ФайлХранилище/на Том и заполнение регистров подсистемы полнотекстового поиска при извлечении текста. Учётного смысла они не несут.
Примечание. Присоединённые файлы (включая версии) часто прикрепляют к учётным документам — например, к счёту-фактуре с НДС 16 %, к ЭСФ (ИС ЭСФ) или СНТ. Однако сам справочник «ВерсииФайлов» хранит лишь содержимое и историю файла, а не налоговые/суммовые данные документа-владельца.
6. Связанные объекты и ввод на основании
- Владелец файла — элемент справочника присоединённых файлов конкретного объекта (
Справочник.<Объект>ПрисоединённыеФайлы); через него версия связана с документом или элементом справочника. - Справочник.ТомаХраненияФайлов — реквизит
Том(место физического хранения на диске). - Справочник.Пользователи / ВнешниеПользователи / УчетныеЗаписиСинхронизацииФайлов — реквизит
Автор. - Справочник.ВерсииФайлов (сам на себя) —
РодительскаяВерсия, цепочка версий. - Перечисление.ТипыХраненияФайлов, Перечисление.СтатусыИзвлеченияТекстаФайлов — служебные перечисления.
Ввод на основании. Механизм «Ввод на основании» для данного справочника не применяется. Новые версии создаются автоматически при изменении файла (загрузка новой редакции, редактирование через занятие/освобождение файла), а не командой «Создать на основании».
7. Точки расширения
- Расширение конфигурации — добавление реквизитов (например, метки классификации документа) и обработчиков форм без снятия с поддержки; допустимо для служебного справочника, но требует осторожности при обновлениях БСП.
- Программные интерфейсы БСП — работа с версиями через общие модули подсистемы «Работа с файлами» (создание, получение, откат версий) вместо прямой записи объекта; предпочтительный способ интеграции.
- Тома и правила хранения — настройка
ТомаХраненияФайлови политики хранения версий (ограничение количества/срока хранения) — штатный способ управления объёмом без изменения структуры. - Полнотекстовый поиск — влияние на состав индексируемого содержимого через
ТекстХранилище/СтатусИзвлеченияТекста.
Требует проверки (версионно-специфично): точные имена процедур модулей и состав служебных перечислений могут отличаться в зависимости от версии БСП внутри релиза 3.0.74.2.