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

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

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

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

1. Базовый метод: использование метода ВставитьТабличныйДокумент()

Самый простой и очевидный способ вставить один табличный документ в другой — воспользоваться встроенным методом ВставитьТабличныйДокумент(). Он доступен для объекта ТабличныйДокумент и позволяет разместить содержимое одного документа в указанной области другого. Основные параметры метода:

📍 Область — координаты ячейки, начиная с которой будет вставлен документ (например, Область(1, 1, 10, 10)).
📄 Источник — объект табличного документа, который нужно вставить.
🔄 ПараметрыВставки — дополнительные настройки (например, ПараметрыВставкиТабличногоДокумента.ЗаменятьСтили).

Пример кода:

// Создаем основной табличный документ ОсновнойДокумент = Новый ТабличныйДокумент; // Создаем вложенный документ с данными ВложенныйДокумент = Новый ТабличныйДокумент; ВложенныйДокумент.ВывестиСтроку("Заголовок вложенного документа"); ВложенныйДокумент.ВывестиСтроку("Строка 1 | Строка 2"); // Вставляем вложенный документ в основной, начиная с ячейки (3, 1) ОбластьВставки = ОсновнойДокумент.Область(3, 1, 10, 5);

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

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

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

Для динамического определения размеров области можно использовать следующий код:

Габариты = ВложенныйДокумент.ПолучитьГабариты(); ОбластьВставки = ОсновнойДокумент.Область( 3, 1, // Начальная строка и колонка 3 + Габариты.Высота - 1, // Конечная строка 1 + Габариты.Ширина - 1 // Конечная колонка

);

💡

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

2. Продвинутая техника: динамическое создание областей

Когда требуется вставить несколько табличных документов в разные части основного (например, для создания многоуровневых отчетов), удобнее работать с динамическими областями. Этот подход позволяет гибко управлять позиционированием и избегать наложения данных.

Алгоритм действий:

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

Пример реализации для трех вложенных документов:

// Массив с данными для вставки (имя документа, начальная строка, отступ) ДанныеДляВставки = Новый Массив; ДанныеДляВставки.Добавить(Новый Структура("Документ,Строка,Отступ", ВложенныйДок1, 2, 1)); ДанныеДляВставки.Добавить(Новый Структура("Документ,Строка,Отступ", ВложенныйДок2, 15, 2)); ДанныеДляВставки.Добавить(Новый Структура("Документ,Строка,Отступ", ВложенныйДок3, 30, 1)); ТекущаяСтрока = 1; Для Каждого Элемент Из ДанныеДляВставки Цикл Габариты = Элемент.Документ.ПолучитьГабариты(); Область = ОсновнойДокумент.Область( Элемент.Строка + ТекущаяСтрока, 1, Элемент.Строка + ТекущаяСтрока + Габариты.Высота - 1, Габариты.Ширина ); ОсновнойДокумент.ВставитьТабличныйДокумент(Область, Элемент.Документ); ТекущаяСтрока = ТекущаяСтрока + Габариты.Высота + Элемент.Отступ;

КонецЦикла;

Преимущества этого метода:

🎯 Точное контроль над позиционированием каждого документа.
🔄 Автоматическая подстройка под изменение размеров вложенных документов.
📊 Возможность добавления разделителей между блоками (например, пустых строк).

⚠️ Внимание: При работе с большим количеством вложенных документов (10+) этот метод может замедлить формирование отчета. В таких случаях рассмотрите возможность использования Объединить() для предварительного слияния документов.

Определите порядок следования вложенных документов|Рассчитайте минимальные отступы между блоками|Проверьте габариты каждого документа|Создайте резервные области для неожиданного увеличения данных|Тестируйте вывод на реальных данных, а не на тестовых наборах-->

3. Работа с объединенными ячейками и ручным форматированием

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

Алгоритм ручного копирования:

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

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

ВложенныйДок = Новый ТабличныйДокумент;
// ... заполнение вложенного документа

ОсновнойДок = Новый ТабличныйДокумент;
// Задаем область для вставки (начиная с (5,2))
НачальнаяСтрока = 5;
НачальнаяКолонка = 2;

