При разработке отчетов и печатных форм в среде «1С:Предприятие» программисты часто сталкиваются с необходимостью динамического формирования табличных документов. Одним из наиболее мощных инструментов для этого является метод ВставитьОбласть. Однако при его использовании без явного указания всех параметров могут возникать неожиданные побочные эффекты. Один из самых частых вопросов на форумах разработчиков — почему при копировании области в новый, пустой табличный документ сверху образуется множество пустых строк? И почему их количество напрямую зависит от размера исходной области?
В этой статье мы подробно разберем механизм работы метода ВставитьОбласть, выясним физический смысл происходящих в платформе процессов и научимся правильно переносить данные без образования нежелательных пустых интервалов.
Рассмотрим классический пример кода, который часто пишут разработчики при попытке скопировать именованную область из одного табличного документа в другой:
ИмяЛиста = ЭлементыФормы.СписокЛистов.Значение;
ОбластьЯчеекЛиста = ТабличныйДокумент.Области.Найти(ИмяЛиста);
ТабДокЛиста = Новый ТабличныйДокумент;
ТабДокЛиста.ВставитьОбласть(ОбластьЯчеекЛиста,, ТипСмещенияТабличногоДокумента.ПоВертикали);
ТабДокЛиста.Показать();
На первый взгляд, логика кажется безупречной: мы создаем абсолютно чистый табличный документ ТабДокЛиста, берем готовую область ячеек ОбластьЯчеекЛиста и вставляем ее. В качестве типа смещения указываем сдвиг по вертикали. Однако при выводе документа на экран мы видим, что в самом начале таблицы появилось значительное количество пустых строк, сдвигающих полезный контент далеко вниз.
Давайте разберемся по шагам, почему платформа ведет себя именно так.
Для того чтобы понять логику платформы «1С:Предприятие», проанализируем поведение метода ВставитьОбласть, когда второй параметр — ОбластьПриемник — остается незаполненным.
Когда мы не передаем область-приемник, система не может угадать, куда именно мы хотим поместить данные. В этом случае включается встроенный механизм проекции координат. Платформа берет абсолютные координаты исходной области (номера строк и колонок в исходном документе) и «накладывает» их на новый документ-приемник в точности «один в один».
Проанализируем простую ситуацию:
ОбластьЯчеекЛиста в исходном табличном документе располагается, например, в диапазоне строк с 10 по 25.ВставитьОбласть в новый документ, оставив параметр приемника пустым.Ситуация становится еще более интересной, когда мы анализируем третий параметр метода — ТипСмещенияТабличногоДокумента. В нашем проблемном примере передан тип смещения ПоВертикали. Это вносит дополнительные коррективы в логику вставки:
По правилам платформы, если область-приемник не задана, а смещение установлено как ПоВертикали, система выполняет вставку не просто в спроецированные координаты, а в область, непосредственно следующую за спроецированной исходной областью (то есть ниже её).
Рассмотрим, как это работает на конкретных цифрах:
ПоВертикали платформа определяет «базовую» спроецированную область (строки 5–15), но из-за вертикального сдвига осуществляет вставку ниже этой области.Если бы мы использовали тип смещения БезСмещения (или оставили этот параметр по умолчанию), то вставка произошла бы ровно в спроецированные координаты (то есть в строки 5–15), и пустыми остались бы только первые 4 строки.
Для того чтобы избежать появления пустых строк и добиться корректного отображения данных с самого верха нового табличного документа, мы можем применить два основных правила.
Самый надежный и правильный способ — всегда явно указывать платформе, куда именно нужно поместить копируемые данные. Если нам нужно вставить область в самый верх нового табличного документа, мы должны передать во второй параметр левую верхнюю ячейку — R1C1 (или первую строку, первую колонку).
Платформа «1С:Предприятие» спроектирована таким образом, что если в качестве области-приемника передана одна ячейка, система автоматически расширит область вставки до размеров исходной копируемой области. Нам не нужно высчитывать ее высоту и ширину вручную.
Давайте модифицируем наш исходный код:
ИмяЛиста = ЭлементыФормы.СписокЛистов.Значение;
ОбластьЯчеекЛиста = ТабличныйДокумент.Области.Найти(ИмяЛиста);
ТабДокЛиста = Новый ТабличныйДокумент;
// Явно получаем область, указывающую на левый верхний угол нового документа
ОбластьПриемник = ТабДокЛиста.Область(1, 1);
// Передаем приемник во второй параметр метода ВставитьОбласть
ТабДокЛиста.ВставитьОбласть(ОбластьЯчеекЛиста, ОбластьПриемник, ТипСмещенияТабличногоДокумента.БезСмещения);
ТабДокЛиста.Показать();
В этом случае вставка начнется строго с первой строки и первой колонки нового документа, и никаких лишних пустых строк в начале файла не появится.
Смещение ячеек по вертикали или горизонтали требуется только тогда, когда мы работаем с уже заполненным табличным документом (например, раздвигаем строки внутри существующего отчета или макета, чтобы вставить туда новые данные). Если же мы переносим данные во вновь созданный пустой табличный документ, раздвигать в нем нечего.
Поэтому в таких сценариях следует использовать значение ТипСмещенияТабличногоДокумента.БезСмещения или просто опускать этот параметр, так как данное поведение является стандартным по умолчанию для платформы.
Посмотрим на пример лаконичного и правильного кода:
ИмяЛиста = ЭлементыФормы.СписокЛистов.Значение;
ОбластьЯчеекЛиста = ТабличныйДокумент.Области.Найти(ИмяЛиста);
ТабДокЛиста = Новый ТабличныйДокумент;
// Вставляем область в координаты (1,1) без лишних сдвигов
ТабДокЛиста.ВставитьОбласть(ОбластьЯчеекЛиста, ТабДокЛиста.Область(1, 1));
ТабДокЛиста.Показать();
Для предотвращения трудноуловимых ошибок при работе с табличными документами в 1С рекомендуется придерживаться следующих правил разработки:
Область(1, 1) гарантирует предсказуемый результат.ТипСмещенияТабличногоДокумента.ПоВертикали только при интерактивном или программном раздвижении заполненных таблиц. При заполнении пустых бланков используйте БезСмещения.Найти(), прежде чем передавать ее в метод вставки, чтобы избежать ошибок времени выполнения.Применяя эти несложные правила, вы навсегда избавитесь от проблемы появления пустых строк и сделаете свои отчеты аккуратными и профессиональными.