1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | РеализацияТоваровУслугПрисоединенныеФайлы |
| Полное имя | Справочник.РеализацияТоваровУслугПрисоединенныеФайлы |
| Синоним | Присоединённые файлы (Реализация товаров услуг) |
| Владелец (подчинение) | Документ.РеализацияТоваровУслуг |
| Конфигурация | Управление торговлей для Казахстана 3.4.5.21 |
| Подсистема | Работа с файлами / Присоединённые файлы (БСП) |
| Навигация «Где найти» | e1cib/list/Справочник.РеализацияТоваровУслугПрисоединенныеФайлы |
Назначение. Служебный подчинённый справочник, реализующий механизм присоединённых файлов Библиотеки стандартных подсистем (БСП) для документа «Реализация товаров и услуг». Каждый элемент справочника — это карточка одного файла (скан договора, доверенности, изображение печати, PDF-копия ЭСФ/СНТ, скан-подтверждение отгрузки и т. п.), присоединённого к конкретному документу реализации. Справочник хранит метаданные файла (имя, расширение, размер, автор, даты, признаки подписи/шифрования), а само двоичное содержимое хранится отдельно — в регистре сведений хранилища либо в томах на диске. Справочник не участвует в учёте, не проводится и движений не формирует.
Пользователь работает с этим справочником не напрямую, а через команду «Присоединённые файлы» в форме документа реализации. Прямой список (навигационная ссылка выше) используется администратором/разработчиком для диагностики.
2. Реквизиты шапки и табличные части
Табличных частей объект не содержит (типовой признак справочника присоединённых файлов). Данные версий файла и его двоичное содержимое вынесены во внешние объекты (см. раздел 5).
Реквизиты шапки (метаданные файла):
| Реквизит | Тип | Назначение |
|---|---|---|
Владелец |
ДокументСсылка.РеализацияТоваровУслуг |
Документ-владелец, к которому присоединён файл |
Наименование |
Строка | Имя файла без расширения (отображается пользователю) |
Расширение |
Строка | Расширение файла (pdf, xml, jpg, docx …) без точки |
Размер |
Число | Размер файла в байтах |
Автор |
СправочникСсылка.Пользователи |
Пользователь, добавивший файл |
ДатаСоздания |
Дата | Момент создания карточки файла в базе |
ДатаМодификацииУниверсальная |
Дата | Дата последнего изменения содержимого (UTC) |
ИзменившийПользователь |
СправочникСсылка.Пользователи |
Кто последним изменил файл/версию |
ПодписанЭП |
Булево | Файл подписан электронной подписью |
Зашифрован |
Булево | Содержимое файла зашифровано |
Редактирует |
СправочникСсылка.Пользователи |
Пользователь, занявший файл для редактирования (блокировка) |
Том |
СправочникСсылка.ТомаХраненияФайлов |
Том хранения (если файлы хранятся на диске, а не в ИБ) |
ПутьКФайлуТома |
Строка | Относительный путь к файлу внутри тома |
ВерсияВладельца / ТекущаяВерсия |
СправочникСсылка.*ВерсииФайлов |
Ссылка на активную версию (при включённом версионировании) |
ТекстХранилище |
ХранилищеЗначения | Извлечённый текст файла для полнотекстового поиска |
ХранилищеФайла |
ХранилищеЗначения | Двоичные данные файла (в вариантах хранения «в информационной базе»; в актуальных релизах чаще пусто — данные в регистре сведений) |
ИндексКартинки / ИдентификаторПиктограммы |
Число/Строка | Пиктограмма по типу файла в интерфейсе |
Описание |
Строка | Произвольный комментарий к файлу |
Точный состав реквизитов версионно-зависим (зависит от версии БСП внутри 3.4.5.21) — набор атрибутов «Том/ПутьКФайлуТома/ХранилищеФайла» присутствует всегда, а признаки подписи/шифрования и ссылки на версии могут отличаться флагами. Требует проверки при разработке под конкретный релиз только этот нюанс.
3. Формы
| Форма | Назначение |
|---|---|
ФормаЭлемента |
Карточка файла: имя, расширение, размер, автор, даты, признаки ЭП/шифрования; команды «Открыть», «Сохранить как…», «Редактировать/Закончить редактирование», «Подписать ЭП», «Зашифровать» |
ФормаСписка |
Список всех файлов; используется в служебном/административном режиме и в подчинённых списках |
ФормаВыбора |
Выбор файла из списка присоединённых (в диалогах прикрепления/замены) |
На практике интерфейс присоединения реализуется общими формами подсистемы БСП (ОбщаяФорма.ПрисоединенныеФайлы, формы работы с версиями и подписями), которые вызываются из формы документа-владельца. Собственные формы справочника при этом могут не переопределяться.
4. Ключевые процедуры модулей
В приложенном evidence присутствует только фасет назначения (BSL-фрагменты не приложены), поэтому ниже — типовые обработчики и точки логики данного вида объекта в БСП. При наличии выгрузки модулей сверяйте по путь:строка.
Модуль объекта (ОбработкаЗаписи, ПередЗаписью, ПередУдалением):
- контроль заполнения
Владелец,Наименование,Расширение; - запрет изменения занятого на редактирование файла сторонним пользователем;
- каскадное удаление версий и записей хранилища при удалении карточки файла.
Модуль менеджера:
- переопределяемые процедуры получения представления и формы по умолчанию;
- обработчики программного добавления файла (
ДобавитьФайл), используемые серверными вызовами подсистемы.
Основная логика вынесена в общие модули БСП (вызываются извне, а не из модуля справочника):
РаботаСФайлами/РаботаСФайламиКлиент— открытие, сохранение, редактирование, помещение и получение данных файла;ПрисоединенныеФайлы/ПрисоединенныеФайлыСервер/ПрисоединенныеФайлыСлужебный— CRUD карточек, подсчёт количества присоединённых файлов у объекта, работа с блокировкой;- работа с версиями, электронной подписью (
ЭлектроннаяПодпись…) и шифрованием.
5. Проведение и движения
Справочник не проводится и движений по регистрам не формирует — это подчинённый справочник, а не документ. Учёт выполняет документ-владелец, а присоединённые файлы лишь хранят прикреплённые к нему данные.
Как хранится содержимое файла:
- при хранении «в информационной базе» — в регистре сведений хранилища присоединённых файлов (
РегистрСведений.ХранилищеПрисоединенныхФайлов/ двоичные данные версий), реквизит-«ключ» — ссылка на элемент этого справочника; - при хранении «в томах на диске» — файл лежит в каталоге тома (
Справочник.ТомаХраненияФайлов), а в карточке заполняютсяТомиПутьКФайлуТома; - версии файла (при включённом версионировании) хранятся в отдельном справочнике версий, подчинённом карточке файла.
Контекст учёта у документа-владельца (для справки, числа по РК на 2026 г.). Сама реализация формирует движения по регистрам продаж, взаиморасчётов, себестоимости, НДС и, при отражении в регламентированном учёте, проводки по типовому плану счетов РК со ставкой НДС 16 %:
| Проводка | Дт | Кт | Комментарий |
|---|---|---|---|
| Выручка от реализации | 1210 (ДЗ покупателей) | 6010 (доход от реализации) | сумма без НДС |
| НДС с реализации | 1210 | 3130 (НДС к уплате) | 16 % от базы |
| Списание себестоимости | 7010 (себестоимость) | 1330 (товары) | по методу оценки |
| Поступление оплаты | 1030 (текущие счета) | 1210 | закрытие ДЗ |
Пример: продажа на 1 000 000 ₸ без НДС → НДС 160 000 ₸ (16 %), к получению 1 160 000 ₸. Присоединённый скан ЭСФ/СНТ к этому документу на суммы и проводки не влияет — он информационный.
6. Связанные объекты и ввод на основании
- Владелец:
Документ.РеализацияТоваровУслуг— единственный владелец элементов справочника. - Хранилище данных: регистр сведений хранилища присоединённых файлов;
Справочник.ТомаХраненияФайлов. - Версии: подчинённый справочник версий файлов (при версионировании).
- Пользователи:
Справочник.Пользователи— автор, изменивший, редактирующий. - Электронные документы: к документу реализации в РК привязаны ЭСФ (ИС ЭСФ) и СНТ; их печатные/xml-копии могут храниться как присоединённые файлы данного справочника.
Ввод на основании. Не применяется: элементы справочника создаются исключительно через механизм присоединения файлов (команда «Присоединённые файлы» формы документа, drag-and-drop, сканирование, помещение из хранилища) и не являются самостоятельной точкой ввода на основании.
7. Точки расширения
- Переопределяемые модули БСП:
ПрисоединенныеФайлыПереопределяемый,РаботаСФайламиПереопределяемый— настройка сценариев работы с файлами, разрешённых расширений, максимального размера. - Расширение конфигурации: добавление реквизитов в справочник (например, «Тип документа-скана», «Категория»), доработка
ФормаЭлемента/ФормаСпискачерез расширение без снятия с поддержки. - Подписки на события:
ПередЗаписью/ПриЗаписиобъекта для аудита прикрепления/удаления файлов, авто-присвоения категорий, интеграции с внешним архивом. - Ограничения доступа (RLS): права на файлы наследуются от прав на документ-владельца; при необходимости профили доступа настраиваются через подсистему прав.
- Хранение: переключение «в ИБ ↔ в томах» и настройка версионирования — штатные параметры подсистемы, влияющие на заполнение реквизитов
Том/ПутьКФайлуТома/ХранилищеФайла.