// Копируем данные
Для СчСтр = 1 По ВложенныйДок.ВысотаТаблицы() Цикл
Для СчКол = 1 По ВложенныйДок.ШиринаТаблицы() Цикл
Значение = ВложенныйДок.ПолучитьТекст(СчСтр, СчКол);
Формат = ВложенныйДок.ПолучитьФормат(СчСтр, СчКол);
ОсновнойДок.УстановитьТекст(НачальнаяСтрока + СчСтр - 1, НачальнаяКолонка + СчКол - 1, Значение);
ОсновнойДок.УстановитьФормат(НачальнаяСтрока + СчСтр - 1, НачальнаяКолонка + СчКол - 1, Формат);
КонецЦикла;
КонецЦикла;

Этот метод требует больше кода, но дает полный контроль над результатом. Он особенно полезен когда:

🎨 Нужно сохранить специфическое форматирование (цвета, шрифты, границы).
🔗 Требуется объединить ячейки основного и вложенного документов.
📏 Необходимо точно контролировать ширину колонок.

Для ускорения процесса можно создать универсальную процедуру копирования:

Процедура СкопироватьОбласть(Источник, Приемник, СтрокаНачало, КолонкаНачало) Для СчСтр = 1 По Источник.ВысотаТаблицы() Цикл Для СчКол = 1 По Источник.ШиринаТаблицы() Цикл Приемник.УстановитьТекст( СтрокаНачало + СчСтр - 1, КолонкаНачало + СчКол - 1, Источник.ПолучитьТекст(СчСтр, СчКол) ); Приемник.УстановитьФормат( СтрокаНачало + СчСтр - 1, КолонкаНачало + СчКол - 1, Источник.ПолучитьФормат(СчСтр, СчКол) ); КонецЦикла; КонецЦикла;

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

Как копировать объединенные ячейки?

При копировании объединенных ячеек необходимо дополнительно вызывать метод Объединить() для целевой области. Например:

Если Источник.ОбъединениеЯчеек(СчСтр, СчКол) Тогда Приемник.Объединить( СтрокаНачало + СчСтр - 1, КолонкаНачало + СчКол - 1, СтрокаНачало + СчСтр - 1 + Источник.ВысотаОбъединения(СчСтр, СчКол) - 1, КолонкаНачало + СчКол - 1 + Источник.ШиринаОбъединения(СчСтр, СчКол) - 1 );

КонецЕсли;

4. Использование макетов для сложных компоновок

Если вам нужно создавать сложные отчеты с фиксированной структурой (например, формы с логотипом, заголовками и несколькими вложенными таблицами), удобнее использовать макеты. Макет позволяет заранее определить структуру документа, а затем динамически заполнять его данными.

Преимущества подхода с макетами:

📐 Фиксированное позиционирование элементов (не зависит от данных).
🎨 Централизованное управление стилями.
🔄 Возможность повторного использования для разных отчетов.

Пример создания отчета с макетом:

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

Код для работы с макетом:

// Загружаем макет
Макет = Документы.МойОтчет.ПолучитьМакет("ОсновнойМакет");
ОсновнойДок = Новый ТабличныйДокумент;
ОсновнойДок.НачатьПечатьМакетом(Макет);

// Получаем область для первой вложенной таблицы
ОбластьТаблица1 = ОсновнойДок.ОбластьМакет("Таблица1");
ВложенныйДок1 = ПолучитьДанныеДляПервойТаблицы();
ОсновнойДок.ВставитьТабличныйДокумент(ОбластьТаблица1, ВложенныйДок1);

// Аналогично для второй таблицы
ОбластьТаблица2 = ОсновнойДок.ОбластьМакет("Таблица2");
ВложенныйДок2 = ПолучитьДанныеДляВторойТаблицы();
ОсновнойДок.ВставитьТабличныйДокумент(ОбластьТаблица2, ВложенныйДок2);

ОсновнойДок.ЗакончитьПечатьМакетом();

Для динамического изменения размеров областей в макете можно использовать параметры. Например, если высота вложенной таблицы может варьироваться:

// В макете область "Таблица1" имеет параметр "ВысотаТаблицы1" ПараметрыМакет = Новый Структура("ВысотаТаблицы1", ВложенныйДок1.ВысотаТаблицы());

