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