Создание табличного документа в 1С: полное руководство с примерами

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

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

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

Что такое табличный документ в 1С и зачем он нужен

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

Основные сценарии использования:

• 📄 Печатные формы документов (счета, накладные, акты)
• 📊 Отчёты (оборотно-сальдовые ведомости, аналитика продаж)
• 📋 Справочники и регистры (выгрузка данных для анализа)
• 📥 Импорт/экспорт данных (обмен с другими системами)

Важно понимать, что табличный документ — это не просто статическая таблица. Он может быть связан с данными базы через запросы или программный код, что позволяет автоматически заполнять его актуальной информацией. Например, при формировании отчёта о продажах за месяц система сама подтянет данные из регистров накопления, рассчитает итоги и оформит результат according to заданному макету.

Без табличных документов было бы невозможно:

• 🔄 Автоматически обновлять отчёты при изменении данных
• 🎨 Гибко настраивать оформление (цвета, шрифты, границы)
• 📎 Вставлять динамические графики и диаграммы
• 🖨️ Печатать документы с сохранением фирменного стиля компании

Способы создания табличного документа: от простого к сложному

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

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

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

1. Откройте конфигуратор 1С и перейдите в раздел Объекты → Табличные документы.
2. Нажмите Добавить и укажите имя нового документа (например, ОтчётПоПродажам).
3. В открывшемся окне конструктора настройте количество строк и столбцов, задайте ширину колонок.
4. Заполните ячейки статическим текстом или формулами (например, =СУММ(B2:B10)).

2. Программное создание в модуле

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

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

// Добавляем колонтитулы
Заголовок = ТабДок.Область(1, 1, 1, 3);
Заголовок.Текст = "Отчёт по продажам за месяц";
Заголовок.Шрифт.Размер = 14;
Заголовок.Шрифт.Жирный = Истина;

// Добавляем заголовки столбцов
ТабДок.ВывестиСтроку("Товар|Количество|Сумма");

// Пример заполнения данными (в реальности данные берутся из запроса)
ТабДок.ВывестиСтроку("Ноутбук|5|250 000");
ТабДок.ВывестиСтроку("Монитор|10|80 000");

ТабДок.Показать();

3. Использование системы компоновки данных (СКД)

Наиболее мощный инструмент для создания сложных отчётов. СКД позволяет:

• 🔍 Формировать запросы к базе прямо в конструкторе
• 📊 Строить диаграммы и сводные таблицы
• 🔄 Настраивать группировки и итоги автоматически
• 📄 Экспортировать результаты в Excel, PDF, HTML

Чтобы создать отчёт через СКД:

1. В конфигураторе выберите Объекты → Отчёты → Добавить.
2. Укажите, что отчёт будет использовать систему компоновки данных.
3. В конструкторе настройте источник данных (запрос), структуру отчёта и оформление.
4. Сохраните и запустите отчёт — система сгенерирует табличный документ автоматически.

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

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

Шаг 1. Создание макета табличного документа

1. Откройте конфигуратор и перейдите в Объекты → Табличные документы.
2. Нажмите Добавить и назовите новый документ ОстаткиТоваров.
3. В конструкторе макета добавьте 5 строк и 4 столбца (для заголовков и данных).
4. Объедините первую строку для заголовка отчёта: выделите ячейки A1:D1 и нажмите Объединить.
5. В объединённой ячейке введите текст "Остатки товаров на складе" и установите шрифт 14pt, жирный.

Шаг 2. Настройка заголовков столбцов

Во второй строке макета укажите названия колонок:

Шаг 3. Программное заполнение данными

В модуле объекта (или в обработке) добавьте следующий код для заполнения таблицы данными из базы:

Процедура ЗаполнитьТабличныйДокумент(ТабДок, ГруппаНоменклатуры = Неопределено)
// Очищаем документ
ТабДок.Очистить();