ОсновнойДок.НачатьПечатьМакетом(Макет, ПараметрыМакет);

⚠️ Внимание: При изменении макета в конфигураторе все отчеты, его использующие, должны быть перепроверены. Добавление новых параметров может сломать существующую логику, если они не обработаны в коде.

5. Обработка событий и динамическое обновление

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

Типичные случаи динамического обновления:

🔄 Изменение фильтров в основной таблице → пересчет вложенных данных.
📥 Добавление новых строк → расширение области вложенного документа.
🖱️ Клик по строке основной таблицы → показ детализации во вложенной.

Пример реализации динамического обновления:

Процедура ПриИзмененииДанных(Элемент) // Получаем текущую строку, по которой кликнули ТекущаяСтрока = Элемент.ТекущаяСтрока; // Формируем вложенный документ на основе данных строки ВложенныйДок = ПолучитьДетализациюПоСтроке(ТекущаяСтрока); // Очищаем старую область (если нужно) ОсновнойДок.Очистить(ОбластьДетализации); // Вставляем новый документ ОсновнойДок.ВставитьТабличныйДокумент(ОбластьДетализации, ВложенныйДок); // Обновляем отображение ОсновнойДок.ОбновлениеОтображения();

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

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

📌 Кэшируйте данные вложенных документов, если они не меняются часто.
🔍 Используйте НачатьИзменение()/ЗакончитьИзменение() для пакетного обновления.
🚫 Избегайте полного пересчета макета при мелких изменениях.

Пример кэширования:

Перем КэшДетализации;

Процедура ПолучитьДетализациюПоСтроке(НомерСтроки)
Если КэшДетализации = Неопределено Тогда
КэшДетализации = Новый Соответствие;
КонецЕсли;

Если КэшДетализации.Содержит(НомерСтроки) Тогда
Возврат КэшДетализации[НомерСтроки];
Иначе
Док = СформироватьДетализацию(НомерСтроки); // Ваша логика формирования
КэшДетализации.Вставить(НомерСтроки, Док);
Возврат Док;
КонецЕсли;
КонецПроцедуры

💡

Для сложных отчетов с динамическим обновлением рекомендуется использовать механизм ПоместитьВТемп() для временного хранения табличных документов. Это снижает нагрузку на память при частом пересчете.

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

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

Ошибка	Причина	Решение
Данные вложенного документа обрезаются	Указана слишком маленькая область вставки	Используйте `ПолучитьГабариты()` для динамического расчета размеров
Искажение форматирования после вставки	Конфликт стилей основного и вложенного документов	Установите параметр `ЗаменятьСтили = Истина` или копируйте формат вручную
Медленное формирование отчета	Слишком много вложенных документов или большие объемы данных	Используйте кэширование, `Объединить()` или разбивайте отчет на части
Некорректное позиционирование при печати	Разница в разрешении экрана и принтера	Настройте параметры страницы или используйте макеты с привязкой к физическим размерам
Ошибка "Область не принадлежит документу"	Попытка вставить документ за пределами текущей области	Проверяйте границы области методом `ПрнадлежитДокументу()` перед вставкой

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

Если ВложенныйДок.ВысотаТаблицы() = 0 Тогда
ОсновнойДок.ВывестиСтроку("Нет данных для отображения");
Иначе
ОсновнойДок.ВставитьТабличныйДокумент(Область, ВложенныйДок);
КонецЕсли;

Еще одна частая проблема — несовпадение шрифтов между документами. Если в основном документе используется шрифт Arial 10pt, а во вложенном — Times New Roman 12pt, результат будет выглядеть неаккуратно. Решение:

// Приводим стили вложенного документа к стилям основного ОсновнойСтиль = ОсновнойДок.ПолучитьСтиль("Заголовок");

ВложенныйДок.УстановитьСтиль(ОсновнойСтиль);

Как отладить проблемы с позиционированием?

Включите отображение сетки в табличном документе (ОсновнойДок.Сетка = Истина) и временно добавьте цветную заливку областей вставки:

ОбластьВставки.Заливка(Цвет.Красный, 30); // Полупрозрачная красная заливка

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

