1С: сохранить как программно — способы и примеры

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

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

Какие методы отвечают за сохранение в 1С

Встроенный язык 1С предоставляет несколько семейств методов записи, и выбор зависит от типа сохраняемого объекта:

• ТабличныйДокумент.Записать(ИмяФайла, ТипФайла) — сохранение печатных форм и отчётов в MXL, Excel, PDF, HTML и другие форматы;
• ТекстовыйДокумент.Записать(ИмяФайла, Кодировка) — выгрузка текстовых файлов, XML, CSV;
• ДвоичныеДанные.Записать(ИмяФайла) — сохранение произвольных файлов (картинки, архивы, вложения);
• ЗаписьXML, ЗаписьJSON, ЗаписьТекста — потоковая запись структурированных данных;
• ЗначениеВФайл(ИмяФайла, Значение) — сериализация произвольного значения во внутреннем формате.

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

Сохранение табличного документа (печатной формы) в файл

Самый частый сценарий — выгрузить сформированный табличный документ в Excel или PDF. Минимальный пример на сервере:

ТабДок = Новый ТабличныйДокумент;
// ... формирование макета ...
ТабДок.Записать("C:\Temp\Акт.pdf", ТипФайлаТабличногоДокумента.PDF);

Параметр типа файла определяет формат: MXL, XLSX, XLS, PDF, HTML5, ODS, TXT и другие. Для PDF доступна дополнительная настройка через объект ПараметрыЗаписиPDF — можно задать защиту, вложения и соответствие стандарту PDF/A.

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

ТабДок.Записать("C:\Temp\Отчет.xlsx", ТипФайлаТабличногоДокумента.XLSX);

Интерактивное «Сохранить как»: диалог выбора файла

Когда путь должен выбрать пользователь, применяется объект ДиалогВыбораФайла в режиме РежимДиалогаВыбораФайла.Сохранение. Синхронный вариант подходит для толстого клиента и демонстрационных решений:

Диалог = Новый ДиалогВыбораФайла(РежимДиалогаВыбораФайла.Сохранение);
Диалог.Фильтр = "Файлы Excel (.xlsx)|.xlsx";
Диалог.ИмяФайла = "Реестр платежей";
Если Диалог.Выбрать() Тогда
ТабДок.Записать(Диалог.ПолноеИмяФайла, ТипФайлаТабличногоДокумента.XLSX);
КонецЕсли;

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

&НаКлиенте
Процедура СохранитьФайл(Команда)
Адрес = СформироватьФайлНаСервере(); // помещаем данные во временное хранилище
НачатьПолучениеФайла(Новый ОписаниеОповещения("ПослеПолучения", ЭтотОбъект),
Адрес, "Реестр.xlsx", Истина);
КонецПроцедуры

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

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

Сохранение двоичных данных и вложений

Файлы, хранящиеся в базе (в реквизитах типа «ХранилищеЗначения», в справочниках присоединённых файлов БСП), извлекаются как двоичные данные и записываются на диск:

ДвоичныеДанные = ХранилищеФайла.Получить();
ДвоичныеДанные.Записать("D:\Выгрузка\договор.pdf");

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

При массовой выгрузке вложений следите за свободным местом и длиной пути: в Windows действует ограничение около 260 символов для классических API, и длинные имена файлов из базы могут приводить к ошибкам записи.

Запись на сервере и права доступа

Код, выполняемый в серверной процедуре, пишет файлы от имени учётной записи, под которой работает агент сервера 1С (по умолчанию — служебная учётная запись). Это частая причина ошибок «нет доступа»: разработчик тестирует на своём компьютере, где всё работает, а на сервере запись в сетевую папку падает.

Правила безопасной записи на сервере:

• используйте КаталогВременныхФайлов() для промежуточных файлов и удаляйте их после использования;
• для постоянных выгрузок выделяйте отдельный каталог с явно выданными правами для учётной записи сервера;
• сетевые пути указывайте в формате UNC (\\server\share), а не через подключённые диски — буквы дисков существуют только в сессии пользователя;
• каждую запись оборачивайте в Попытка...Исключение с записью ошибки в журнал регистрации.

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

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

Файл = Новый Файл(ПутьКФайлу);
Если Не Файл.Существует() Или Файл.Размер() = 0 Тогда
ВызватьИсключение "Файл не был сохранён: " + ПутьКФайлу;
КонецЕсли;

Для XML и JSON дополнительно полезно сразу прочитать файл обратно соответствующим объектом чтения — это отловит обрыв записи и ошибки кодировки. Для Excel-файлов полноценная проверка сложнее; обычно ограничиваются контролем размера и тестовым открытием на эталонном примере.

Выбор подходящего способа

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

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