Выгрузка результатов запроса в таблицу 1С: от конструктора до кода

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

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

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

1. Выгрузка через конструктор запросов (без программирования)

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

Чтобы выгрузить запрос в таблицу через конструктор:

• 📌 Откройте нужный отчёт или обработку в режиме 1С:Предприятие (не конфигуратора!). Например, перейдите в Отчёты → Стандартные отчёты → Оборотно-сальдовая ведомость.
• 🔍 Нажмите кнопку Настройки (или Показать настройки), затем перейдите на вкладку Отбор и сортировка или Группировка, если нужно изменить структуру данных.
• 📊 После формирования отчёта нажмите правой кнопкой мыши на таблицу с результатами и выберите Выгрузить в Excel или Сохранить как.... Для выгрузки в табличный документ 1С используйте опцию Печать → Настроить табличный документ.
• 💾 Сохраните документ в формате .mxl (внутренний формат 1С) или экспортируйте в Excel/PDF через меню Файл.

Этот метод удобен для разовых задач, но имеет ограничения:

• ❌ Нет возможности программно изменить данные после выгрузки.
• ❌ Форматирование применяется только к текущему виду отчёта.
• ❌ Нельзя автоматизировать процесс (например, отправлять отчёт по расписанию).

2. Программная выгрузка: объект ТабличныйДокумент

Для гибкой настройки выгрузки используйте встроенный язык 1С. Этот метод позволяет:

• 🔄 Динамически изменять структуру таблицы (объединять ячейки, добавлять заголовки).
• 🎨 Применять условное форматирование (например, красить отрицательные значения в красный).
• 📤 Автоматически отправлять отчёты по email или сохранять в файл.

Пример кода для выгрузки результатов запроса в табличный документ:

// Создаём запрос
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Товары.Наименование КАК Товар,
|   СУММА(Документ.Количество) КАК Количество
|ИЗ
|   Документ.РеализацияТоваровУслуг КАК Документ
|       ВНУТРЕННЕЕ СОЕДИНЕНИЕ Справочник.Товары КАК Товары
|       ПО Документ.Товар = Товары.Ссылка
|ГДЕ
|   Документ.Дата МЕЖДУ &НачалоПериода И &КонецПериода
|СГРУППИРОВАТЬ ПО
|   Товары.Наименование";

// Устанавливаем параметры
Запрос.УстановитьПараметр("НачалоПериода", НачалоМесяца(ТекущаяДата()));
Запрос.УстановитьПараметр("КонецПериода", КонецМесяца(ТекущаяДата()));

// Выполняем запрос
РезультатЗапроса = Запрос.Выполнить();
Выборка = РезультатЗапроса.Выбрать();

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

// Формируем заголовки
ОбластьЗаголовков = Таблица.Область(1, 1, 1, 2);
ОбластьЗаголовков.Текст = "Отчёт по реализации товаров";
ОбластьЗаголовков.Шрифт = Новый Шрифт("Arial", 12, True);
ОбластьЗаголовков.ЦветФона = RGB(200, 200, 200);

// Выгружаем данные
НомерСтроки = 3; // Начинаем с 3-й строки (1-я - заголовок отчёта, 2-я - заголовки колонок)
Таблица.ВывестиСтроку("Товар|Количество");
While Выборка.Следующий() Do
Таблица.ВывестиСтроку(Выборка.Товар + "|" + Выборка.Количество);
НомерСтроки = НомерСтроки + 1;
EndDo;

// Применяем автоподбор ширины колонок
Таблица.АвтоПодборШириныКолонок();

// Отображаем результат
Таблица.Показать();

Ключевые моменты в коде:

• 📌 Таблица.Область() — позволяет форматировать диапазоны ячеек (например, для заголовков).
• 📌 ВывестиСтроку() — упрощённый метод вывода данных, автоматически разбивает строку по разделителю |.
• 📌 АвтоПодборШириныКолонок() — масштабирует колонки под содержимое.

Запрос.Текст =
"ВЫБРАТЬ
|   УРОВЕНЬ(ГруппыНоменклатуры.Ссылка) КАК Уровень,
|   ГруппыНоменклатуры.Наименование КАК Группа,
|   '' КАК Товар,
|   NULL КАК Количество
|ПОМЕСТИТЬ ВТ_Группы
|ИЗ
|   Справочник.ГруппыНоменклатуры КАК ГруппыНоменклатуры
|ГДЕ
|   НЕ ГруппыНоменклатуры.ПометкаУдаления
|
|ОБЪЕДИНИТЬ ВСЕ
|
|ВЫБРАТЬ
|   УРОВЕНЬ(Товары.Родитель) + 1 КАК Уровень,
|   '' КАК Группа,
|   Товары.Наименование КАК Товар,
|   СУММА(Документ.Количество) КАК Количество
|ИЗ
|   Документ.РеализацияТоваровУслуг КАК Документ
|       ВНУТРЕННЕЕ СОЕДИНЕНИЕ Справочник.Товары КАК Товары
|       ПО Документ.Товар = Товары.Ссылка
|ГДЕ
|   Документ.Дата МЕЖДУ &НачалоПериода И &КонецПериода
|СГРУППИРОВАТЬ ПО
|   Товары.Наименование, Товары.Родитель";

