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