// Запрос к базе для получения остатков
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Номенклатура.Наименование КАК Номенклатура,
|   Номенклатура.Артикул КАК Артикул,
|   ОстаткиТоваровОстатки.КоличествоОстаток КАК Количество,
|   ОстаткиТоваровОстатки.СуммаОстаток КАК Стоимость
|ИЗ
|   РегистрНакопления.ОстаткиТоваров.Остатки КАК ОстаткиТоваровОстатки
|       ЛЕВОЕ СОЕДИНЕНИЕ Справочник.Номенклатура КАК Номенклатура
|       ПО ОстаткиТоваровОстатки.Номенклатура = Номенклатура.Ссылка
|ГДЕ
|   НЕ Номенклатура.ПометкаУдаления
|   " + (?ГруппаНоменклатуры <> Неопределено THEN "И Номенклатура.Родитель = &Группа" ИНАЧЕ "") + "
|УПОРЯДОЧИТЬ ПО
|   Номенклатура.Наименование";

Если ГруппаНоменклатуры <> Неопределено Тогда
Запрос.УстановитьПараметр("Группа", ГруппаНоменклатуры);
КонецЕсли;

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

// Выводим заголовки
ТабДок.ВывестиСтроку("Номенклатура|Артикул|Количество|Стоимость");

// Выводим данные
Пока Выборка.Следующий() Цикл
ТабДок.ВывестиСтроку(
Выборка.Номенклатура + "|" +
Выборка.Артикул + "|" +
Формат(Выборка.Количество, "ЧГ=0") + "|" +
Формат(Выборка.Стоимость, "ЧДЦ=2; ЧРД=.; ЧН=Нет")
);
КонецЦикла;

// Форматируем столбцы с числами
ТабДок.Колонка(3).Число.Формат = "ЧГ=0";
ТабДок.Колонка(4).Число.Формат = "ЧДЦ=2; ЧРД=.";
КонецПроцедуры

Шаг 4. Добавление итогов и оформления

Чтобы автоматически рассчитывать итоги по столбцам и выделять отрицательные остатки красным, дополните код:

// После цикла вывода данных добавляем итоги
ТабДок.ВывестиСтроку("ИТОГО||" +
Формат(ТабДок.Итог(3), "ЧГ=0") + "|" +
Формат(ТабДок.Итог(4), "ЧДЦ=2; ЧРД=.")
);

// Условное оформление для отрицательных остатков
ОбластьДанных = ТабДок.Область(3, 3, ТабДок.ВысотаТаблицы, 3);
ОбластьДанных.УсловноеОформление.ДобавитьУсловие(
Новый УсловиеФорматирования("Значение < 0", Новый ОформлениеЯчейки(ЦветТекста = ВебЦвет.Красный))
);

Сохранён макет с правильными названиями колонок|

Задан формат чисел для столбцов с количеством и стоимостью|

Добавлены итоги по числовым колонкам|

Настроено условное оформление для отрицательных значений|

Проверен вывод данных на разных наборах фильтров-->

Работа с областями и объединение ячеек

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

• 🎨 Применять оформление к нескольким ячейкам одновременно
• 📊 Группировать данные для расчёта промежуточных итогов
• 🔄 Копировать или перемещать блоки данных
• 🖼️ Вставлять изображения или графики в определённую зону

Как создать и использовать область:

1. Выделите нужный диапазон ячеек (например, A1:D1 для заголовка).
2. Используйте метод Область(), чтобы получить объект области:
   Заголовок = ТабДок.Область(1, 1, 1, 4);
3. Примените оформление ко всей области:
   Заголовок.ЦветФона = ВебЦвет.Светло-Серый;

Объединение ячеек часто используется для создания многоуровневых заголовков или сложных шапок таблиц. Например, чтобы объединить ячейки A1 и B1:

ОбъединённаяОбласть = ТабДок.Область(1, 1, 1, 2);
ОбъединённаяОбласть.Объединить();
ОбъединённаяОбласть.Текст = "Общий заголовок";

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

