1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | ВидыНоменклатурыПрисоединенныеФайлы |
| Полное имя | Справочник.ВидыНоменклатурыПрисоединенныеФайлы (Catalogs.ВидыНоменклатурыПрисоединенныеФайлы) |
| Синоним | «Присоединённые файлы (Виды номенклатуры)» |
| Владелец (Owner) | Справочник.ВидыНоменклатуры |
| Иерархия | Нет (плоский список) |
| Конфигурация | Управление торговлей для Казахстана, редакция 3.4.5.21 |
| Подсистема | «Работа с файлами» (БСП / Библиотека стандартных подсистем) |
| Где найти | e1cib/list/Справочник.ВидыНоменклатурыПрисоединенныеФайлы |
Назначение. Служебный справочник, автоматически формируемый механизмом «Работа с файлами» БСП для хранения метаданных файлов, присоединённых к элементам справочника ВидыНоменклатуры. Один такой справочник создаётся под каждый объект-владелец, поддерживающий присоединение файлов; имя строится по шаблону <ИмяВладельца>ПрисоединенныеФайлы. Пользователь работает не со справочником напрямую, а через команду «Присоединённые файлы» в карточке вида номенклатуры. Сам справочник — инфраструктурный: он не отражается в учёте, не участвует в документообороте и не влияет на суммы/налоги.
Это стандартный (типовой) объект БСП. Прикладные правила Казахстана (НДС 16 %, МРП 4 325 ₸, план счетов РК) к нему напрямую не применяются — он лишь хранит вложения к карточке вида номенклатуры (см. раздел 5).
2. Реквизиты и табличные части
Табличных частей справочник не содержит. Ниже — типовой состав реквизитов присоединённых файлов БСП (без выделенного хранения версий). В конфигурациях с версионированием часть реквизитов, отвечающих за бинарные данные, выносится в парный справочник ВидыНоменклатурыВерсииПрисоединенныхФайлов — это версионно-специфичная деталь, которую следует сверять с конкретной поставкой.
Стандартные реквизиты
| Реквизит | Тип | Назначение |
|---|---|---|
Код |
Строка/Число | Внутренний код элемента. Пользователю не показывается. |
Наименование (Description) |
Строка (150) | Имя файла без расширения. |
Владелец (Owner) |
СправочникСсылка.ВидыНоменклатуры |
Элемент вида номенклатуры, к которому присоединён файл. |
ПометкаУдаления |
Булево | Признак пометки на удаление. |
Предопределённый |
Булево | Всегда «Нет». |
Реквизиты шапки (прикладные)
| Реквизит | Тип | Назначение |
|---|---|---|
Расширение |
Строка | Расширение файла (pdf, xlsx, png, xml для ЭСФ/СНТ и т. п.). |
Размер |
Число | Размер файла в байтах. |
ДатаСоздания |
Дата | Дата создания исходного файла. |
ДатаМодификацииУниверсальная |
Дата | Дата последнего изменения (UTC), для синхронизации версий. |
Автор |
СправочникСсылка.Пользователи |
Пользователь, добавивший файл. |
Редактирует (Занят) |
СправочникСсылка.Пользователи |
Кто занял файл для редактирования; пусто — файл свободен. |
ПодписанЭП |
Булево | Файл подписан электронной подписью. |
Зашифрован |
Булево | Файл зашифрован. |
ТекстХранилище |
ХранилищеЗначения | Извлечённый текст для полнотекстового поиска. |
СтатусИзвлеченияТекста |
Перечисление | Состояние извлечения текста (не извлекался / извлечён / ошибка). |
ТомХранилища |
СправочникСсылка.ТомаХранилищаФайлов |
Том, если файл хранится в томах на диске, а не в ИБ. |
ПутьКФайлу |
Строка | Относительный путь в томе (при томном хранении). |
Само бинарное содержимое файла в этом справочнике не хранится. При хранении в информационной базе тело файла лежит в регистре сведений
ДвоичныеДанныеФайлов, при томном хранении — в файловой системе тома (ТомаХранилищаФайлов). Справочник хранит только метаданные и ссылку на местоположение.
3. Формы
Выделенных прикладных форм у этого справочника, как правило, нет — вся работа с файлами идёт через общие формы подсистемы «Работа с файлами». Типовой набор:
| Форма | Назначение |
|---|---|
Общая форма ПрисоединенныеФайлы |
Список вложений владельца: добавить, открыть, сохранить, пометить, подписать ЭП. Вызывается командой «Присоединённые файлы» из карточки вида номенклатуры. |
Общая форма ПрисоединенныйФайл |
Карточка отдельного файла: имя, описание, автор, размер, даты, статусы подписи/шифрования, кнопки редактирования и просмотра версий. |
Форма выбора / список справочника (e1cib/list/...) |
Технический доступ администратора ко всему списку метаданных файлов данного владельца. |
Если в конкретной поставке у справочника заведены собственные ФормаЭлемента/ФормаСписка — они переопределяют общие; это следует проверять в конфигураторе (версионно-специфично).
4. Ключевые процедуры модулей
В приложенном evidence BSL-код и пути (путь:строка) отсутствуют — указан только фасет «назначение». Поэтому ниже приведены типовые обработчики для присоединённых файлов БСП. Прикладная логика сосредоточена не в модулях самого справочника (они обычно пустые или минимальны), а в общих модулях подсистемы:
РаботаСФайлами— клиентский API:ДобавитьФайл,ОткрытьФайл,РедактироватьФайл,ЗакончитьРедактирование,ОсвободитьФайл.РаботаСФайламиСлужебный/РаботаСФайламиСлужебныйСервер— серверная логика: создание элемента справочника, запись бинарных данных вДвоичныеДанныеФайловили в том, извлечение текста, работа с ЭП и шифрованием.РаботаСФайламиВызовСервера— прокси для клиент-серверных вызовов.
Типовые обработчики модуля объекта справочника:
| Обработчик | Что делает |
|---|---|
ПередЗаписью |
Проверяет корректность имени/расширения, актуализирует ДатаМодификацииУниверсальная, контролирует занятость (Редактирует). |
ПриКопировании |
Сбрасывает признаки блокировки, подписи и шифрования у копии. |
ПередУдалением |
Инициирует удаление связанных бинарных данных (регистр ДвоичныеДанныеФайлов или файл в томе), очистку версий. |
Обработчик заполнения (ОбработкаЗаполнения) |
Заполняет Владелец, Автор, ДатаСоздания при программном создании через API. |
Обращаться к справочнику напрямую из прикладного кода не рекомендуется — используйте API
РаботаСФайлами/РаботаСФайламиВызовСервера.
5. Проведение и движения
Справочник не является документом и не проводится: у объектов типа «Справочник» нет механизма проведения, регистраторов и бухгалтерских проводок. Присоединение файла к виду номенклатуры не формирует движений по регистрам накопления/сведений (кроме служебной записи бинарных данных в ДвоичныеДанныеФайлов) и не создаёт проводок по плану счетов РК.
Для ориентира — учётные движения и налоги возникают у прикладных объектов (документы реализации, поступления, ЭСФ/СНТ), а не у вложений. Справочник присоединённых файлов лишь хранит, например, скан-копию или XML электронного документа рядом с карточкой вида номенклатуры. Контекст плана счетов и норм РК 2026, к которому эти прикладные объекты относятся:
- НДС 16 % — учитывается на счёте
3130(НДС к уплате); входной/исходящий НДС отражается в ЭСФ (ИС ЭСФ) и СНТ, а не во вложениях. - Реализация:
Дт 1210(краткосрочная ДЗ покупателей) —Кт 6010(доход от реализации) иКт 3130(НДС 16 %); списание себестоимостиДт 7010—Кт 1330(товары). - Оплата:
Дт 1030(деньги на текущих счетах) —Кт 1210. - Поступление товара:
Дт 1330—Кт 3310(КЗ поставщикам), НДСДт 1420/3130в зависимости от учётной политики. - Расчёт зарплаты/налогов (справочно, РК 2026): МРП = 4 325 ₸, МЗП = 85 000 ₸; вычет по ИПН — 30 МРП в месяц (не более 360 МРП за год); ИПН 10 % до 8 500 МРП годового дохода и 15 % сверх; ОПВ 10 % (потолок базы 50 МЗП), ОПВР 3,5 %, ВОСМС 2 %, ОСМС 3 %, СО 5 %, соцналог 6 %.
Эти суммы и счета относятся к прикладным документам конфигурации, а не к самому справочнику вложений — здесь они приведены для понимания места объекта в общей архитектуре.
6. Связанные объекты и ввод на основании
| Связь | Объект | Роль |
|---|---|---|
| Владелец | Справочник.ВидыНоменклатуры |
Объект, к которому присоединяются файлы. |
| Хранение бинарных данных | РегистрСведений.ДвоичныеДанныеФайлов |
Тело файла при хранении в ИБ. |
| Томное хранение | Справочник.ТомаХранилищаФайлов |
Каталоги на диске для тела файла. |
| Версии (опционально) | Справочник.ВидыНоменклатурыВерсииПрисоединенныхФайлов |
Хранение версий файла (если версионирование включено — версионно-специфично). |
| ЭП / шифрование | РегистрСведений.ЭлектронныеПодписиФайлов, хранилища сертификатов |
Подписи и признаки шифрования. |
| Автор/редактор | Справочник.Пользователи |
Реквизиты Автор, Редактирует. |
Ввод на основании: не предусмотрен и не применим — служебный справочник не участвует в механизме «Ввести на основании». Элементы создаются только через команду «Присоединённые файлы» карточки вида номенклатуры или через API РаботаСФайлами.
7. Точки расширения
- Расширения конфигурации (adopt/annotate): можно подписаться на события
ПередЗаписью/ПередУдалениеммодуля объекта, но менять состав стандартных реквизитов присоединённых файлов не рекомендуется — механизм генерирует их по шаблону. - Дополнительные реквизиты/сведения: обычно не подключаются к служебным справочникам файлов; произвольные атрибуты храните на владельце —
ВидыНоменклатуры. - API вместо прямого доступа: для добавления/чтения используйте
РаботаСФайлами.ДобавитьФайл,РаботаСФайламиВызовСервера, а не прямую запись объекта — это гарантирует корректную запись бинарных данных, извлечение текста и обработку ЭП. - Хранение файлов: политика (в ИБ либо в томах) настраивается в подсистеме «Работа с файлами» и влияет на заполнение
ТомХранилища/ПутьКФайлу— общая настройка, не требует правки объекта. - Полнотекстовый поиск: извлечение текста (
ТекстХранилище,СтатусИзвлеченияТекста) — штатная точка кастомизации через регламентные задания подсистемы.
Версионно-специфично (проверять в конфигураторе поставки 3.4.5.21): наличие парного справочника версий, набор собственных форм справочника и точный список реквизитов хранения (том/путь/версия).