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