• 📌 Фиксированные шапки: закрепите первую строку с заголовками, чтобы она оставалась видимой при прокрутке.
• 📈 Группировка данных: выделите цветом строки с одинаковыми категориями товаров.
• 💰 Промежуточные итоги: рассчитайте сумму по каждой группе перед выводом общей итоговой строки.
• 🖼️ Вставка логотипа: добавьте изображение в верхний левый угол отчёта.

Обратите внимание, что при работе с областями координаты ячеек указываются в формате Область(СтрокаНачало, СтолбецНачало, СтрокаКонец, СтолбецКонец). Нумерация начинается с 1, а не с 0, как в некоторых других языках программирования.

Экспорт и импорт табличных документов

Табличные документы в 1С поддерживают экспорт и импорт в различные форматы, что упрощает обмен данными с другими системами. Рассмотрим основные сценарии.

Экспорт в Excel

Для выгрузки таблицы в Excel используйте метод Записать() с указанием формата:

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

Дополнительные параметры экспорта:

• 📄 Сохранение форматирования: цвета, шрифты и границы ячеек будут перенесены в Excel.
• 📊 Многостраничные документы: если таблица не помещается на один лист, она будет разбита автоматически.
• 🔍 Фильтрация данных: в Excel можно будет использовать стандартные фильтры.

Экспорт в PDF

Для создания печатной формы в формате PDF:

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

Особенности экспорта в PDF:

• 🖼️ Сохраняется точное позиционирование элементов (как при печати).
• 🔒 Документ защищён от редактирования.
• 📏 Можно задать ориентацию страницы (книжная/альбомная) и поля.

Импорт из Excel

Чтобы загрузить данные из Excel в табличный документ:

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

Типичные ошибки при экспорте/импорте:

• ❌ Потеря форматирования: происходит, если не указан тип файла или используется устаревший формат .xls вместо .xlsx.
• ❌ Неправильная кодировка: при импорте из CSV может потребоваться явно указать кодировку (например, UTF-8).
• ❌ Обрезка данных: если ячейки в Excel имеют фиксированную ширину, длинные тексты могут обрезаться.

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

Оптимизация и ускорение работы с табличными документами

При работе с большими объёмами данных табличные документы могут тормозить. Вот ключевые приёмы оптимизации:

1. Отложенное форматирование

Если документ содержит тысячи строк, форматируйте его после вывода всех данных:

// 1. Выводим все данные БЕЗ форматирования
Пока Выборка.Следующий() Цикл
ТабДок.ВывестиСтроку(Выборка.Номенклатура + "|" + Выборка.Количество);
КонецЦикла;

// 2. Применяем оформление КО ВСЕМУ ДОКУМЕНТУ
ТабДок.Область().Шрифт.Имя = "Arial";
ТабДок.Область().Шрифт.Размер = 10;

2. Использование буфера

Для ускорения вывода больших таблиц используйте буферизацию:

ТабДок.НачатьБуферизацию();
// ... вывод данных ...
ТабДок.ЗакончитьБуферизацию();

3. Ограничение видимой области

Если пользователю не нужны все данные сразу, показывайте только часть таблицы:

ТабДок.ПоказатьСетку = Ложь; // Отключаем сетку для ускорения
ТабДок.Показать(1, 1, 100, 10); // Показываем первые 100 строк и 10 столбцов

4. Оптимизация запросов

Если данные для таблицы берутся из базы, убедитесь, что запрос оптимизирован:

• 🔍 Используйте индексируемые поля в условиях (ГДЕ).
• 📊 Избегайте ВЫБРАТЬ РАЗЛИЧНЫЕ и ГРУППИРОВКА ПО без необходимости.
• 🔄 Ограничивайте количество возвращаемых строк (ПЕРВЫЕ 1000).

