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

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

Как вставить файл в 1С: прикрепление документов и картинок

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

Вставка файла в 1С — одна из самых частых операций: скан договора прикрепляют к карточке контрагента, акт — к реализации, фото товара — к номенклатуре, а внешнюю печатную форму — к базе целиком. В типовых конфигурациях на платформе 8.3 для этого предусмотрен механизм присоединённых файлов, который работает почти одинаково в «Бухгалтерии», «Управлении торговлей», «Зарплате и управлении персоналом» и других решениях.

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

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

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

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

В открывшемся списке нажмите «Добавить» и выберите вариант «Из файла на диске» (или «Из файла»). Укажите путь к файлу на компьютере — подойдут PDF, JPEG, PNG, DOCX, XLSX и большинство других форматов. После выбора файл загрузится в базу и появится в списке. Многие конфигурации поддерживают и перетаскивание: просто перетащите файл мышью из проводника Windows в область присоединённых файлов.

Если файл — это скан подписанного документа, удобно сразу заполнить его описание: в карточке файла можно указать наименование, автора и комментарий. Это упрощает поиск, когда к одному документу прикреплено несколько файлов — например, счёт, накладная и акт.

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

Как отсканировать документ сразу в 1С

Если документ существует только на бумаге, файл можно не сохранять на диск, а отсканировать прямо из программы. В списке присоединённых файлов выберите «Добавить» → «Со сканера». 1С обратится к установленному сканеру через стандартный интерфейс драйвера (TWAIN/WIA), предложит выбрать устройство и параметры сканирования, после чего готовое изображение попадёт сразу в базу.

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

Настройка хранения файлов: в базе или в томах на диске

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

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

Сравнение вариантов хранения

В информационной базе

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

В томах на диске

Подходит при больших объёмах сканов и вложений. Плюс — база остаётся компактной. Минус — папку томов нужно резервировать отдельно и следить за правами доступа к ней.

Вставка картинки в макет и печатную форму

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

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

Загрузка внешних отчётов, обработок и печатных форм

Файлы форматов EPF (внешняя обработка) и ERF (внешний отчёт) вставляются иначе. Для разового запуска достаточно открыть файл через меню «Файл» → «Открыть» — обработка выполнится, но в базе не сохранится.

Для постоянного использования подключите файл через «Администрирование» → «Печатные формы, отчёты и обработки» → «Дополнительные отчёты и обработки». Включите механизм, если он выключен, откройте список и нажмите «Добавить из файла». Программа проверит файл, покажет его сведения и, если обработка корректно описана, добавит её в список — после этого она появится в разделе «Дополнительные обработки» соответствующего раздела или в списке печатных форм документа.

Программная вставка файла на встроенном языке

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

// Пример без БСП: файл хранится в реквизите типа "ХранилищеЗначения"

ДвоичныеДанные = Новый ДвоичныеДанные("C:\Документы\Договор.pdf");

НовыйЭлемент = Справочники.ПрисоединенныеФайлы.СоздатьЭлемент();

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

НовыйЭлемент.Наименование = "Договор.pdf";

НовыйЭлемент.ДанныеФайла = Новый ХранилищеЗначения(ДвоичныеДанные, Новый СжатиеДанных(9));

НовыйЭлемент.Записать();

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

При пакетной загрузке сканов из папки удобно формировать имя файла по шаблону «НомерДокумента_Дата», чтобы потом сопоставить файлы документам программно. Это сильно упрощает массовое прикрепление и снижает количество ошибок ручного выбора.
ПЗ
Практическое замечание

Проверка результата и типичные ошибки

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

Контрольные точки

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

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

Файл виден, открывается двойным щелчком, размер не нулевой

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

Файл есть в списке, но не открывается или открывается пустым

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

Коллеги видят и открывают файл

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

Файл виден только автору — проверьте права и профили групп доступа

Размер базы после массовой загрузки
Норма

Рост базы соответствует объёму загруженных файлов

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

База выросла в разы сильнее — возможны дубли файлов

Типичные ошибки
01
Прикрепление ярлыка вместо файла — в базу попадает файл .lnk на несколько килобайт, который ни у кого не откроется. Всегда выбирайте сам файл, а не ярлык на рабочем столе.
02
Перенос исходной папки томов хранения без копирования — ссылки в базе остаются, а файлы теряются. Перед переносом делайте полную копию папки томов.
03
Массовая загрузка без контроля дублей — один и тот же скан прикрепляется несколько раз, база раздувается, поиск документа усложняется.
04
Открытие внешней обработки через «Файл → Открыть» вместо подключения — после закрытия окна обработка пропадает, и её ищут заново.

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

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

Механизм присоединённых файлов не ограничивает формат: подойдут PDF, изображения, документы Word и Excel, архивы и другие типы. Ограничение касается только открытия — файл запускается программой, ассоциированной с его расширением в операционной системе, поэтому для просмотра PDF на компьютере должен быть установлен соответствующий просмотрщик.

Почему кнопка «Присоединённые файлы» не отображается в документе?

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

Есть ли ограничение на размер прикрепляемого файла?

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

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

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

Что произойдёт с присоединёнными файлами при обновлении конфигурации?

Штатное обновление не удаляет присоединённые файлы — они хранятся в служебных справочниках и не затрагиваются механизмом обновления. Риск возникает только при нештатных действиях: загрузке базы из старой выгрузки (файлы вернутся к состоянию на дату копии) или при очистке базы специальными обработками.

Можно ли вставить файл в 1С через веб-клиент?

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

Итог

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

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