Как программно сохранить табличный документ в 1С

Табличный документ в 1С — объект типа «ТабличныйДокумент», который программа использует для печатных форм, отчётов и выгрузок. Сохранить его программно можно одним методом Записать(), указав имя файла и тип сохраняемого файла. Этого достаточно для выгрузки в MXL, PDF, Excel, HTML и ряд других форматов без участия пользователя.

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

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

Метод Записать: синтаксис и параметры

Метод Записать() объекта «ТабличныйДокумент» принимает до трёх параметров. Первый — полное имя файла с расширением. Второй — значение системного перечисления ТипФайлаТабличногоДокумента, определяющее формат. Третий, необязательный, — параметры записи (например, объект «ПараметрыЗаписиPDF» для настройки выгрузки в PDF).

Базовый пример выглядит так:

ТабДок = Новый ТабличныйДокумент;
// ... заполнение документа ...

ТабДок.Записать("C:\Выгрузки\Отчет.pdf", ТипФайлаТабличногоДокумента.PDF);

Если тип файла не указан, платформа попытается определить формат по расширению имени файла. Явное указание типа надёжнее: при опечатке в расширении или нестандартном имени файла неявное определение может дать неожиданный результат.

ТабДок.Записать(ИмяФайла, ТипФайлаТабличногоДокумента.PDF);

Доступные форматы и когда какой выбрать

Перечисление ТипФайлаТабличногоДокумента содержит заметно больше форматов, чем используется на практике. Реальный выбор обычно стоит между MXL, PDF и таблицами Excel.

Для PDF есть дополнительная настройка через объект «ПараметрыЗаписиPDF»: можно ограничить выгрузку диапазоном страниц, задать уровень сжатия. Для Excel стоит помнить, что XLS ограничен 65536 строками — при больших объёмах используйте XLSX.

Сохранение на клиенте и на сервере: в чём разница

Ключевой подводный камень — место выполнения кода. Если Записать() вызывается в клиентской процедуре, файл создаётся на компьютере пользователя, и путь C:\Отчеты означает диск его машины. Если код выполняется на сервере (директива &НаСервере, регламентное задание, фоновое задание), тот же путь указывает на диск сервера 1С — пользователь файл у себя не увидит.

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

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

Пошаговый пример: выгрузка отчёта в PDF

Полный цикл от формирования до готового файла удобно выстроить по шагам и выполнять их в проверенном порядке.

1. 1
   Создайте объект: ТабДок = Новый ТабличныйДокумент
2. 2
   Заполните документ: выведите макет, области, установите параметры печати
3. 3
   Убедитесь, что каталог назначения существует, при необходимости создайте его методом СоздатьКаталог()
4. 4
   Вызовите ТабДок.Записать(ИмяФайла, ТипФайлаТабличногоДокумента.PDF)
5. 5
   Проверьте результат: Файл = Новый Файл(ИмяФайла); Файл.Существует()

Пример серверной процедуры целиком:

&НаСервере
Процедура СохранитьОтчетВPDF(ИмяФайла)

ТабДок = Новый ТабличныйДокумент;
Макет = ПолучитьМакетОтчета(); // функция формирования
ТабДок.Вывести(Макет);

ТабДок.АвтоМасштаб = Истина;

ТабДок.Записать(ИмяФайла, ТипФайлаТабличногоДокумента.PDF);

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

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

Типичные ошибки и как их избежать

Большинство проблем при программном сохранении связано не с самим методом, а с окружением: путями, правами и контекстом выполнения.

Оборачивайте вызов Записать() в конструкцию Попытка ... Исключение ... КонецПопытки и записывайте текст ошибки в журнал регистрации через ЗаписьЖурналаРегистрации(). Для регламентных заданий это единственный способ узнать, что выгрузка не состоялась.

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

Альтернативы методу Записать

Если задача — передать документ пользователю, а не положить файл на диск, есть варианты без явного сохранения. Метод Показать() открывает документ в окне просмотра, откуда пользователь сохранит его сам. Для отправки по почте табличный документ можно сразу записать во временный файл и вложить в письмо через объект «ИнтернетПочтовоеСообщение».

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

FAQ