Как добавить строку в таблицу значений 1С: Инструкция

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

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

Основы создания и инициализации объекта

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

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

Рассмотрим пример создания таблицы с предустановленными колонками. Здесь важно соблюдать синтаксис описания типов, особенно если используются составные типы данных.

ТЗ = Новый ТаблицаЗначений("Номенклатура, Сумма, Количество");
ТЗ.Колонки.Номенклатура.Тип = Новый ОписаниеТипов("СправочникСсылка.Номенклатура");
ТЗ.Колонки.Сумма.Тип = Новый ОписаниеТипов("Число", , Новый КвалификаторыЧисла(15, 2));

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

💡

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

Метод Add: стандартное добавление в конец

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

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

Обратите внимание, что метод возвращает объект СтрокаТаблицыЗначений. Это позволяет использовать цепочки вызовов или сразу присваивать значения полям через точку. Такой стиль кода считается хорошим тоном в разработке под 1С.

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

Если вы работаете с большими массивами данных, старайтесь минимизировать количество обращений к свойствам строки внутри циклов. Лучше заполнить локальные переменные, а затем одним блоком присвоить их новой строке таблицы.

☑️ Алгоритм добавления строки

Создать объект ТаблицаЗначенийПроверить типы колонокВызвать метод Добавить()Заполнить поля возвращенной строки

Выполнено: 0 / 4

Метод Insert: вставка строки по индексу

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

Индексация в 1С начинается с нуля. Это означает, что вставка по индексу 0 поместит запись в самое начало таблицы. Использование этого метода требует большей осторожности, так как сдвиг массива данных в памяти является более ресурсоемкой операцией, чем простое расширение.

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

ИндексВставки = 0;
Если ИндексВставки <= ТЗ.Количество() Тогда
Строка = ТЗ.Вставить(ИндексВставки);
Строка.Комментарий = "Приоритетная запись";
КонецЕсли;

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

Почему Insert медленнее Add?

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

Копирование строк и работа с данными

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

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

Изменение свойств объекта по ссылке в новой строке затронет и исходные данные, если они ссылаются на один и тот же экземпляр. Это поведение характерно для объектно-ориентированных языков и требует внимательности при работе со сложными структурами.

Рассмотрим таблицу, демонстрирующую влияние различных методов на позицию и содержание данных:

Метод	Позиция новой строки	Возвращаемое значение	Производительность
`Добавить()`	Конец таблицы	Ссылка на строку	Высокая
`Вставить(Индекс)`	По указанному индексу	Ссылка на строку	Средняя (зависит от индекса)
`Добавить(Строка)`	Конец таблицы	Ссылка на копию	Высокая
`ЗагрузитьКолонки()`	Массовое заполнение	Нет (void)	Максимальная

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

Обработка ошибок и валидация типов

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

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

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

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

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

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

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

КолСумма = ТЗ.Колонки["Сумма"];
Для Каждого Элемент Из МассивДанных Цикл
НоваяСтрока = ТЗ.Добавить();
НоваяСтрока[КолСумма] = Элемент.Сумма;
КонецЦикла;

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

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

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

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

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

Что произойдет, если тип данных в строке не совпадает с типом колонки?

Система попытается привести тип автоматически. Если приведение невозможно (например, строка "Текст" в числовую колонку), будет выброшено исключение ПреобразованиеЗначения.

Как удалить добавленную строку, если она больше не нужна?

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

💡

Для максимальной производительности при работе с большими объемами данных используйте массивы и метод ЗагрузитьКолонки вместо построчного добавления в цикле.

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