Справочник «КонтрагентыПрисоединенныеФайлы» в «1С:Бухгалтерии для Казахстана», редакция 3.0, релиз 3.0.74.2, предназначен для хранения сведений о файлах, прикреплённых к карточкам контрагентов. Путь к файлам контрагента: «Справочники → Покупки и продажи → Контрагенты → открыть карточку контрагента → Присоединенные файлы».
1. Идентификация
| Параметр | Значение |
|---|---|
| Тип объекта | Справочник (Catalog) |
| Имя | КонтрагентыПрисоединенныеФайлы |
| Полное имя | Справочник.КонтрагентыПрисоединенныеФайлы |
| Синоним | «Присоединенные файлы (Контрагенты)» |
| Конфигурация | «1С:Бухгалтерия для Казахстана», редакция 3.0, релиз 3.0.74.2 |
| Подсистема-источник | Библиотека стандартных подсистем (БСП), подсистема «Работа с файлами» / «Присоединённые файлы» |
| Где найти | «Справочники → Покупки и продажи → Контрагенты → открыть карточку контрагента → Присоединенные файлы». Прямая навигационная ссылка: e1cib/list/Справочник.КонтрагентыПрисоединенныеФайлы. |
Назначение. Справочник хранит сведения о файлах, прикреплённых к карточкам контрагентов: скан-копиях договоров, лицензий, свидетельств о регистрации, изображениях, таблицах и файлах других форматов. Подсистема работы с файлами предусматривает ведение версий, размещение данных в информационной базе или на внешних томах, применение электронной подписи и шифрования. Запись справочника содержит метаданные одного присоединённого файла, а двоичные данные обрабатываются связанными объектами подсистемы.
Это технический служебный справочник для управления вложениями контрагентов. Его записи используются подсистемой работы с файлами и доступны из карточки соответствующего контрагента.
2. Реквизиты шапки и табличные части
2.1 Реквизиты шапки
| Имя | Тип | Обязательность | Назначение |
|---|---|---|---|
| Автор | СправочникСсылка.Пользователи | Обязательный (ShowError) | Пользователь, создавший файл. Заполняется при создании записи. |
| ВладелецФайла | СправочникСсылка.Контрагенты | Необязательный | Ссылка на контрагента, к которому прикреплён файл. Определяет принадлежность файла. |
| ДатаМодификацииУниверсальная | ДатаВремя | Необязательный | Универсальное время последнего изменения файла. Применяется при синхронизации и контроле изменений. |
| ДатаСоздания | ДатаВремя | Обязательный (ShowError) | Дата и время создания файла в системе. Заполняется при добавлении. |
| Зашифрован | Булево | Необязательный | Признак хранения файла в зашифрованном виде. |
| Изменил | СправочникСсылка.Пользователи | Необязательный | Пользователь, последним изменивший файл или его карточку. |
| ИндексКартинки | Число | Необязательный | Индекс изображения файла в коллекции картинок. Используется для отображения значка, соответствующего типу файла. |
| Описание | Строка | Необязательный | Текстовое описание назначения или содержания файла. |
| ПодписанЭП | Булево | Необязательный | Признак наличия электронной подписи у файла. |
| ПутьКФайлу | Строка | Необязательный | Путь к файлу на томе при внешнем хранении. Для данных, размещённых в информационной базе, реквизит не заполняется. |
| Размер | Число | Необязательный | Размер файла в байтах. |
| Расширение | Строка | Необязательный | Расширение файла: pdf, xlsx, jpg и другое. Используется при выборе способа открытия и изображения файла. |
| Редактирует | СправочникСсылка.Пользователи | Необязательный | Пользователь, захвативший файл на редактирование. Значение реквизита позволяет контролировать одновременное изменение файла. |
| СтатусИзвлеченияТекста | ПеречислениеСсылка.СтатусыИзвлеченияТекстаФайлов | Необязательный | Состояние извлечения текста из файла для полнотекстового поиска. |
| ТекстХранилище | ХранилищеЗначения | Необязательный | Извлечённый из файла текст, используемый при полнотекстовом поиске. |
| ТипХраненияФайла | ПеречислениеСсылка.ТипыХраненияФайлов | Обязательный (ShowError) | Способ размещения данных файла: в информационной базе или в томах на диске. |
Стандартные реквизиты справочника. Объект также использует стандартные реквизиты справочника: Наименование, Код, ПометкаУдаления, Предопределённый и Ссылка. Наименование содержит имя файла, а принадлежность записи контрагенту определяется значением реквизита ВладелецФайла.
Дополнительные реквизиты подсистемы. Состав связанных данных определяется реализацией БСП в релизе 3.0.74.2. Для версий, места хранения и ограничений редактирования подсистема может использовать отдельные связанные объекты, поэтому при разработке расширения перечень доступных полей следует получать из метаданных установленной конфигурации, а не обращаться к предполагаемым именам реквизитов.
2.2 Табличные части
У справочника отсутствуют собственные табличные части. Одна запись соответствует одному файлу и содержит его основные сведения. Версии, двоичные данные и электронные подписи обрабатываются отдельными объектами подсистемы работы с файлами.
3. Формы
| Форма | Назначение |
|---|---|
| Форма элемента | Карточка присоединённого файла со сведениями о наименовании, описании, авторе, датах, размере, расширении, электронной подписи и шифровании. Доступные команды зависят от состояния файла и прав пользователя. |
| Форма списка | Список файлов. При вызове из карточки контрагента данные отображаются с отбором по текущему значению ВладелецФайла. |
| Форма выбора | Используется для выбора файла в сценариях, предусматривающих ссылку на ранее добавленный объект. |
| Служебные формы БСП | Обеспечивают просмотр и добавление файлов, выбор способа загрузки, работу с версиями и электронными подписями. Такие формы могут относиться к общим формам подсистемы, а не непосредственно к справочнику. |
Фактический состав форм и их программные имена определяются метаданными объекта в релизе 3.0.74.2. Это особенно важно для внешних обработок и расширений: обращение должно выполняться к форме, которая присутствует в установленной конфигурации.
4. Ключевые процедуры модулей
Обработка файлов распределена между модулем объекта, формами и общими модулями подсистемы. При доработке следует ориентироваться на экспортные процедуры и фактические вызовы релиза 3.0.74.2, поскольку техническое имя обработчика нельзя определять только по назначению команды.
Операции уровня объекта:
- первичное заполнение автора, даты создания, способа хранения и других служебных сведений при создании записи;
- обновление сведений о пользователе и времени изменения перед записью;
- контроль состояния редактирования и согласованности ссылки на владельца файла;
- обработка удаления записи совместно со связанными данными подсистемы хранения.
Операции формы элемента:
- подготовка доступных команд с учётом прав пользователя и состояния файла;
- открытие файла для просмотра;
- начало, завершение и отмена редактирования;
- сохранение файла в выбранное пользователем место;
- обновление содержимого из файла на диске;
- работа с версиями, шифрованием и электронными подписями.
Общие модули подсистемы:
- обеспечивают добавление, получение и обновление присоединённых файлов;
- разделяют клиентские и серверные операции открытия, редактирования и сохранения;
- читают и записывают двоичные данные в информационную базу или том хранения;
- выполняют операции с электронными подписями;
- управляют версиями и извлечением текста для полнотекстового поиска.
Для вызова программного интерфейса в расширении нужно открыть конфигуратор, перейти по пути «Конфигурация → Открыть конфигурацию → Общие → Общие модули» и выбрать модуль подсистемы работы с файлами, используемый в релизе 3.0.74.2. Параметры вызова определяются по объявлению экспортной процедуры в этом модуле.
5. Проведение и движения
Объект относится к типу «Справочник», поэтому для него применяется запись элемента, а не проведение документа. При сохранении изменяются сведения о присоединённом файле и связанные служебные данные подсистемы хранения.
В зависимости от выбранного способа размещения подсистема обрабатывает следующие данные:
| Данные или объект | Назначение |
|---|---|
| Двоичные данные текущего файла | Содержимое актуального файла при размещении в информационной базе. |
| Двоичные данные версий | Содержимое сохранённых версий при включённом ведении истории. |
| Сведения о версиях | Автор, дата, размер, комментарий и другие метаданные версии. |
| Том хранения файлов | Физическое размещение файла при хранении вне информационной базы; путь связывается с карточкой файла. |
| Данные электронной подписи | Электронные подписи и сведения об их проверке. |
| Данные полнотекстового поиска | Состояние извлечения и текст, полученный из поддерживаемого формата файла. |
При добавлении или обновлении файла система создаёт либо изменяет запись справочника, сохраняет содержимое выбранным способом, обновляет сведения о версии и передаёт файл механизмам извлечения текста, когда такая обработка включена в информационной базе.
6. Связанные объекты и ввод на основании
- Справочник.Контрагенты — объект, с карточкой которого связан файл через реквизит ВладелецФайла.
- Справочник.Пользователи — источник значений для сведений об авторе, пользователе, изменившем запись, и пользователе, редактирующем файл.
- Перечисления подсистемы файлов — описывают способ хранения и состояние извлечения текста.
- Объекты хранения двоичных данных и версий — содержат данные файла и историю его изменения.
- Подсистема электронных подписей — выполняет операции подписания и проверки подписи.
Создание записи. Пользователь добавляет файл из карточки контрагента по пути «Справочники → Покупки и продажи → Контрагенты → открыть карточку контрагента → Присоединенные файлы → Добавить». После выбора файла подсистема создаёт запись, связывает её с текущим контрагентом и сохраняет содержимое установленным в информационной базе способом.
Механизм «Ввод на основании», предназначенный для создания одного прикладного объекта по данным другого, для этой операции не используется. Связь с контрагентом возникает при добавлении вложения из его карточки или при программной передаче владельца файла.
7. Точки расширения
- Расширение конфигурации. Позволяет добавить реквизиты, команды и элементы формы без изменения основной конфигурации. Для файлов можно предусмотреть, например, вид документа или срок действия.
- Подписки на события. Подходят для заполнения дополнительных данных, ведения журнала операций и прикладного контроля перед записью или после неё.
- Экспортный интерфейс общих модулей БСП. Используется для добавления, получения и обновления файлов из прикладного кода. Следует вызывать процедуры, присутствующие в релизе 3.0.74.2, с параметрами из их объявлений.
- Дополнительные реквизиты и сведения. Позволяют хранить пользовательские характеристики файла средствами подсистемы свойств, когда она подключена к этому объекту.
- Ограничения доступа. Доступ к вложению должен учитывать права пользователя на карточку контрагента и команды подсистемы работы с файлами.
- Правила обмена и синхронизации. При передаче контрагента необходимо согласованно обрабатывать ссылку на файл, служебные сведения и двоичное содержимое.
Перед разработкой расширения полезно зафиксировать сценарий: добавление файла, чтение содержимого, изменение описания, управление версиями или проверка подписи. Это позволяет выбрать подходящий программный интерфейс и не обращаться напрямую к внутреннему хранилищу там, где подсистема предоставляет готовую операцию.
8. Вопросы и ответы
Как открыть файлы конкретного контрагента?
Перейдите по пути «Справочники → Покупки и продажи → Контрагенты», откройте карточку нужного контрагента и выберите «Присоединенные файлы». Список будет связан с текущей карточкой через реквизит ВладелецФайла.
Где хранится содержимое присоединённого файла?
Способ хранения задаётся настройками подсистемы: содержимое размещается в информационной базе либо в томе хранения. Карточка справочника содержит сведения о файле и данные, необходимые для обращения к выбранному месту хранения.
Можно ли программно добавить файл к контрагенту?
Да. Для этого используют экспортный программный интерфейс подсистемы работы с файлами в релизе 3.0.74.2 и передают ссылку на контрагента как владельца. Имя процедуры и состав параметров следует брать непосредственно из объявления экспортной процедуры общего модуля установленной конфигурации.
Почему файл может быть недоступен для редактирования?
Редактирование ограничивается, когда файл уже захвачен другим пользователем, у текущего пользователя недостаточно прав либо состояние файла допускает только просмотр. Сведения о пользователе, работающем с файлом, связаны с реквизитом Редактирует.
Как проверить состав реквизитов и форм объекта?
Откройте конфигуратор и перейдите по пути «Конфигурация → Открыть конфигурацию → Справочники → КонтрагентыПрисоединенныеФайлы». В ветвях «Реквизиты», «Табличные части», «Формы» и «Модули» отображается состав объекта релиза 3.0.74.2.