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