1. Идентификация объекта
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | ГИСМПрисоединенныеФайлы |
| Полное имя | Справочник.ГИСМПрисоединенныеФайлы |
| Синоним | «Протокол обмена ГИСМ» (по evidence; фактически справочник хранит файлы, присоединённые к объектам обмена ГИСМ) |
| Конфигурация | Управление торговлей для Казахстана, редакция 3.4 (версия 3.4.5.21) |
| Подсистема | «Работа с файлами» (FilesOperations) Библиотеки стандартных подсистем (БСП) + прикладной блок интеграции с ГИСМ |
| Иерархия | Не иерархический (плоский), подчинён владельцу |
Назначение. Справочник является служебным хранилищем присоединённых файлов для объектов подсистемы обмена с ГИСМ (Государственная информационная система маркировки и прослеживаемости товаров). В нём хранятся файлы протоколов обмена, XML/JSON‑пакетов, квитанций, ответов сервиса и произвольных вложений, привязанных к объекту‑владельцу (документ или элемент справочника обмена ГИСМ). Справочник создаётся мастером «Присоединяемые файлы» БСП автоматически для конкретного владельца и не ведётся пользователем вручную как самостоятельный список.
Присоединённые файлы — не бухгалтерский объект: он не участвует в товарных, денежных или налоговых расчётах и не формирует движений (см. раздел 5). Все числовые и налоговые нормы РК‑2026 (НДС 16 %, МРП 4 325 ₸, МЗП 85 000 ₸) к нему неприменимы — они относятся к учётным документам, к которым файлы лишь прикрепляются.
Где найти: e1cib/list/Справочник.ГИСМПрисоединенныеФайлы
2. Реквизиты и табличные части
Табличных частей у справочника присоединённых файлов нет. Ниже — стандартный состав реквизитов, формируемый БСП для объектов типа «ПрисоединенныеФайлы».
2.1. Стандартные реквизиты
| Реквизит | Тип | Назначение |
|---|---|---|
Ссылка |
СправочникСсылка | Идентификатор элемента |
Код |
Строка/Число | Автонумерация экземпляра файла |
Наименование |
Строка | Имя файла без расширения (описание файла) |
Владелец |
Составной ссылочный тип | Объект, к которому присоединён файл (документ/элемент обмена ГИСМ) |
ПометкаУдаления |
Булево | Пометка на удаление |
2.2. Реквизиты шапки (прикладные)
| Реквизит | Тип | Назначение |
|---|---|---|
ХранениеФайла |
ХранилищеЗначения | Двоичные данные файла при хранении в информационной базе |
ТомХранилищаФайлов |
СправочникСсылка.ТомаХранилищаФайлов | Ссылка на том при хранении файла в томах на диске |
ПутьКФайлуТома |
Строка | Относительный путь к файлу внутри тома |
Расширение |
Строка | Расширение файла (xml, json, pdf, p7s, zip и т. п.) |
Размер |
Число | Размер файла в байтах |
Автор |
СправочникСсылка.Пользователи | Пользователь, добавивший/изменивший файл |
ДатаСоздания |
Дата | Дата и время создания файла |
ДатаИзменения |
Дата | Дата и время последнего изменения версии |
ДатаМодификацииУниверсальная |
Дата | Универсальная (UTC) дата модификации |
ПодписанЭП |
Булево | Признак наличия электронной подписи |
Зашифрован |
Булево | Признак шифрования содержимого |
Редактирует |
СправочникСсылка.Пользователи | Пользователь, занявший файл для редактирования (блокировка) |
ТекущаяВерсия |
СправочникСсылка.*ВерсииФайлов | Ссылка на активную версию (при включённом версионировании) |
ВерсияОтпечаток |
Число | Отпечаток актуальной версии для контроля целостности |
СтатусИзвлеченияТекста |
ПеречислениеСсылка | Состояние извлечения текста для полнотекстового поиска |
ТекстХранилище / ТекстИзвлеченныйИзФайла |
ХранилищеЗначения / Строка | Извлечённый текст файла для поиска |
Конкретный набор зависит от того, включены ли для этого владельца версионирование файлов, ЭП и шифрование в настройках подсистемы «Работа с файлами». (Наличие реквизитов версий — версионно‑зависимо, уточняется по конфигурации 3.4.5.21.)
3. Формы
| Форма | Назначение |
|---|---|
ФормаЭлемента |
Карточка файла: имя, размер, автор, даты, признаки ЭП/шифрования, команды просмотра, редактирования, сохранения на диск |
ФормаСписка |
Плоский список файлов владельца (используется редко — обычно вложения показываются общей формой БСП) |
Основная работа с вложениями ведётся не собственными формами справочника, а общими формами подсистемы «Работа с файлами»:
ОбщаяФорма.ПрисоединенныеФайлы— панель/форма списка присоединённых файлов, встраиваемая в форму владельца;ОбщаяФорма.ПросмотрФайла,ОбщаяФорма.РедактированиеРеквизитовФайла,ОбщаяФорма.ВыборРежимаОткрытияФайла— сервисные формы просмотра, редактирования свойств и выбора способа открытия.
4. Ключевые процедуры модулей
Отдельного BSL‑evidence по модулям объекта не приложено, поэтому ниже — типовой набор обработчиков, характерный для справочников присоединённых файлов БСП. Основная логика вынесена в общие модули подсистемы «Работа с файлами».
Модуль объекта / менеджера:
ОбработкаЗаполнения— инициализация автора, дат создания/изменения при создании файла.ПередЗаписью— обновлениеДатаИзменения,ВерсияОтпечаток, контроль блокировки редактирования.ПередУдалением— удаление связанного файла из тома (ТомХранилищаФайлов/ПутьКФайлуТома) при физическом удалении.
Общие модули БСП (фактическая бизнес‑логика):
РаботаСФайлами/РаботаСФайламиКлиент— открытие, редактирование, сохранение, занятие/освобождение файла.РаботаСФайламиСлужебный,РаботаСФайламиСлужебныйСервер— добавление файла, создание версий, извлечение двоичных данных изХранениеФайлаили тома.РаботаСФайламиВызовСервера— серверные вызовы добавления/обновления вложений.- Механизм «Присоединяемые файлы» — сопоставление владельца с его справочником файлов (
ГИСМПрисоединенныеФайлы).
Прикладной слой ГИСМ: запись файлов протокола/квитанций обмена выполняется процедурами модулей интеграции с ГИСМ, которые вызывают методы БСП, передавая владельца (документ или объект обмена) и двоичные данные пакета. (Точные имена процедур ГИСМ — версионно‑зависимы для 3.4.5.21.)
5. Проведение и движения
Справочник не является документом и не проводится. Он не формирует:
- регистров накопления (товары, взаиморасчёты, продажи);
- регистров бухгалтерии и бухгалтерских проводок по плану счетов РК.
Единственное «движение данных» — запись/удаление двоичного содержимого файла: либо в реквизит ХранениеФайла (внутри ИБ), либо в файл тома на диске (ТомХранилищаФайлов + ПутьКФайлуТома), плюс регистрация версии в регистре сведений версий файлов при включённом версионировании.
Учётные проводки формируют документы‑владельцы, к которым присоединяются эти файлы, а не сам справочник. Для справки, релевантные счета типового плана РК, задействуемые такими документами (реализация, поступление, оплата):
| Операция владельца | Счета РК |
|---|---|
| Реализация товаров и НДС к уплате | Дт 1210 – Кт 6010; Кт 3130 (НДС 16 %); списание Дт 7010 – Кт 1330 |
| Поступление товаров | Дт 1330 – Кт 3310; НДС Дт 1420 – Кт 3310 |
| Оплата от покупателя / поставщику | Дт 1030 – Кт 1210; Дт 3310 – Кт 1030 |
Электронные документы, связанные с оборотом маркируемого товара (ЭСФ в ИС ЭСФ, СНТ), также относятся к документам‑владельцам, а не к данному справочнику.
6. Связанные объекты и ввод на основании
- Владелец файла — документ или элемент справочника подсистемы обмена ГИСМ (объекты интеграции с системой маркировки). Файл создаётся исключительно в контексте своего владельца.
Справочник.ТомаХранилищаФайлов— тома для файлового хранения вне ИБ.Справочник.Пользователи— реквизитыАвториРедактирует.- Регистр сведений версий/двоичных данных файлов — при включённом версионировании.
- Ввод на основании — не предусмотрен: элементы порождаются программно механизмом присоединённых файлов, а не командой «Создать на основании».
7. Точки расширения
- Настройки подсистемы «Работа с файлами»: включение версионирования, хранения в томах, ЭП и шифрования влияет на состав реквизитов и поведение.
- Расширения конфигурации: подписка на события
ПередЗаписью/ПередУдалениеммодуля объекта, добавление реквизитов через расширение. - Общие модули БСП (
РаботаСФайламиПереопределяемый,РаботаСФайламиКлиентСервер) — процедуры переопределения обработки файлов. - Прикладные процедуры ГИСМ — точка встраивания логики автосохранения пакетов/квитанций обмена в присоединённые файлы.
- Настройки хранения (
ТомаХранилищаФайлов, ограничения размера/расширений) — регулируются администратором без изменения кода.