Как объединить 2 табличных документа 1С: методы и примеры кода

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

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

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

Подготовка объектов и базовые принципы

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

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

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

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

Алгоритм слияния через копирование областей

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

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

• 📂 Создайте новый объект ТабличныйДокумент для результата.
• 📋 Получите список областей из первого документа-источника.
• 🔄 Выведите каждую область в новый документ последовательно.
• 📄 Повторите процедуру для второго документа-источника.

Критическим моментом является управление курсором или позицией вставки. По умолчанию, при выводе секций, 1С добавляет данные снизу текущего содержимого. Если вам нужно вставить данные в конкретную ячейку, например, для создания сложной сетки, потребуется использовать метод Вывести с указанием координат. Но для линейного объединения отчетов стандартное поведение вполне подходит.

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

Работа с данными через буфер обмена и временные хранилища

Альтернативный подход, который иногда используется при работе с большими объемами данных или при необходимости преобразования информации на лету, involves использование буфера обмена или временных хранилищ. Этот метод менее эффективен по скорости, но позволяет легко модифицировать данные между этапами копирования.

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

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

Более профессиональный вариант — использование объекта ХранилищеЗначения. Вы можете сохранить табличный документ во временное хранилище, получить его ссылку, а затем восстановить в другом контексте. Это особенно полезно, если процесс объединения разнесен во времени или выполняется разными потоками. Данные сохраняются в бинарном виде и занимают меньше ресурсов памяти при передаче между модулями.

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

Ограничения временных хранилищ

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

Программная реализация на языке 1С

Рассмотрим конкретный пример кода, который реализует объединение двух табличных документов. Данный фрагмент кода демонстрирует создание нового документа и последовательный вывод областей из источников. Обратите внимание на обработку исключений и проверку типов данных.

В примере ниже мы предполагаем, что у нас уже есть два заполненных документа: Док1 и Док2. Мы создаем третий документ ИтоговыйДок и наполняем его.

Процедура ОбъединитьДокументы(Док1, Док2)

ИтоговыйДок = Новый ТабличныйДокумент;

// Копируем области из первого документа
Для Каждого Область Из Док1.ПолучитьОбласти() Цикл
ИтоговыйДок.ВывестиСекцию(Область.Имя, Область);
КонецЦикла;

// Добавляем разделительную строку (опционально)
// ИтоговыйДок.ВывестиСекцию("Разделитель");

// Копируем области из второго документа
Для Каждого Область Из Док2.ПолучитьОбласти() Цикл
ИтоговыйДок.ВывестиСекцию(Область.Имя, Область);
КонецЦикла;

Возврат ИтоговыйДок;

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

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

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

Обработка заголовков, подвалов и форматирования

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

Чтобы решить эту проблему, необходимо исключить область с именем "Заголовок" (или как она у вас названа в макете) из цикла копирования для второго документа. Вы можете добавить условие внутри цикла: если имя области равно "Заголовок", то пропускаем итерацию. Это позволит сохранить структуру данных, но убрать визуальный шум.

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

Элемент отчета	Действие для Док1	Действие для Док2	Результат
Заголовок	Копировать	Пропустить	Одна шапка в начале
Основная часть	Копировать	Копировать	Сплошной список данных
Итоги	Копировать	Копировать	Промежуточные итоги сохраняются
Подвал	Пропустить	Копировать	Одна подпись в конце

Также стоит обратить внимание на ширину колонок. Если в первом документе ширина колонки "Номенклатура" составляет 30 символов, а во втором — 15, то при объединении вторая часть отчета может "поехать". Рекомендуется перед слиянием привести ширину колонок второго документа к значениям первого. Это делается через свойство ШиринаКолонок или копирование настроек страницы.

⚠️ Внимание: При копировании областей с объединенными ячейками (Merge Cells) убедитесь, что сетка колонок совпадает. Иначе может возникнуть ошибка "Нельзя объединить ячейки" или визуальное смещение данных.

Оптимизация производительности при больших объемах

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

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

Если же вы вынуждены работать именно с готовыми табличными документами (например, они пришли из внешних источников в виде файлов .mxl), старайтесь минимизировать количество обращений к свойствам ячеек внутри циклов. Кэшируйте объекты областей, если используете их многократно. Также полезно отключать автосуммирование и пересчет формул на время процедуры слияния, если такие функции задействованы в макете.

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

Частые ошибки и способы их устранения

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

Еще одна распространенная ошибка — потеря форматирования числовых полей. При копировании из одного документа в другой иногда сбрасывается формат строки (например, вместо "Число" становится "Строка"). Чтобы этого избежать, используйте метод Копировать для всего документа целиком, если это возможно, или явно задавайте формат ячеек после вставки данных.

Также стоит помнить о совместимости версий. Файлы табличных документов, созданные в старых версиях платформы, могут некорректно открываться или объединяться в новых релизах, особенно если использовались устаревшие типы шрифтов или методы печати. Всегда тестируйте итоговый отчет на целевой версии платформы.

Можно ли объединить документы с разной шириной колонок?

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

Как добавить сквозную нумерацию строк при объединении?

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

Что делать, если документы находятся в разных информационных базах?

Вам потребуется использовать механизмы обмена данными, например, выгрузку в файл .mxl или XML из первой базы, чтение этого файла во второй базе в объект ТабличныйДокумент, и только затем выполнять процедуру объединения. Прямое обращение к объектам другой базы невозможно без настройки COM-соединения или веб-сервисов.

Влияет ли объединение на время печати отчета?

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