Как добавить файл в 1С программно

Программное добавление файлов в 1С — типовая задача при интеграции с почтой, ЭДО, сайтами и внешними сервисами: нужно сохранить скан договора, фото товара или XML-файл обмена прямо в базе, привязав его к документу или элементу справочника. В зависимости от конфигурации и версии платформы используются разные механизмы: стандартные присоединённые файлы БСП, хранилище значений, двоичные данные и временные файлы на диске.

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

Какие способы хранения файлов существуют в 1С

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

Если конфигурация самописная или подсистема БСП не внедрена, файл хранят в реквизите объекта с типом «ХранилищеЗначения». Внутри хранилища лежат двоичные данные, сжатые платформой. Способ простой, но без готового интерфейса: открытие и скачивание придётся программировать самостоятельно.

Третий вариант — файл вообще не хранится в базе, а записывается в каталог на диске или передаётся по HTTP. Это подходит для обменов, где 1С выступает посредником, но не подходит, когда файл должен быть доступен пользователям из карточки объекта.

Добавление присоединённого файла в типовой конфигурации

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

&НаСервере
Процедура ДобавитьФайлКДокументу(Владелец, ПутьКФайлу)

    ДвоичныеДанные = Новый ДвоичныеДанные(ПутьКФайлу);
    АдресХранилища = ПоместитьВоВременноеХранилище(ДвоичныеДанные);

    Файл = Новый Файл(ПутьКФайлу);
    ИмяБезРасширения = Файл.ИмяБезРасширения;
    Расширение = СтрЗаменить(Файл.Расширение, ".", "");

    ПараметрыФайла = РаботаСФайлами.ПараметрыДобавленияФайла();
    ПараметрыФайла.ВладелецФайлов = Владелец;
    ПараметрыФайла.ИмяБезРасширения = ИмяБезРасширения;
    ПараметрыФайла.РасширениеБезТочки = Расширение;

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

КонецПроцедуры

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

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

Сохранение файла через ХранилищеЗначения

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

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

ОбъектСправочника = Справочники.Вложения.СоздатьЭлемент();
ОбъектСправочника.Наименование = "Договор.pdf";
ОбъектСправочника.ИмяФайла = "Договор.pdf";
ОбъектСправочника.ДанныеФайла = Новый ХранилищеЗначения(ДвоичныеДанные, Новый СжатиеДанных(9));
ОбъектСправочника.Записать();

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

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

Загрузка файла с клиента в тонком и веб-клиенте

В управляемом приложении прямой доступ к диску клиента с сервера невозможен, поэтому загрузка строится в два этапа: сначала файл помещается во временное хранилище на клиенте, затем адрес хранилища передаётся в серверную процедуру, которая создаёт присоединённый файл.

&НаКлиенте
Процедура ЗагрузитьФайл(Команда)

    ОписаниеОповещения = Новый ОписаниеОповещения("ПослеПомещенияФайла", ЭтотОбъект);
    НачатьПомещениеФайла(ОписаниеОповещения, , , Истина, УникальныйИдентификаторФормы);

КонецПроцедуры

&НаКлиенте
Процедура ПослеПомещенияФайла(Результат, Адрес, ВыбранноеИмяФайла, Доп) Экспорт

    Если Не Результат Тогда Возврат; КонецЕсли;
    СоздатьПрисоединенныйФайлНаСервере(Адрес, ВыбранноеИмяФайла, Владелец);

КонецПроцедуры

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

1. 1
   Записать объект-владелец, получить его ссылку
2. 2
   На клиенте вызвать НачатьПомещениеФайла с диалогом выбора
3. 3
   В обработчике оповещения получить адрес временного хранилища
4. 4
   Передать адрес в серверную процедуру
5. 5
   На сервере вызвать РаботаСФайлами.ДобавитьФайл
6. 6
   Обновить форму и проверить, что файл открылся из карточки объекта

Хранение файлов в томах на диске

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

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

Частые ошибки и как их диагностировать

Большинство проблем при программном добавлении файлов сводится к нескольким повторяющимся сценариям. Их удобно проверять в первую очередь, прежде чем искать ошибку в логике кода.

Проверка результата и отладка

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

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

Частые вопросы