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