3. Работа с большими выборками: оптимизация и ошибки

При выгрузке больших объёмов данных (десятки тысяч строк) 1С может тормозить или выдавать ошибки типа "Недостаточно памяти". Чтобы избежать проблем:

⚠️ Внимание: Если запрос возвращает более 50 000 строк, используйте постраничную выгрузку или фильтруйте данные на уровне SQL. Выгрузка большого объёма в табличный документ может заблокировать интерфейс 1С на несколько минут.

Способы оптимизации:

• 🔄 Пагинация: Разбивайте запрос на части с помощью ПОМЕСТИТЬ и ИНДЕКСИРОВАТЬ ПО. Пример:

  ВЫБРАТЬ ПЕРВЫЕ 1000
  Товары.Наименование, Товары.Артикул
  ИЗ Справочник.Товары КАК Товары
  УПОРЯДОЧИТЬ ПО Наименование

• 🗑️ Временные таблицы: Для сложных отчётов сначала сохраните данные во временную таблицу, затем выгружайте её частями.
• 📉 Упрощение структуры: Уберите из выборки ненужные поля (например, Ссылка или ЭтоГруппа, если они не используются в отчёте).

Типичные ошибки и их решения:

4. Выгрузка с использованием внешних обработок

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

• 📅 Автоматически подставляет текущую дату в запрос.
• 📧 Отправляет результат на email в формате Excel.
• 🔄 Сохраняет историю отчётов в базе.

Как подключить внешнюю обработку:

1. Скачайте или создайте обработку в конфигураторе (файл с расширением .epf).
2. В режиме 1С:Предприятие перейдите в Файл → Открыть... и выберите файл обработки.
3. Заполните параметры (период, фильтры) и нажмите Сформировать.
4. Результат откроется в новом окне табличного документа.

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

Процедура КомандаСформировать(Команда)
// 1. Получаем данные через запрос (аналогично примеру выше)
РезультатЗапроса = ПолучитьДанные();

// 2. Создаём табличный документ
Таблица = Новый ТабличныйДокумент;
ЗаполнитьТаблицу(Таблица, РезультатЗапроса);

// 3. Экспортируем в Excel
ИмяФайла = КаталогВременныхФайлов() + "Отчёт_" + Формат(ТекущаяДата(), "ДФ=yyyyMMdd") + ".xlsx";
Таблица.Записать(ИмяФайла, ТипФайлаТабличногоДокумента.Excel);

// 4. Отправляем по email (опционально)
Если НЕ ПустаяСтрока(Параметры.ЭлектроннаяПочта) Тогда
Почта = Новый Почта;
Почта.АдресОтправителя = "reports@company.ru";
Почта.АдресПолучателя = Параметры.ЭлектроннаяПочта;
Почта.Тема = "Отчёт по реализации за " + Формат(ТекущаяДата(), "ДФ=dd.MM.yyyy");
Почта.Текст = "Во вложении отчёт в формате Excel.";
Почта.Вложения.Добавить(ИмяФайла);
Почта.Отправить();
КонецЕсли;

// 5. Показываем пользователю
Таблица.Показать();
КонецПроцедуры

⚠️ Внимание: При использовании внешних обработок проверьте права доступа в 1С. Пользователь должен иметь роль с правом Выполнение внешних отчётов и обработок, иначе обработка не откроется.

Создать новую обработку в конфигураторе|Добавить реквизиты для параметров (даты, фильтры)|Написать процедуру формирования запроса|Реализовать экспорт в Excel/PDF|Протестировать на тестовой базе-->

5. Форматирование табличного документа

Простой вывод данных в таблицу — только половина задачи. Чтобы отчёт был читабельным, нужно настроить:

• 🎨 Шрифты и цвета: Выделяйте заголовки жирным, используйте RGB для фонов (например, RGB(220, 230, 241) для чередующихся строк).
• 📏 Выравнивание: Числа — по правому краю, текст — по левому.
• 🔢 Условное форматирование: Подсвечивайте отрицательные значения или превышения лимитов.
• 📊 Итоги: Добавляйте строки с суммами по группам.

Пример кода для условного форматирования:

// Применяем стили к ячейкам с количеством
Для Каждого Строка Из Таблица.Область(3, 2, Таблица.ВысотаТаблицы(), 2) Цикл
Если Число(Строка.Текст) < 0 Тогда
Строка.ЦветТекста = RGB(255, 0, 0); // Красный
Строка.Шрифт = Новый Шрифт(, , Истина); // Жирный
КонецЕсли;
КонецЦикла;

