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

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

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

Создание структуры и определение колонок

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

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

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

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

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

💡

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

Метод добавления строки и присвоение значений

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

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

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

// Добавляем первую строку
Строка1 = Таблица.Добавить();
Строка1.Товар = "Монитор 24 дюйма";
Строка1.Колво = 5;
Строка1.Сумма = 75000;

// Добавляем вторую строку с вычислением
Строка2 = Таблица.Добавить();
Строка2.Товар = "Клавиатура механическая";
Строка2.Колво = 10;
// Вычисляем сумму динамически
Строка2.Сумма = Строка2.Колво * 2500;

💡

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

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

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

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

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

📌 Индекс 0 вставляет строку в самое начало таблицы.
📌 Индекс, равный количеству строк, добавляет запись в конец (аналог Добавить).
📌 При вставке все строки с индексом больше указанного сдвигаются на одну позицию вниз.

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

Массовая загрузка данных из массива

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

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

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

МассивДанных = Новый Массив;

Элемент1 = Новый Структура("Товар, Колво", "Мышь беспроводная", 20);
МассивДанных.Добавить(Элемент1);

Элемент2 = Новый Структура("Товар, Колво", "Коврик для мыши", 20);
МассивДанных.Добавить(Элемент2);

// Мгновенная загрузка всех данных
Таблица.Загрузить(МассивДанных);

Особенности метода Загрузить

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

Сравнение методов записи данных

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

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

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

☑️ Алгоритм выбора метода

Есть готовый массив данных? -> Использовать ЗагрузитьНужно вычислять значения в цикле? -> Использовать ДобавитьНужен специфический порядок строк? -> Добавить + Сортировать или ВставитьОбъем данных > 5000 строк? -> Избегать частой Вставки

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

Частые ошибки и оптимизация работы

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

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

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

⚠️ Внимание: Интерфейс и возможности объекта "Таблица Значений" могут незначительно отличаться в зависимости от версии платформы 1С:Предприятие (8.2, 8.3, 8.3.20+). Всегда сверяйте синтаксис методов в справочнике синтаксиса вашей конкретной версии платформы.

Вопросы и ответы (FAQ)

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

Для удаления строки используется метод Удалить(Индекс), где индекс — это номер строки, которую нужно убрать. Также существует метод Очистить(), который удаляет все строки сразу. Будьте осторожны при удалении внутри цикла перебора, так как индексы строк сместятся.

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

Да, это возможно. Используйте метод Сортировать(), передав ему имя колонки для сортировки. Например, Таблица.Сортировать("Сумма Убыв") отсортирует данные по убыванию суммы. Можно указывать несколько колонок через запятую.

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

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

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

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

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