К статье
Практический материал

Документы и Печать · 10 мин

Как присоединить файл в 1С: способы, ограничения и проверка результата

Как прикрепить файл к документу, справочнику или письму в 1С:Предприятие 8.3. Способы через кнопку скрепки, перетаскивание и программно, ограничения и типичные ошибки.

Присоединение файлов в 1С — стандартный механизм, который позволяет хранить сканы договоров, акты, фотографии товаров и другие документы прямо внутри информационной базы, привязанными к конкретному объекту: документу, элементу справочника или сделке. В типовых конфигурациях (1С:Бухгалтерия, 1С:Управление торговлей, 1С:ERP, ЗУП) этот механизм реализован через библиотеку стандартных подсистем и работает почти одинаково.

Чаще всего файл прикрепляют кнопкой со значком скрепки на панели формы объекта или через ссылку «Присоединенные файлы». Дополнительно работает перетаскивание файла мышью прямо в форму документа, а разработчики могут добавлять файлы программно через встроенный язык. Выбор способа зависит от задачи: разовое прикрепление скана удобнее сделать мышью, массовую загрузку — обработкой или кодом.

Перед началом проверьте два условия: в вашей конфигурации включена работа с присоединенными файлами, а у вашей роли есть права на добавление файлов. Если кнопки скрепки в форме нет — скорее всего, механизм отключен администратором или объект не поддерживает вложения.

Где в 1С хранятся присоединенные файлы и что нужно проверить заранее

В типовых конфигурациях присоединенные файлы хранятся в справочниках вида «ИмяОбъектаПрисоединенныеФайлы» (например, «РеализацияТоваровУслугПрисоединенныеФайлы»). Сами двоичные данные могут лежать либо внутри информационной базы, либо в томах на диске — это определяется настройкой «Хранить файлы в томах на диске» в разделе администрирования.

Хранение в базе проще в администрировании и автоматически попадает в резервную копию, но увеличивает размер базы и замедляет выгрузку. Хранение в томах разгружает базу, однако требует отдельного резервного копирования папки томов и корректных прав доступа к сетевому каталогу.

Проверить текущий режим можно так: Администрирование → Настройка работы с файлами. Там же задается максимальный размер загружаемого файла и список запрещенных расширений. Если при загрузке появляется ошибка о превышении размера — первым делом смотрите эту настройку.

Как прикрепить файл к документу или справочнику через интерфейс

Основной сценарий выглядит одинаково в большинстве типовых конфигураций. Откройте документ (например, «Поступление товаров и услуг») или элемент справочника (контрагента, номенклатуру, договор) в режиме редактирования. На командной панели формы найдите кнопку со значком скрепки — она может называться «Присоединенные файлы» или находиться в меню «Еще».

В открывшемся списке файлов нажмите «Добавить» и выберите вариант: «Из файла на диске» — для загрузки готового файла, «Из шаблона» — если настроены печатные формы-шаблоны, «Со сканера» — если подключен сканер и настроено сканирование. После выбора файла он появится в списке с указанием имени, размера, автора и даты загрузки.

Файл привязывается именно к тому объекту, из формы которого вы его добавили. Если прикрепить скан к одному документу реализации, он не появится в других документах автоматически — для связанных объектов файл нужно прикреплять отдельно или копировать.

Порядок действий
  1. 1
    Откройте документ или элемент справочника в режиме редактирования
  2. 2
    Нажмите кнопку со скрепкой или ссылку «Присоединенные файлы» на панели формы
  3. 3
    Нажмите «Добавить» → «Из файла на диске» и выберите нужный файл
  4. 4
    Дождитесь появления файла в списке с именем, размером и автором
  5. 5
    Запишите объект, если форма требует записи, и закройте список файлов

Как прикрепить файл перетаскиванием (Drag-and-Drop)

В управляемых формах 1С:Предприятие 8.3 поддерживается перетаскивание файлов из проводника Windows прямо в форму объекта. Откройте документ и окно проводника рядом, захватите файл мышью и перетащите его в область формы. Платформа предложит присоединить файл — подтвердите действие.

Перетаскивание удобно при массовой работе: можно выделить сразу несколько файлов в проводнике и перенести их одним движением. Каждый файл будет добавлен как отдельная запись в список присоединенных файлов.

Учтите ограничение: перетаскивание работает в толстом и тонком клиенте под Windows, но в веб-клиенте поведение зависит от браузера и версии платформы — часто там доступна только загрузка через диалог выбора файла. Если перетаскивание не срабатывает, используйте кнопку скрепки.

Как открыть, изменить и удалить присоединенный файл

Открыть файл можно двойным щелчком в списке присоединенных файлов — 1С сохранит его во временный каталог и запустит связанное приложение (PDF-просмотрщик, Word, Excel). Если файл открыт только для просмотра, изменения не попадут обратно в базу.

Для редактирования используйте команду «Редактировать»: платформа заблокирует файл для других пользователей и после завершения работы предложит поместить измененную версию обратно. Пока файл занят вами, в списке он отображается с отметкой «Редактируется», и другие пользователи видят, кто его заблокировал.

Удаление выполняется кнопкой удаления в списке файлов. В типовых конфигурациях удаление обычно помечает файл на удаление, а физическая очистка данных происходит при удалении помеченных объектов. Будьте осторожны: восстановить удаленный присоединенный файл без резервной копии невозможно.

Как присоединить файл программно через встроенный язык