Это поможет визуально оценить границы областей.

7. Альтернативные подходы для специфических задач

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

1. Экспорт во временный файл и импорт

Если нужно вставить документ из другой базы или внешнего источника:

// Сохраняем вложенный документ во временный файл
ИмяФайла = ПолучениеИмениВременногоФайла("mxl");
ВложенныйДок.Записать(ИмяФайла, ТипФайлаТабличногоДокумента.MXL);

// Загружаем в основной документ
ОсновнойДок.Прочитать(ИмяФайла);
УдалитьФайлы(ИмяФайла);

2. Использование HTML для сложного форматирования

Если требуется сохранение сложного форматирования (например, вложенные таблицы HTML), можно сконвертировать документ в HTML и вставить как текст:

HTMLТекст = ВложенныйДок.ПолучитьHTML();
ОсновнойДок.ВывестиHTML(HTMLТекст, 5, 1);

3. Разбиение на несколько документов

Для очень больших отчетов (1000+ строк) целесообразно разбивать вывод на несколько табличных документов и объединять их в один PDF:

// Создаем коллекцию документов
Документы = Новый Массив;
Документы.Добавить(ОсновнойДок1);
Документы.Добавить(ОсновнойДок2);

// Объединяем в PDF
Объединитель = Новый ОбъединительФайловPDF;
Для Каждого Док Из Документы Цикл
ИмяФайла = ПолучениеИмениВременногоФайла("pdf");
Док.Записать(ИмяФайла, ТипФайлаТабличногоДокумента.PDF);
Объединитель.ДобавитьФайл(ИмяФайла);
КонецЦикла;

ИтоговыйФайл = Объединитель.Объединить();
ИтоговыйФайл.Записать("C:\Отчеты\ИтоговыйОтчет.pdf");

4. Использование расширений для 1С

Для нестандартных задач (например, вставка диаграмм или интерактивных элементов) можно использовать расширения:

📊 1С:Диаграммы — для вставки графиков в табличные документы.
🖼️ OneScript.Drawing — для работы с изображениями и сложной графикой.
📑 PDF41C — для продвинутой работы с PDF-выводом.

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

FAQ: Частые вопросы по работе с вложенными табличными документами

Можно ли вставить табличный документ в ячейку таблицы значений?

Нет, табличный документ можно вставить только в другой табличный документ. Для таблицы значений можно сгенерировать HTML-представление табличного документа и поместить его в реквизит типа HTMLДокумент или вывести в отдельное поле формы.

Как сохранить форматирование при вставке, если в документах разные стили?

Используйте параметр ПараметрыВставкиТабличногоДокумента.ЗаменятьСтили = Ложь, чтобы сохранить оригинальное форматирование. Альтернативно, вручную копируйте стили из вложенного документа в основной с помощью методов ПолучитьСтиль() и УстановитьСтиль().

Почему при печати вложенные таблицы съезжают?

Это связано с различием в разрешении экрана и принтера. Решения:

Настройте параметры страницы (ОсновнойДок.ПараметрыСтраницы) с учетом полей.
Используйте макеты с привязкой к физическим размерам (сантиметры вместо пикселей).
Проверьте настройки масштабирования в драйвере принтера.

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

Для отображения в форме:

Поместите на форму элемент ПолеТабличногоДокумента.
В модуле формы загрузите документ: ЭлементыФормы.ПолеТабличногоДокумента1.Значение = ОсновнойДок;
Для вложенных документов используйте те же методы, что и для программной вставки.

Пример:

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)

ОсновнойДок = СформироватьОтчет();

ЭлементыФормы.ПолеТабличногоДокумента1.Значение = ОсновнойДок;

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

Можно ли редактировать вложенный документ после вставки?

Нет, после вставки методом ВставитьТабличныйДокумент() данные становятся частью основного документа. Для редактирования нужно:

Сохранить исходный вложенный документ в переменной.
Вносить изменения в оригинальном документе.
Повторно вставлять его в основной документ.

Альтернативно, можно работать напрямую с ячейками основного документа в области вставки.

Как вывести табличный документ в поле табличного документа 1С: подробная инструкция с примерами