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

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

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

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

Что значит «склеить» табличные документы

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

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

Вертикальная склейка через метод Вывести()

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

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

Если второй документ нужно вывести не целиком, а частично, сначала получите из него область методом ПолучитьОбласть() с указанием диапазона строк, например Документ2.ПолучитьОбласть("R5:R20"). Так можно отрезать шапку второго отчёта, чтобы она не дублировалась.

При вертикальной склейке ширина колонок результата определяется первым выведенным фрагментом. Если у документов разное число колонок или разная ширина, вторая часть может отображаться искажённо. Выравнивайте ширину колонок заранее или задайте её явно через свойство ШиринаКолонки области.

Результат = Новый ТабличныйДокумент;
Результат.Вывести(Документ1);
ОбластьВторого = Документ2.ПолучитьОбласть("R5:R" + Документ2.ВысотаТаблицы);
Результат.Вывести(ОбластьВторого);

Горизонтальное присоединение колонок

Когда колонки второго документа должны стоять справа от первого, используется метод Присоединить(). Он добавляет область к правому краю текущего содержимого, начиная с первой строки.

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

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

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

Склейка через копирование областей и значений

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

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

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

Пошаговый порядок объединения двух документов

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

1. 1
   Сформируйте оба документа в переменные типа ТабличныйДокумент, не выводя их пользователю
2. 2
   Создайте итоговый документ: Результат = Новый ТабличныйДокумент
3. 3
   Выведите первый документ: Результат.Вывести(Документ1)
4. 4
   При необходимости отрежьте шапку второго: ПолучитьОбласть с диапазоном строк
5. 5
   Выведите вторую часть: Результат.Вывести(ОбластьВторого)
6. 6
   Перенастройте параметры печати итогового документа: ориентацию, масштаб, колонтитулы
7. 7
   Проверьте результат через Результат.Показать() или запись в файл

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

Если между частями нужен разрыв страницы, используйте метод ВывестиГоризонтальныйРазделительСтраниц() между вызовами Вывести(). Это гарантирует, что вторая часть начнётся с нового листа.

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

После склейки документ стоит проверить до отправки на печать или сохранения. Основные контрольные точки: высота итогового документа равна сумме высот частей, ширина колонок не «поплыла», объединённые ячейки на месте, расшифровка работает.

Частые ошибки при склейке связаны с невнимательностью к диапазонам и к состоянию объектов.

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

Альтернативы склейке табличных документов

Не всегда склейка готовых документов — оптимальное решение. Если оба отчёта строятся по данным одной информационной базы, часто проще объединить данные запросом (через ОБЪЕДИНИТЬ ВСЕ) и сформировать один документ из одного макета. Код становится короче, а результат предсказуемее.

Для отчётов на СКД вместо склейки используйте наборы данных-объединения или вывод нескольких отчётов в один через последовательные вызовы компоновщика с выводом в общий табличный документ. Это сохраняет расшифровку и настройки каждого отчёта.

Если итог нужен только как файл для передачи, допустимо сохранить оба документа в MXL или Excel и объединить их внешними средствами. Но для дальнейшей работы внутри 1С программная склейка областями остаётся основным инструментом.

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