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