1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | ПоступлениеДопРасходовПрисоединенныеФайлы |
| Полное имя | Справочник.ПоступлениеДопРасходовПрисоединенныеФайлы |
| Синоним | Присоединённые файлы (специфического синонима не задано) |
| Конфигурация | Бухгалтерия для Казахстана, редакция 3.0, версия 3.0.74.2 |
| Владелец файлов | Документ ПоступлениеДопРасходов |
| Подсистема | «РаботаСФайлами» (Библиотека стандартных подсистем, БСП) |
| Где найти | Навигационная ссылка: e1cib/list/Справочник.ПоступлениеДопРасходовПрисоединенныеФайлы |
Назначение. Справочник хранит файлы, прикрепляемые к документам «Поступление доп. расходов»: скан-копии первичных документов, договоров, спецификаций, актов на дополнительные расходы (транспорт, ТЗР, услуги посредников и т. п.), включаемые в стоимость приобретаемых ТМЗ (счёт 1330 «Товары»). Это служебный (подчинённый по смыслу) объект: конечный пользователь работает с ним косвенно — через команду «Присоединённые файлы» в форме документа-владельца. Прямое открытие списка справочника нужно администратору при групповом обслуживании метаданных, разборе томов хранения или диагностике.
2. Реквизиты и табличные части
2.1 Реквизиты шапки
| Имя | Тип | Обязательность | Назначение |
|---|---|---|---|
| Автор | СправочникСсылка.Пользователи | ShowError | Пользователь, добавивший файл. Обязателен для аудита и разграничения прав. |
| ВладелецФайла | ДокументСсылка.ПоступлениеДопРасходов | DontCheck | Документ-владелец, к которому прикреплён файл. Основное связующее поле. |
| ДатаМодификацииУниверсальная | ДатаВремя | DontCheck | Момент последнего изменения файла в UTC. Для синхронизации и версионирования. |
| ДатаСоздания | ДатаВремя | ShowError | Дата-время добавления файла в систему. Для хронологии и поиска. |
| Зашифрован | Булево | DontCheck | Флаг шифрования. При Истина файл защищён криптографией и требует сертификат для расшифровки. |
| Изменил | СправочникСсылка.Пользователи | DontCheck | Пользователь, последним изменивший файл или его метаданные. |
| ИндексКартинки | Число | DontCheck | Код иконки типа файла для отображения в списках и формах. |
| Описание | Строка | DontCheck | Произвольное текстовое описание содержимого файла (наименование элемента справочника). |
| ПодписанЭП | Булево | DontCheck | Признак наличия электронной подписи. Истина — файл заверен ЭП. |
| ПутьКФайлу | Строка | DontCheck | Путь к физическому файлу на томе (при хранении на диске). |
| Размер | Число | DontCheck | Размер файла в байтах. Для контроля квот и информации пользователю. |
| Расширение | Строка | DontCheck | Расширение файла (pdf, xlsx и т. п.); определяет приложение для открытия. |
| Редактирует | СправочникСсылка.Пользователи | DontCheck | Пользователь, заблокировавший файл для правки (check-out). Пусто — файл свободен. |
| СтатусИзвлеченияТекста | ПеречислениеСсылка.СтатусыИзвлеченияТекстаФайлов | DontCheck | Состояние извлечения текста для полнотекстового поиска (не извлечён / извлечён / ошибка). |
| ТекстХранилище | ХранилищеЗначения | DontCheck | Извлечённое текстовое содержимое файла для индексации и поиска. |
| ТипХраненияФайла | ПеречислениеСсылка.ТипыХраненияФайлов | ShowError | Способ хранения: в базе (ФайлХранилище) или на томе (ПутьКФайлу). |
Стандартные реквизиты: Код, Наименование (совпадает по смыслу с
Описание), ПометкаУдаления, Предопределённый (не используется), Ссылка. Двоичные данные файла при хранении в БД помещаются в реквизит-хранилище (ФайлХранилище/ хранятся через регистр — см. раздел 5).
2.2 Табличные части
Табличные части у справочников этого вида, как правило, отсутствуют: версии файла и его двоичное содержимое хранятся во внешних объектах подсистемы (регистры хранения и справочник версий), а не в табличной части владельца. Метаданные версий связываются с элементом справочника по ссылке.
3. Формы
| Форма | Назначение |
|---|---|
| ФормаЭлемента | Карточка присоединённого файла: просмотр/редактирование метаданных (описание, автор, даты, признаки ЭП и шифрования), команды открытия, сохранения, редактирования (check-out/check-in). |
| ФормаСписка | Список файлов, прикреплённых к документам поступления доп. расходов; используется администратором для массового обслуживания. |
| ФормаВыбора | Выбор файла в диалогах подсистемы (при необходимости). |
На практике пользователь работает не с этими формами напрямую, а через общие формы подсистемы «РаботаСФайлами» (ПрисоединенныеФайлы, форма добавления/просмотра версий), вызываемые командой «Присоединённые файлы» из формы документа ПоступлениеДопРасходов.
4. Ключевые процедуры модулей
Прикладной BSL-код в модулях данного справочника отсутствует или минимален — логика вынесена в общие модули БСП. Ниже перечислены типовые обработчики этого вида объекта (evidence по BSL не приложено — версионно-специфичные строки требуют сверки с конкретной поставкой):
Модуль объекта:
ПередЗаписью— фиксацияДатаМодификацииУниверсальная,Изменил, пересчётРазмер, обновлениеИндексКартинкипо расширению.ПриКопировании/ОбработкаЗаполнения— установкаАвтор,ДатаСозданияпри создании из команды присоединения.ПередУдалением— очистка связанных данных хранилища (тома/регистр) через методы подсистемы.
Модуль менеджера / общие модули БСП:
РаботаСФайлами,РаботаСФайламиСлужебный,РаботаСФайламиВызовСервера— добавление файла, чтение/запись двоичных данных, управление версиями, check-out/check-in, шифрование и подпись ЭП.ИзвлечениеТекстаФайлов— фоновое извлечение текста, установкаСтатусИзвлеченияТекстаи заполнениеТекстХранилище.
5. Проведение и движения
Справочник не проводится и не формирует бухгалтерских проводок и движений по регистрам учёта — это объект хранения данных, а не документ. Никаких записей в регистр бухгалтерии (проводок по счетам РК) он не делает.
Хозяйственные движения формирует документ-владелец ПоступлениеДопРасходов. Для контекста — его типовая логика на плане счетов РК (ставка НДС РК с 2026 г. — 16 %, валюта — тенге ₸):
- Отнесение суммы доп. расходов на стоимость ТМЗ: Дт 1330 «Товары» — Кт 3310 «КЗ поставщикам».
- Выделение входного НДС 16 %: Дт 1420 «НДС к возмещению» — Кт 3310 (при подтверждении ЭСФ из ИС ЭСФ).
- Оплата поставщику: Дт 3310 — Кт 1030 «Деньги на текущих счетах».
Пример: доп. расходы 500 000 ₸ + НДС 16 % (80 000 ₸): Дт 1330 = 500 000 ₸; Дт 1420 = 80 000 ₸; Кт 3310 = 580 000 ₸.
Технические регистры хранения файла (это не бухгалтерия), в которые опосредованно попадают данные при записи элемента:
- регистр сведений хранения двоичных данных файлов в БД (при
ТипХраненияФайла = ФайлХранилище) — хранит содержимое версий; - либо том хранения на диске (при хранении «на томе») — путь фиксируется в
ПутьКФайлу; - служебные записи версий и признаков ЭП/шифрования.
6. Связанные объекты и ввод на основании
- Документ-владелец:
Документ.ПоступлениеДопРасходов(реквизитВладелецФайла). - Справочники:
Пользователи(Автор,Изменил,Редактирует). - Перечисления:
ТипыХраненияФайлов,СтатусыИзвлеченияТекстаФайлов. - Подсистема: «РаботаСФайлами» (общие модули, общие формы, регистры хранения, тома).
- Электронные документы: сами файлы могут содержать печатные формы/квитанции ЭСФ (ИС ЭСФ) и СНТ, но справочник с ИС ЭСФ напрямую не взаимодействует.
Ввод на основании для этого справочника не предусмотрен: элементы создаются исключительно механизмом присоединения файлов из формы документа-владельца (команда «Присоединённые файлы» → «Добавить»). Как источник ввода на основании справочник также не выступает.
7. Точки расширения
- Расширения конфигурации: добавление реквизитов (напр. классификация типа документа, срок хранения) и подписка на события записи без снятия с поддержки.
- Подписки на события
ПередЗаписью/ПриЗаписиобъекта — для интеграции с внешним архивом, DMS или контроля квот. - Дополнительные обработки БСП (
ДополнительныеОтчетыИОбработки) — пакетная обработка, конвертация, проверка ЭП. - Настройки подсистемы «РаботаСФайлами»: тома хранения, максимальный размер, извлечение текста, шифрование, синхронизация — задаются администратором без доработки кода.
- Права доступа (RLS): ограничение видимости файлов через профили и группы доступа, увязанные с правами на документ-владелец.