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

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

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

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

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

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

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

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

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

Обратите внимание, что имена колонок задаются строковыми литералами. Регистр букв имеет значение при обращении к ним через точку, но при использовании метода Получить() регистр не важен.

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

Методы добавления строк: Добавить и Вставить

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

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

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

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

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

Заполнение реквизитов новой строки

После получения ссылки на новую строку, наступает этап наполнения её данными. Синтаксис 1С позволяет обращаться к колонкам как к свойствам объекта. Это делает код интуитивно понятным и легким для чтения.

Вы можете присваивать значения непосредственно при создании или заполнять строку поэтапно.

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

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

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

Массовая загрузка данных из внешних источников

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

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

Метод загрузки	Источник данных	Скорость работы	Сложность реализации
Добавить() в цикле	Произвольный код	Низкая	Низкая
ЗагрузитьКолонки()	Массив значений	Высокая	Средняя
Конструктор запроса	База данных	Очень высокая	Высокая
Чтение файла Excel	Внешний файл	Средняя	Высокая

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

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

Использование конструктора запросов для наполнения

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

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

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

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

Оптимизация запросов

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

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

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

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

• 🛡️ Проверяйте заполненность обязательных полей перед вызовом метода Добавить().
• 🛡️ Используйте функцию ПустаяСтрока() или сравнение с Неопределено для контроля ссылок.
• 🛡️ Логируйте ошибки в журнал регистрации, чтобы иметь возможность отследить причину сбоя загрузки.

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

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

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

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

Можно ли добавить колонку в уже заполненную таблицу?

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

В чем разница между ТаблицейЗначений и РегистромСведений?

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

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

Самый быстрый способ — использовать метод СкопироватьКолонки() для переноса структуры, а затем ЗагрузитьКолонки() или цикл для переноса данных. Также можно выгрузить первую таблицу в запрос и загрузить во вторую, но это менее эффективно для небольших объемов.

Почему возникает ошибка "Тип значения не соответствует типу колонки"?

Эта ошибка возникает, когда вы пытаетесь записать в колонку значение, которое нельзя преобразовать к declared типу. Например, запись строки "Абв" в колонку типа Число. Проверьте типы в описании колонок и значения переменных перед присваиванием.