Как программно добавить новую строку в Таблицу Значений 1С

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

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

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

Инициализация структуры и создание колонок

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

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

⚠️ Внимание: Попытка добавить строку с набором полей, отличным от объявленной структуры колонок, вызовет исключение. Убедитесь, что имена полей в коде совпадают с именами колонок регистр-независимо.

Рассмотрим пример создания простой таблицы для хранения списка товаров. Мы определим три ключевых поля: наименование, количество и цену. Это базовый набор, который часто используется в печатных формах и отчетах.

ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Товар", Строка(50));
ТЗ.Колонки.Добавить("Количество", Число(15, 3));
ТЗ.Колонки.Добавить("Цена", Число(15, 2));

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

Базовый метод добавления строки в конец таблицы

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

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

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

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

НоваяСтрока = ТЗ.Добавить;
НоваяСтрока.Товар ="Ноутбук";
НоваяСтрока.Количество = 10;
НоваяСтрока.Цена = 50000;

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

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

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

Этот метод принимает два аргумента: индекс позиции и (опционально) объект строки для копирования. Индексация в ТаблицеЗначений начинается с нуля. Если вы укажете индекс, равный текущему количеству строк, запись добавится в конец, что аналогично работе метода Добавить.

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

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

ИндексВставки = 5;
СтрокаДляВставки = ТЗ.Вставить(ИндексВставки);
СтрокаДляВставки.Товар ="Срочная позиция";

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

Нюансы индексации

Помните, что индекс 0 — это самая первая строка. Если в таблице 10 строк, допустимые индексы от 0 до 9 для доступа к существующим, и от 0 до 10 для вставки новых (10 — это вставка после последней).

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

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

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

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

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

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

Загрузка данных из массива или запроса

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

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

• 🚀 Пакетная загрузка работает быстрее, чем цикл с добавлением по одной строке.
• 🚀 Автоматическое создание колонок упрощает код при работе с динамическими данными.
• 🚀 Можно загружать данные с фильтрацией, используя параметры метода.

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

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

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

Выборка = Запрос.Выполнить.Выбрать;
Пока Выборка.Следующий Цикл
СтрокаТЗ = ТЗ.Добавить;
СтрокаТЗ.Заполнить(Выборка);
КонецЦикла;

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

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

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

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

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

Что делать, если имена колонок в источнике и таблице не совпадают?

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

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

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

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

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

Влияет ли добавление строк на производительность при большом объеме данных?

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

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

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