Для разработчиков и при массовой загрузке используется модуль «РаботаСФайлами» библиотеки стандартных подсистем. Типовой вызов — функция РаботаСФайлами.ДобавитьФайл, которой передаются владелец файла, путь на диске и параметры. Ниже упрощенный пример добавления файла к документу.

ПараметрыФайла = РаботаСФайлами.ПараметрыДобавленияФайла();

ПараметрыФайла.ВладелецФайлов = ДокументСсылка;

ПараметрыФайла.ИмяБезРасширения = "Скан_договора";

ПараметрыФайла.РасширениеБезТочки = "pdf";

НовыйФайл = РаботаСФайлами.ДобавитьФайл(

ПараметрыФайла,

ПоместитьВоВременноеХранилище(Новый ДвоичныеДанные("C:\Scans\dogovor.pdf")));

Обратите внимание: сигнатура процедур и имя модуля могут отличаться в зависимости от версии БСП в вашей конфигурации (в старых версиях — «ПрисоединенныеФайлы»). Перед использованием сверьтесь с кодом своей конфигурации в конфигураторе. Для массовой загрузки из папки удобно написать внешнюю обработку с обходом каталога через НайтиФайлы.

bsl
ПараметрыФайла = РаботаСФайлами.ПараметрыДобавленияФайла();
ПараметрыФайла.ВладелецФайлов = СсылкаНаОбъект;
НовыйФайл = РаботаСФайлами.ДобавитьФайл(ПараметрыФайла, АдресВоВременномХранилище);

Типичные проблемы и как их решить

Если кнопка скрепки отсутствует или неактивна, причины обычно такие: у пользователя нет прав на добавление файлов (проверьте роли «Добавление изменение файлов»), объект не записан в базу (сначала запишите новый документ), либо механизм файлов отключен в настройках программы. В файловой базе также проверьте, что база не открыта в монопольном режиме другим процессом.

Ошибка «Файл превышает максимальный размер» решается в настройке «Администрирование → Настройка работы с файлами» — увеличьте ограничение или сожмите файл. Ошибка доступа при хранении в томах означает, что у службы сервера 1С нет прав на сетевой каталог томов — проверьте права учетной записи, под которой работает агент сервера.

Если файл загрузился, но не открывается, возможно, на компьютере нет приложения для этого формата или файл был поврежден при передаче. Проверьте файл, сохранив его на диск командой «Сохранить как» и открыв напрямую.

Типичные ошибки
01
Прикрепление файла к незаписанному объекту — после закрытия формы вложение теряется, сначала запишите документ
02
Хранение файлов в томах без резервного копирования каталога томов — при сбое диска вложения пропадают, хотя база цела
03
Редактирование файла, открытого на просмотр — изменения сохраняются во временную папку и не возвращаются в базу
04
Загрузка файлов с одинаковыми именами без проверки — в списке появляются дубли, и сложно понять, какая версия актуальна
Контрольные точки

Как проверить результат

Файл в списке присоединенных
Норма

Видны имя, размер, автор и дата загрузки

Тревожный признак

Строка есть, но размер 0 байт или имя пустое

Открытие файла
Норма

Файл открывается в связанной программе без ошибок

Тревожный признак

Ошибка чтения или пустое окно просмотра

Доступность другим пользователям
Норма

Коллега видит файл в том же документе

Тревожный признак

Файл виден только вам — объект не записан или нет прав

FAQ: частые вопросы о присоединении файлов в 1С

Почему нет кнопки скрепки в форме документа?

Наиболее вероятные причины: объект еще не записан (запишите документ), у вашей роли нет прав на работу с файлами, либо в настройках конфигурации отключена подсистема работы с файлами. Также не все объекты поддерживают вложения — например, у части служебных регистров и документов механизм не подключен.

Можно ли прикрепить сразу несколько файлов?

Да. В диалоге выбора файла выделите несколько файлов с зажатой клавишей Ctrl, либо перетащите группу файлов из проводника в форму объекта. Каждый файл станет отдельной записью в списке присоединенных файлов.

Куда физически сохраняются файлы — в базу или на диск?

Это определяется настройкой «Администрирование → Настройка работы с файлами». По умолчанию файлы хранятся в информационной базе. Если включено хранение в томах, двоичные данные пишутся в указанный каталог на диске, а в базе остается только ссылка.

Как выгрузить все присоединенные файлы из базы на диск?

Штатной кнопки «выгрузить всё» в типовых конфигурациях обычно нет. Используйте групповое сохранение: выделите нужные строки в списке файлов и примените «Сохранить как». Для массовой выгрузки по всей базе потребуется внешняя обработка с обходом справочников присоединенных файлов.

Ограничен ли размер и тип прикрепляемых файлов?

Да, оба ограничения настраиваются администратором: максимальный размер задается в настройках работы с файлами, а опасные расширения (например, исполняемые файлы) могут быть запрещены к загрузке. Точные значения зависят от настроек вашей базы.

Можно ли прикрепить файл к письму встроенной почты 1С?

Да, в конфигурациях со встроенной почтой (например, 1С:Документооборот, УТ с почтовым клиентом) в форме письма есть кнопка вложения — файл добавляется с диска или из присоединенных файлов объекта. Это отдельный механизм: вложение письма не дублируется в присоединенные файлы документа автоматически.

Итог

Что важно запомнить

Файл прикрепляется к записанному объекту через кнопку скрепки или перетаскиванием. Место хранения (база или тома на диске) определяет порядок резервного копирования. Перед удалением вложений и массовыми операциями всегда делайте резервную копию, а для массовой загрузки используйте программный интерфейс РаботаСФайлами.