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