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

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

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

Ниже разобраны рабочие варианты кода, ограничения каждого метода и типичные ошибки, из-за которых копия получается пустой или падает с ошибкой типов.

Базовый способ: Добавить и ЗаполнитьЗначенияСвойств

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

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

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

Граница = ТЗ.Количество();
Для Инд = 0 По Граница - 1 Цикл
    СтрокаИсточник = ТЗ[Инд];
    НоваяСтрока = ТЗ.Добавить();
    ЗаполнитьЗначенияСвойств(НоваяСтрока, СтрокаИсточник);
КонецЦикла;

Копирование строки в конкретную позицию через Вставить

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

ИндексСтроки = ТЗ.Индекс(СтрокаИсточник);
НоваяСтрока = ТЗ.Вставить(ИндексСтроки + 1);
ЗаполнитьЗначенияСвойств(НоваяСтрока, СтрокаИсточник);

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

Копирование нескольких строк по условию

Часто нужно перенести не одну строку, а все строки, удовлетворяющие отбору. Для этого сначала найдите строки методом НайтиСтроки() с параметрами отбора, затем скопируйте их в цикле.

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

1. 1
   Сформируйте структуру отбора с нужными полями
2. 2
   Получите массив строк методом НайтиСтроки()
3. 3
   В цикле добавляйте строки в приёмник через Добавить()
4. 4
   Переносите значения через ЗаполнитьЗначенияСвойств()
5. 5
   Проверьте количество строк в приёмнике после цикла

Если нужно скопировать таблицу целиком, отдельные строки перебирать не обязательно: метод ТЗ.Скопировать() возвращает полную копию таблицы со всеми строками и колонками, а ТЗ.СкопироватьКолонки() — пустую таблицу с той же структурой, что удобно для подготовки приёмника.

Ограничения ЗаполнитьЗначенияСвойств и работа с разными структурами

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

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

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

Копирование строки табличной части документа

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

НоваяСтрока = Объект.Товары.Добавить();
ЗаполнитьЗначенияСвойств(НоваяСтрока, ТекущаяСтрока);

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

Проверка результата копирования

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

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

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