Как добавить строки из одной таблицы значений в другую 1С

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

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

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

Основы работы с объектом ТаблицаЗначений

Прежде чем приступать к объединению, важно понять внутреннее устройство объекта. ТаблицаЗначений состоит из двух основных частей: определения структуры (колонки) и самих данных (строки). Каждая строка представляет собой объект СтрокаТаблицыЗначений, который, в свою очередь, содержит значения полей, соответствующие типам колонок. Нельзя просто так взять и добавить строку из таблицы А в таблицу Б, если их структуры не идентичны или не совместимы.

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

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

Метод вертикального объединения через ВыгрузитьКолонки

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

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

⚠️ Внимание: Метод ЗагрузитьКолонки не проверяет типы данных "на лету" так строго, как добавление по одной строке, но если типы несовместимы на уровне метаданных, возникнет ошибка. Убедитесь, что структура целевой таблицы создана корректно перед загрузкой.

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

ТаблицаПриемник = Новый ТаблицаЗначений;
// Копируем структуру колонок из источника
ТаблицаПриемник.Колонки.Скопировать(ТаблицаИсточник.Колонки);

// Выгружаем все строки источника в массив
МассивСтрок = ТаблицаИсточник.ВыгрузитьКолонки();

// Загружаем массив в приемник (добавляет строки в конец)
ТаблицаПриемник.ЗагрузитьКолонки(МассивСтрок);

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

Добавление строк в цикле с проверкой условий

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

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

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

Для Каждого СтрокаИсточника Из ТаблицаИсточник Цикл

Если СтрокаИсточника.Количество > 0 Тогда

НоваяСтрока = ТаблицаПриемник.Добавить();
НоваяСтрока.Номенклатура = СтрокаИсточника.Номенклатура;
НоваяСтрока.Количество = СтрокаИсточника.Количество;
НоваяСтрока.Сумма = СтрокаИсточника.Сумма;

КонецЕсли;

КонецЦикла;

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

Оптимизация цикла

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

Обработка несовпадающих структур таблиц

Одной из самых частых проблем при объединении данных является несовпадение структур таблиц. Например, в одной таблице есть колонка "Артикул", а в другой её нет, или типы данных различаются (Число против Строка). Платформа 1С не позволит напрямую загрузить данные в таком случае. Вам придется явно указать, какие колонки мапить друг на друга.

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

Рассмотрим ситуацию, когда нужно добавить данные из узкой таблицы в широкую. В целевой таблице есть дополнительные аналитические поля. Мы должны создать эти колонки в приемнике перед загрузкой, чтобы избежать ошибок.

Имя колонки	Тип в Источнике	Тип в Приемнике	Действие
Номенклатура	СправочникСсылка	СправочникСсылка	Прямая загрузка
Количество	Число	Число	Прямая загрузка
Комментарий	(Отсутствует)	Строка	Оставить пустым
Валюта	Строка	СправочникСсылка	Требуется конвертация

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

⚠️ Внимание: При копировании колонок методом Колонки.Скопировать() убедитесь, что вы не копируете лишние служебные колонки, если они не нужны в новой таблице. Лишние поля увеличивают размер объекта в памяти.

Использование запросов для объединения данных

Хотя работа с ТаблицейЗначений на клиенте удобна, иногда эффективнее выполнить объединение еще на этапе получения данных, используя язык запросов 1С. Оператор ОБЪЕДИНИТЬ ВСЕ (UNION ALL) позволяет склеить результаты двух выборок прямо в запросе. Это снимает нагрузку с клиента и передает уже готовый, объединенный набор данных.

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

Пример синтаксиса запроса для объединения:

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|    Номенклатура КАК Номенклатура,
|    Количество КАК Количество
|ПОМЕСТИТЬ ВТ_Часть1
|ИЗ
|    РегистрНакопления.Остатки.КАК Остатки
|
|ОБЪЕДИНИТЬ ВСЕ
|
|ВЫБРАТЬ
|    Номенклатура,
|    Количество
|ИЗ
|    РегистрНакопления.Резервы.КАК Резервы";

Результат = Запрос.Выполнить();
ТаблицаЗначений = Результат.Выгрузить();

Использование ОБЪЕДИНИТЬ ВСЕ сохраняет дубликаты строк, если они есть в выборках. Если вам нужно уникальное множество, используйте просто ОБЪЕДИНИТЬ. Однако стоит помнить, что операция уникализации требует дополнительных ресурсов сервера баз данных. Для простых задач добавления строк из одной таблицы в другую на клиенте методы 1С часто оказываются гибче.

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

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

Другая частая проблема связана с областью видимости переменных. Если вы создаете таблицу внутри цикла или условия, убедитесь, что ссылка на неё не потеряется. Также стоит обратить внимание на блокировку данных. Хотя ТаблицаЗначений находится в памяти клиента, данные, из которых она сформирована, могут быть актуальны только на момент выборки.

• 🚫 Ошибка "Тип значения не соответствует типу колонки": Возникает при попытке записать Строку в колонку типа Число. Решение: используйте функцию Число() для преобразования или проверьте источник данных.
• 🚫 Ошибка "Количество значений не соответствует количеству колонок": Случается при использовании ЗагрузитьКолонки, когда массив данных имеет другую размерность, чем таблица. Решение: проверьте соответствие структур перед загрузкой.
• 🚫 Ошибка "Неверное имя колонки": Часто возникает из-за опечаток или различия в регистре (хотя в 1С имена обычно регистронезависимы, лучше соблюдать стиль). Решение: используйте автодополнение в редакторе кода.

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

⚠️ Внимание: Интерфейс и поведение некоторых методов могут незначительно отличаться в зависимости от версии платформы 1С:Предприятие. Если вы работаете со старыми конфигурациями (до 8.3), проверяйте документацию по конкретной версии платформы.

Часто задаваемые вопросы (FAQ)

Можно ли добавить строки, если в целевой таблице уже есть данные?

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

Что быстрее: цикл или ВыгрузитьКолонки?

Методы ВыгрузитьКолонки и ЗагрузитьКолонки работают значительно быстрее, так как оптимизированы на уровне платформы для пакетной обработки. Цикл Для каждого имеет накладные расходы на каждую итерацию.

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

Используйте метод ТаблицаПриемник.Колонки.Скопировать(ТаблицаИсточник.Колонки). Это создаст идентичные колонки в новой таблице, но сама таблица останется пустой.

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

Напрямую через ЗагрузитьКолонки — нет, количества должны совпадать. Однако вы можете выгрузить только нужные колонки из источника в массив, а затем загрузить их в приемник, указав соответствие имен колонок.