5. Кэширование часто используемых документов

Если один и тот же отчёт формируется многократно, сохраняйте его в кэш:

Если Не Кэш.СодержитКлюч("ОстаткиТоваров_" + ТекущаяДата()) Тогда
ТабДок = СформироватьОтчётОбОстатках();
Кэш.Добавить("ОстаткиТоваров_" + ТекущаяДата(), ТабДок);
Иначе
ТабДок = Кэш.Получить("ОстаткиТоваров_" + ТекущаяДата());
КонецЕсли;

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

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

1. Пустые строки в начале документа

Проблема: При выводе данных первые строки остаются пустыми, хотя в коде они заполняются.

Причина: Скорее всего, вы используете метод ВывестиСтроку() с абсолютными координатами, но не учитываете, что нумерация строк начинается с 1, а не с 0.

Решение: Проверьте индексы строк в цикле вывода. Например:

НомерСтроки = 1;
Пока Выборка.Следующий() Цикл
ТабДок.ВывестиСтроку(НомерСтроки++, Выборка.Номенклатура);
КонецЦикла;

2. Неправильное форматирование чисел

Проблема: Числа отображаются без разделителей тысяч или с лишними знаками после запятой.

Причина: Не задан формат для колонки или ячейки.

Решение: Явно укажите формат при выводе:

ТабДок.Колонка(3).Число.Формат = "ЧДЦ=2; ЧРД=.; ЧГ=0"; // 2 знака, разделитель точка, без группировки

3. Исчезающие границы ячеек при экспорте

Проблема: В 1С границы видны, но после экспорта в Excel пропадают.

Причина: Границы настроены только для отдельных ячеек, а не для всей области.

Решение: Применяйте оформление ко всей колонке или строке:

ТабДок.Область(1, 3, ТабДок.ВысотаТаблицы, 3).ГраницаВнешняя = Истина;

4. Медленная печать больших документов

Проблема: При печати таблицы с тысячами строк 1С "зависает".

Причина: Драйвер принтера рендерит всю таблицу перед печатью.

Решение: Разбейте документ на части или экспортируйте в PDF, а затем печатайте:

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

5. Ошибка "Недопустимый индекс области"

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

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

Решение: Проверяйте размеры таблицы перед работой с областями:

Если ТабДок.ВысотаТаблицы() > 0 Тогда
Область = ТабДок.Область(1, 1, ТабДок.ВысотаТаблицы(), 4);
КонецЕсли;

Продвинутые приёмы: графики, картинки и интерактивность

Табличные документы в 1С поддерживают не только текст и числа, но и графические элементы. Рассмотрим, как добавить в отчёт диаграммы, изображения и даже интерактивные кнопки.

1. Вставка графиков и диаграмм

Чтобы добавить диаграмму на основе данных таблицы:

// Создаём диаграмму
Диаграмма = ТабДок.Диаграммы.Добавить(ТипДиаграммы.Гистограмма);
Диаграмма.ОбластьДанных = ТабДок.Область(2, 1, ТабДок.ВысотаТаблицы(), 3); // Данные для графика
Диаграмма.ОбластьРазмещения = ТабДок.Область(ТабДок.ВысотаТаблицы()+2, 1, ТабДок.ВысотаТаблицы()+12, 4); // Где разместить график

// Настраиваем оформление
Диаграмма.ЦветФона = ВебЦвет.Светло-Серый;
Диаграмма.Заголовок = "Динамика продаж по месяцам";

2. Добавление изображений

Чтобы вставить логотип компании или фотографию товара:

Картинка = Новый Картинка("C:\Logo.png");
ТабДок.Картинки.Добавить(Картинка, 1, 1, 3, 3); // Размещаем в области A1:C3

3. Интерактивные элементы

С версии 1С:Предприятие 8.3.14 в табличных документах поддерживаются гиперссылки и кнопки. Пример добавления ссылки на сайт: