1С запросы как документ: методы преобразования, примеры и нюансы

Работа с запросами в 1С:Предприятие — неотъемлемая часть аналитики, отчетности и интеграции систем. Однако часто возникает задача не просто получить данные через запрос, а выразить их в виде документа — будь то печатная форма, файл для обмена или структурированный отчет. Без правильного подхода это превращается в рутинную работу с копированием данных в Excel или ручным формированием PDF.

В этой статье мы разберем 4 ключевых метода преобразования запросов 1С в документы: от стандартных механизмов платформы до программных решений с использованием внешних компонент и BI-инструментов. Вы узнаете, как автоматизировать процесс, избежать ошибок при экспорте больших объемов данных и адаптировать вывод под требования бухгалтерии, логистики или клиентской отчетности. Особое внимание уделим нюансам работы с иерархическими данными (например, справочниками с подчиненными элементами) и динамическими отчетами, где структура документа зависит от параметров запроса.

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

1. Стандартные механизмы 1С: экспорт запроса в табличный документ

Самый простой способ выразить запрос как документ — использовать встроенные инструменты платформы 1С:Предприятие 8.3. Для этого подходит объект ТабличныйДокумент, который позволяет визуализировать результаты запроса в виде таблицы с возможностью дальнейшего сохранения в Excel, PDF или печати.

Основные шаги:

• 📌 Выполните запрос через Запрос.Выполнить и получите результат в виде РезультатЗапроса.
• 📊 Создайте табличный документ и заполните его данными из результата запроса, используя метод Вывести.
• 💾 Сохраните документ в нужном формате с помощью ТабличныйДокумент.Записать.

Пример кода для экспорта в Excel:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| Товары.Наименование КАК Товар,
| Товары.Артикул,
| Товары.Цена
|ИЗ
| Справочник.Товары КАК Товары";

Результат = Запрос.Выполнить;
Таблица = Результат.Выгрузить;

ТабличныйДокумент = Новый ТабличныйДокумент;
ТабличныйДокумент.Вывести(Таблица);

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

⚠️ Внимание: При экспорте больших таблиц (свыше 10 000 строк) стандартный механизм может тормозить. В этом случае рекомендуется использовать пакетную обработку или разбивать данные на части.

2. Преобразование запроса в печатную форму документа 1С

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

1. Сформировать макет документа в конфигураторе (раздел Общие → Макеты).
2. Привязать данные запроса к областям макета с помощью метода Заполнить.
3. Вывести документ на печать или сохранить в PDF.

Пример для печатной формы счета:

Макет = Документы.Счет.ПолучитьМакет("ПечатнаяФорма");
ТаблицаДокумента = Макет.ПолучитьОбласть("ТаблицаТоваров");

// Заполняем шапку документа
Макет.Параметры.Заполнить(ДанныеЗапроса.Шапка);

// Заполняем табличную часть
Для Каждого Строка Из ДанныеЗапроса.Таблица Цикл
НоваяСтрока = ТаблицаДокумента.Добавить;
НоваяСтрока.Товар = Строка.Товар;
НоваяСтрока.Количество = Строка.Количество;
КонецЦикла;

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

Для сложных документов (например, с несколькими табличными частями или динамическими блоками) удобно использовать внешние обработки, такие как "Универсальный отчет" или "Библиотека стандартных подсистем" (БСП). Они позволяют гибко настраивать вывод данных без глубокого программирования.

3. Экспорт запроса в XML/JSON для интеграции с внешними системами

Когда требуется передать данные запроса в другую систему (например, CRM, ERP или BI-платформу), удобнее использовать форматы XML или JSON. В 1С для этого предусмотрены методы ЗаписатьXML и ЗаписатьJSON.

Пример экспорта в JSON:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| Клиенты.Наименование КАК Имя,
| Клиенты.ИНН,
| Клиенты.Адрес
|ИЗ
| Справочник.Клиенты КАК Клиенты";

Результат = Запрос.Выполнить;
Таблица = Результат.Выгрузить;

ЗаписьJSON = Новый ЗаписьJSON;
ЗаписьJSON.УстановитьСтроку;
ЗаписьJSON.ЗаписатьНачалоОбъекта;
ЗаписьJSON.ЗаписатьКлюч("Клиенты");
ЗаписьJSON.ЗаписатьНачалоМассива;

Для Каждого Строка Из Таблица Цикл
ЗаписьJSON.ЗаписатьНачалоОбъекта;
ЗаписьJSON.ЗаписатьКлюч("Имя");
ЗаписьJSON.ЗаписатьЗначение(Строка.Имя);
ЗаписьJSON.ЗаписатьКлюч("ИНН");
ЗаписьJSON.ЗаписатьЗначение(Строка.ИНН);
ЗаписьJSON.ЗаписатьКонецОбъекта;
КонецЦикла;

ЗаписьJSON.ЗаписатьКонецМассива;
ЗаписьJSON.ЗаписатьКонецОбъекта;
JSONСтрока = ЗаписьJSON.Закрыть;

JSONСтрока.Записать("C:\Обмен\Клиенты.json");

Для XML логика аналогична, но используется класс ЗаписьXML. Главное отличие — необходимость явно указывать пространства имен и атрибуты, если они требуются для интеграции.

⚠️ Внимание: При обмене данными через JSON/XML убедитесь, что кодировка файла совпадает с ожидаемой внешней системой (обычно UTF-8). В противном случае возможны ошибки чтения символов (например, кириллицы).

4. Использование внешних компонент для продвинутого экспорта

Для задач, где стандартные механизмы 1С не справляются (например, экспорт в PDF с сложным форматированием или генерация Word-документов), приходят на помощь внешние компоненты. Наиболее популярные:

• 📄 1C:Предприятие + Microsoft Word — через OLE или COM-объекты.
• 📑 FastReport — для создания сложных отчетов с графиками и диаграммами.
• 📈 OneScript.PDF — библиотека для генерации PDF из 1С.

Word = Новый COMОбъект("Word.Application");
Word.Visible = Истина;
Документ = Word.Documents.Add;

// Добавляем заголовок
Абзац = Документ.Paragraphs.Add;
Абзац.Range.Text ="Отчет по продажам за" + ТекущаяДата;
Абзац.Range.Font.Bold = Истина;
Абзац.Range.Font.Size = 14;

// Добавляем таблицу с данными запроса
Таблица = Документ.Tables.Add(Документ.Range, РезультатЗапроса.Выгрузить.Количество, 3);
Для Сч = 1 По РезультатЗапроса.Выгрузить.Количество Цикл
Таблица.Cell(Сч, 1).Range.Text = РезультатЗапроса[Сч-1].Товар;
Таблица.Cell(Сч, 2).Range.Text = РезультатЗапроса[Сч-1].Количество;
Таблица.Cell(Сч, 3).Range.Text = РезультатЗапроса[Сч-1].Сумма;
КонецЦикла;

Документ.SaveAs("C:\Отчеты\Продажи.docx");
Word.Quit;

Для FastReport потребуется установить компоненту и подключить её в конфигураторе. Преимущество этого решения — визуальный редактор отчетов, где можно drag-and-drop’ом создавать шаблоны, а затем заполнять их данными из запроса.

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| Категории.Ссылка КАК Ссылка,
| Категории.Наименование КАК Наименование,
| Категории.Родитель КАК Родитель
|ИЗ
| Справочник.КатегорииТоваров КАК Категории
|
|ОБЪЕДИНИТЬ ВСЕ
|
|ВЫБРАТЬ
| КатегорииРек.Ссылка КАК Ссылка,
| КатегорииРек.Наименование КАК Наименование,
| КатегорииРек.Родитель КАК Родитель
|ИЗ
| Справочник.КатегорииТоваров КАК КатегорииРек
|ГДЕ
| КатегорииРек.Родитель В (&СписокСсылок)";

СписокСсылок = Новый Массив;
СписокСсылок.Добавить(Категория.Родитель);
Запрос.УстановитьПараметр("СписокСсылок", СписокСсылок);

Результат = Запрос.Выполнить;

Шаг = 5000;
Смещение = 0;
Пока Истина Цикл
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ ПЕРВЫЕ" + Шаг +" СМЕЩЕНИЕ" + Смещение +"
| Документ.Заказы.Номер КАК Номер,
| Документ.Заказы.Дата,
| Документ.Заказы.Сумма
|ИЗ
| Документ.Заказы КАК Документ.Заказы";

Результат = Запрос.Выполнить;
Если Результат.Пустой Тогда
Прервать;
КонецЕсли;

// Экспорт текущей порции данных
ЭкспортироватьВExcel(Результат.Выгрузить,"Заказы_Часть" + (Смещение / Шаг + 1) +".xlsx");

Смещение = Смещение + Шаг;
КонецЦикла;

ТекстUTF8 = СтрШаблон("%1", Текст);
ТекстUTF8 = СтрЗаменить(ТекстUTF8,"",""); // Удаляем BOM
ЗаписьJSON.УстановитьКодировкуТекста(КодировкаТекста.UTF8);

Картинка = Новый Картинка(ДвоичныеДанныеИз1С);
Картинка.Записать("C:\Temp\photo.jpg");
ТабличныйДокумент.Рисунки.Добавить(Картинка, 10, 10, 100, 100);

Почта = Новый Почта;
Сообщение = Почта.СоздатьСообщение;
Сообщение.Адресат ="client@example.com";
Сообщение.Тема ="Отчет по продажам";
Сообщение.Текст ="Во вложении отчет.";
Сообщение.Вложения.Добавить("C:\Отчеты\Продажи.pdf");
Почта.Отправить(Сообщение);