1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | ВыкупВозвратнойТарыУПоставщикаПрисоединенныеФайлы |
| Полное имя | Справочник.ВыкупВозвратнойТарыУПоставщикаПрисоединенныеФайлы |
| Синоним | «Присоединённые файлы (Выкуп возвратной тары у поставщика)» |
| Конфигурация | Управление торговлей для Казахстана, ред. 3.4 (3.4.5.21) |
| Подсистема-владелец | «Работа с файлами» (БСП) |
| Назначение | Хранение файлов (сканы, вложения, ЭП), присоединённых к конкретному документу «Выкуп возвратной тары у поставщика» |
Назначение по evidence: «Присоединённые файлы (Выкуп возвратной тары у поставщика)» — служебный справочник конфигурации «Управление торговлей для Казахстана 3.4», реализующий механизм присоединённых файлов Библиотеки стандартных подсистем (БСП).
Это типовой подчинённый справочник вида <Объект>ПрисоединенныеФайлы. Каждый его элемент — это один файл (документ Word/PDF/скан-образ, изображение, xml ЭСФ/СНТ и т. п.), логически привязанный к конкретному документу-владельцу. Пользователь работает с ним не напрямую, а через панель «Присоединённые файлы» в форме документа-владельца.
Где найти
- Программно/для отладки — навигационная ссылка списка:
e1cib/list/Справочник.ВыкупВозвратнойТарыУПоставщикаПрисоединенныеФайлы - В интерфейсе — из формы документа «Выкуп возвратной тары у поставщика» → команда/панель «Присоединённые файлы» (общая форма БСП
ПрисоединенныеФайлы).
2. Реквизиты шапки и табличные части
2.1. Стандартные реквизиты справочника
| Реквизит | Тип | Назначение |
|---|---|---|
Владелец |
ДокументСсылка.ВыкупВозвратнойТарыУПоставщика |
Документ, к которому присоединён файл. Ключевая связь «файл → документ» |
Наименование |
Строка | Имя файла без расширения (отображаемое) |
Код |
Строка/Число | Внутренний код элемента |
ПометкаУдаления |
Булево | Стандартная пометка на удаление |
Предопределённый |
— | Не используется (файлы создаются пользователями) |
2.2. Реквизиты подсистемы «Работа с файлами»
| Реквизит | Тип | Назначение |
|---|---|---|
Расширение |
Строка | Расширение файла (pdf, xlsx, xml, png…) |
Автор |
СправочникСсылка.Пользователи / ВнешниеПользователи |
Кто загрузил файл |
ДатаСоздания |
Дата | Момент присоединения файла |
ДатаМодификацииУниверсальная |
Дата | Дата последнего изменения (UTC) |
РазмерФайла (ОбъемФайла) |
Число | Размер в байтах |
Редактирует |
СправочникСсылка.Пользователи |
Кто занял файл для редактирования (блокировка) |
ТекстХранилище |
ХранилищеЗначения | Извлечённый текст для полнотекстового поиска |
ФайлХранилище |
ХранилищеЗначения | Двоичные данные файла при хранении в информационной базе |
ТомХранениеФайлов |
СправочникСсылка.ТомаХраненияФайлов |
Том при хранении файлов в томах на диске |
ПутьКФайлуВТомах |
Строка | Относительный путь к файлу внутри тома |
ПодписанЭП (ПодписанЭЦП) |
Булево | Признак наличия электронной подписи |
Зашифрован |
Булево | Признак шифрования содержимого |
ИндексКартинки |
Число | Индекс пиктограммы по типу файла в интерфейсе |
Двоичные данные хранятся либо в
ФайлХранилище(в ИБ), либо в томах (ТомХранениеФайлов+ПутьКФайлуВТомах) — в зависимости от настройки «Хранить файлы в томах на диске».
2.3. Табличные части
| Табличная часть | Ключевые реквизиты | Назначение |
|---|---|---|
ЭлектронныеПодписи |
Подпись (ХранилищеЗначения), КомуВыдан, КемВыдан, Отпечаток, ДатаПодписания, ДатаДействияС, ДатаДействияПо, Комментарий |
Электронные подписи, наложенные на файл (для сканов договоров, актов и т. п.) |
СертификатыШифрования |
Сертификат (ХранилищеЗначения), КомуВыдан, Отпечаток |
Сертификаты, которыми зашифрован файл |
3. Формы
Собственные формы у справочников присоединённых файлов, как правило, не задаются — работа идёт через общие формы БСП. Стандартный набор:
| Форма | Роль |
|---|---|
Общая форма ПрисоединенныеФайлы (БСП) |
Основная панель работы: список файлов документа-владельца, добавление, просмотр, редактирование, ЭП |
ФормаЭлемента (при наличии) |
Карточка отдельного файла: имя, автор, даты, размер, подписи |
ФормаСписка (при наличии) |
Служебный список всех файлов справочника (администрирование/отладка) |
| Общая форма выбора / просмотра ЭП | Просмотр реквизитов и проверки электронных подписей |
Если в конкретной сборке 3.4.5.21 собственные формы отсутствуют, платформа генерирует их автоматически, а пользовательская работа полностью закрывается общими формами подсистемы «Работа с файлами». (Наличие собственной ФормаЭлемента — версионно-специфично, проверяется в конфигураторе конкретной сборки.)
4. Ключевые процедуры модулей
Исходный BSL к данному объекту в evidence не приложен, поэтому ниже — типовые обработчики для справочника присоединённых файлов БСП.
Модуль менеджера / модуль объекта:
ОбработкаЗаполнения— заполнение служебных реквизитов при создании (автор, дата создания, расширение).ПередЗаписью— фиксацияДатаМодификацииУниверсальная, контроль признаковПодписанЭП/Зашифрован, снятие/установка блокировки редактирования (Редактирует).ПередУдалением— удаление двоичных данных из тома (ПутьКФайлуВТомах), если файл хранился в томах, чтобы не оставлять «сирот» на диске.ПриКопировании— очистка ссылок на подписи/двоичные данные, чтобы копия не наследовала ЭП оригинала.
Вызовы через общий модуль БСП (не в модуле объекта):
РаботаСФайлами/РаботаСФайламиСлужебный— добавление файла, получение двоичных данных, помещение в том или ИБ, извлечение текста для поиска.ЭлектронныеПодписиИШифрование— наложение и проверка ЭП, работа с ТЧЭлектронныеПодписииСертификатыШифрования.
Логика присоединения инициируется из формы документа-владельца командой панели файлов; сам справочник является пассивным хранилищем.
5. Проведение и движения
Справочник не является документом и не проводится — записей в регистрах он не формирует, проводок по плану счетов не делает. Его роль ограничена хранением файлов.
Бухгалтерские и товарные движения формирует документ-владелец — «Выкуп возвратной тары у поставщика». Для контекста, по типовому плану счетов РК он затрагивает:
| Операция | Дебет | Кредит |
|---|---|---|
| Оприходование выкупленной возвратной тары | 1330 (товары/тара) | 3310 (КЗ поставщикам) |
| Выделение НДС по ставке 16 % (Казахстан, 2026) | 1420 (НДС к возмещению) | 3310 |
| Начисление НДС к уплате (при соответствующей операции) | — | 3130 (НДС к уплате) |
| Оплата поставщику с текущего счёта | 3310 | 1030 (деньги на текущих счетах) |
Электронный документооборот по операции ведётся через ИС ЭСФ (ЭСФ) и СНТ; XML этих документов также может присоединяться как файл в рассматриваемый справочник. Все суммовые расчёты — в тенге (₸).
Ставка НДС 16 % и план счетов приведены как контекст владельца; сам справочник присоединённых файлов в этих расчётах не участвует.
6. Связанные объекты и ввод на основании
| Объект | Тип связи |
|---|---|
Документ.ВыкупВозвратнойТарыУПоставщика |
Владелец (родительский документ) |
Справочник.ТомаХраненияФайлов |
Место физического хранения при хранении в томах |
Справочник.Пользователи / ВнешниеПользователи |
Автор файла, пользователь-редактор |
| Подсистема «Работа с файлами» (БСП) | Механизм добавления/просмотра/подписания |
| ИС ЭСФ, СНТ | Источник XML-файлов, присоединяемых к документу |
Ввод на основании: для служебного справочника присоединённых файлов не предусмотрен. Элементы создаются только через механизм присоединения файлов из формы документа-владельца (загрузка с диска, сканирование, drag-and-drop, помещение из буфера).
7. Точки расширения
- Расширение конфигурации: добавление собственных реквизитов файла (например, «Тип документа: договор/акт/ЭСФ»), доработка формы элемента, добавление проверок при
ПередЗаписью. - Тома хранения: вынос файлов из ИБ в тома на диске (настройка «Хранить файлы в томах») — влияет на
ТомХранениеФайлов/ПутьКФайлуВТомах. - Права доступа (RLS): ограничение видимости файлов через права на документ-владелец.
- ЭП/шифрование: подключение сертификатов и регламентов подписания через подсистему «Электронные подписи и шифрование».
- Подписки на события / обработчики БСП: перехват добавления файла для автоматической классификации, антивирусной проверки или синхронизации с внешним хранилищем.
При доработках не изменяйте состав стандартных реквизитов БСП (
ФайлХранилище,ТомХранениеФайлов,ЭлектронныеПодписии др.) — это нарушит совместимость с общими формами и обновляемость подсистемы «Работа с файлами».