// Добавляем строку с итогами
ИтоговаяСтрока = Таблица.ВысотаТаблицы() + 1;
Таблица.Область(ИтоговаяСтрока, 1, ИтоговаяСтрока, 1).Текст = "ИТОГО:";
Таблица.Область(ИтоговаяСтрока, 2, ИтоговаяСтрока, 2).Текст = СуммаКоличество;
Таблица.Область(ИтоговаяСтрока, 1, ИтоговаяСтрока, 2).Шрифт = Новый Шрифт(, 11, Истина);
Таблица.Область(ИтоговаяСтрока, 1, ИтоговаяСтрока, 2).ЦветФона = RGB(200, 200, 200);

Для сложных отчётов используйте объединение ячеек:

// Объединяем ячейки для заголовка
ЗаголовокОбласть = Таблица.Область(1, 1, 1, 3);
ЗаголовокОбласть.Объединить();
ЗаголовокОбласть.Текст = "Отчёт по продажам";
ЗаголовокОбласть.ГоризонтальноеПоложение = ГоризонтальноеПоложениеТекста.ПоЦентру;

6. Экспорт в Excel и другие форматы

Табличный документ 1С поддерживает экспорт в несколько форматов:

• 📖 PDF — для печати и архивного хранения.
• 📗 Excel (.xlsx) — для дальнейшей обработки.
• 📄 HTML — для веб-отчётов.
• 🖼️ Изображение (.png, .jpg) — для вставки в презентации.

Пример экспорта в Excel с настройками:

// Сохраняем в Excel с параметрами
ИмяФайла = "C:\Отчёты\Продажи_" + Формат(ТекущаяДата(), "ДФ=yyyyMMdd") + ".xlsx";
ПараметрыЭкспорта = Новый ПараметрыЭкспортаВExcel;
ПараметрыЭкспорта.ВыводитьЗаголовки = Истина;
ПараметрыЭкспорта.ТолькоВидимыеЛисты = Истина;

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

// Открываем файл автоматически
СистемнаяКоманда = "explorer /select," + ИмяФайла;
Выполнить(СистемнаяКоманда);

⚠️ Внимание: При экспорте в Excel проверьте кодировку и разделители. Если в данных есть запятые (например, в наименованиях товаров), используйте ПараметрыЭкспорта.РазделительСтолбцов = ""; и ПараметрыЭкспорта.РазделительСтрок = "";, чтобы избежать ошибок разбора.

Если вам нужно сохранить формулы в Excel (например, для расчёта процентов), используйте объект ExcelДокумент из библиотеки OneScript или Альт:Excel. Стандартный экспорт из табличного документа сохраняет только значения, без формул.

7. Автоматизация: выгрузка по расписанию

Для регулярной выгрузки отчётов (например, ежедневной отправки остатков на склад) настройте регламентные задания или используйте внешние сервисы типа 1С:EDT или 1С:Connect.

Пример создания регламентного задания в 1С:

1. Откройте Администрирование → Поддержка и обслуживание → Регламентные задания.
2. Создайте новое задание с типом Выполнение кода.
3. В поле Код вставьте процедуру формирования и отправки отчёта (аналогично примеру из раздела 4).
4. Настройте расписание (ежедневно в 8:00) и укажите пользователя, от имени которого будет выполняться задание.
5. Сохраните и запустите задание вручную для тестирования.

Для облачных решений (например, 1С:Fresh) используйте веб-сервисы или REST API. Пример выгрузки через HTTP-сервис:

// Отправляем отчёт на внешний сервер
HTTPСервис = Новый HTTPСервис("https://api.company.ru/reports");
Запрос = Новый HTTPЗапрос("/upload");

// Формируем данные в JSON
Данные = Новый Структура;
Данные.Вставить("date", ТекущаяДата());
Данные.Вставить("data", ПреобразоватьВJSON(РезультатЗапроса));

Запрос.УстановитьТекст(JSONЗаписать(Данные));
Ответ = HTTPСервис.ВыполнитьЗапрос(Запрос);

Если Ответ.КодСостояния <> 200 Тогда
Сообщить("Ошибка отправки: " + Ответ.Текст);
КонецЕсли;

8. Типичные ошибки и их решения

Даже опытные пользователи 1С сталкиваются с проблемами при выгрузке данных. Рассмотрим самые распространённые:

Если проблема не решена, проверьте:

• 🔍 Логи 1С: Включите отладку (Сервис → Параметры → Запуск 1С:Предприятия → Отладка) и посмотрите трассировку.
• 📋 Права доступа: У пользователя должны быть права на чтение данных и запись во временные файлы.
• 🔄 Версию платформы: В старых версиях 1С 8.2 некоторые методы табличного документа могут отсутствовать.

FAQ: Частые вопросы по выгрузке запросов в 1С

ВЫБРАТЬ
УРОВЕНЬ(Группы.Ссылка) КАК Уровень,
Группы.Наименование КАК Наименование
ИЗ
Справочник.ГруппыНоменклатуры КАК Группы