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

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

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

Все примеры кода приведены для актуальных версий платформы 1С:Предприятие 8.3 и проверены на совместимость с последними обновлениями. Если вы работаете со старшими релизами (8.2 или 8.1), некоторые методы могут требовать адаптации — об этом мы тоже упомянем в соответствующих разделах.

Что такое таблица значений и зачем она нужна

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

Основные преимущества таблиц значений:

🔹 Высокая скорость работы — все операции выполняются в оперативной памяти.
🔹 Гибкость — можно динамически добавлять/удалять колонки и строки.
🔹 Удобство обработки — встроенные методы для поиска, сортировки, фильтрации.
🔹 Интеграция с отчётами — таблицы значений часто используются как источники данных для СКД.

Типичные сценарии использования: 1) Промежуточные расчёты (например, формирование сводных данных перед записью в документ). 2) Обработка данных из внешних источников (Excel, JSON, XML) перед сохранением в базу. 3) Реализация сложной бизнес-логики, требующей манипуляций с наборами данных.

⚠️ Внимание: Таблицы значений не предназначены для хранения больших объёмов данных (свыше 10 000 строк). В таких случаях используйте временные таблицы базы данных или специализированные механизмы платформы.

Создание и инициализация таблицы значений

Создать таблицу значений в 1С можно несколькими способами. Самый простой — использовать конструктор Новый ТаблицаЗначений. Далее необходимо определить структуру колонок, их типы и, при необходимости, заполнить данными.

Пример базового создания:

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

Для ускорения работы с большими таблицами рекомендуется заранее резервировать память под ожидаемое количество строк:

ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Код", Новый ОписаниеТипов("Строка"));
ТЗ.Колонки.Добавить("Сумма", Новый ОписаниеТипов("Число"));
// Резервируем память под 1000 строк
ТЗ.РезервироватьСтроки(1000);

Альтернативный способ — создание таблицы на основе существующей (клонирование структуры):

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

Добавление, редактирование и удаление данных

После создания таблицы значения можно заполнять данными. Основные методы для работы со строками:

Метод	Описание	Пример
`Добавить()`	Добавляет новую строку в конец таблицы	`НоваяСтрока = ТЗ.Добавить(); НоваяСтрока.Наименование = "Товар 1";`
`Вставить()`	Вставляет строку в указанную позицию	`ТЗ.Вставить(0); // В начало`
`Удалить()`	Удаляет строку по индексу	`ТЗ.Удалить(2); // Удаляем третью строку`
`Очистить()`	Удаляет все строки, сохраняя колонки	`ТЗ.Очистить();`
`ЗагрузитьКолонку()`	Массовое заполнение колонки значениями из массива	`ТЗ.ЗагрузитьКолонку(МассивЗначений, "Цена");`

Пример комплексного заполнения таблицы:

// Добавляем 3 строки с данными
Для Сч = 1 По 3 Цикл
НоваяСтрока = ТЗ.Добавить();
НоваяСтрока.Наименование = "Товар " + Сч;
НоваяСтрока.Количество = Сч * 10;
НоваяСтрока.Цена = 100 * Сч;
НоваяСтрока.ДатаПоступления = ТекущаяДата() - Сч;
КонецЦикла;

// Изменяем значение в первой строке
ТЗ[0].Цена = 150.50;

// Удаляем вторую строку (индекс 1)
ТЗ.Удалить(1);

Для массового заполнения таблицы данными из запроса удобно использовать метод Загрузить():

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

☑️ Проверка перед массовым заполнением таблицы

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

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

Поиск и фильтрация данных в таблице значений

Одной из самых востребованных операций является поиск строк по определённым критериям. В 1С для этого предусмотрены несколько методов:

1. Метод НайтиСтроки() — возвращает массив строк, соответствующих условию:

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

2. Метод Найти() — возвращает индекс первой найденной строки или Неопределено:

ИндексСтроки = ТЗ.Найти(Новый Структура("Артикул", "АРТ001"));
Если ИндексСтроки <> Неопределено Тогда
Сообщить("Найдена строка с индексом: " + ИндексСтроки);
КонецЕсли;

3. Поиск с использованием Отбор — позволяет задавать сложные условия:

Отбор = Новый Структура;
Отбор.Вставить("ДатаПоступления", Новый УсловиеСравнения(ТекущаяДата() - 30, ВидСравнения.БольшеИлиРавно));
Отбор.Вставить("Количество", Новый УсловиеСравнения(50, ВидСравнения.Меньше));

НайденныеСтроки = ТЗ.НайтиСтроки(Отбор);

Для ускорения поиска в больших таблицах можно создать индекс по колонке:

ТЗ.Индексы.Добавить("ИндексПоНаименованию");
ТЗ.Индексы.ИндексПоНаименованию.Добавить("Наименование");

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

ТЗ.Индексы.Добавить("ИндексПоАртикулуИДате");

ТЗ.Индексы.ИндексПоАртикулуИДате.Добавить("Артикул", "ДатаПоступления");-->

Сортировка и группировка данных

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

// Сортировка по убыванию цены, затем по возрастанию наименования

ТЗ.Сортировать("Цена Убыв, Наименование Возр");

Для группировки данных по определённому признаку используется метод Свернуть(). Это аналог SQL-оператора GROUP BY:

// Группируем по колонке "Категория" и суммируем количество

ТЗ.Свернуть("Категория", "Количество", "СуммаКоличества");

Пример сложной группировки с несколькими агрегатными функциями:

ПравилаГруппировки = Новый Массив;
ПравилаГруппировки.Добавить(Новый ГруппировкаТаблицыЗначений("Категория"));
ПравилаГруппировки.Добавить(Новый АгрегатнаяФункцияТаблицыЗначений("Сумма(Цена)", "Цена"));
ПравилаГруппировки.Добавить(Новый АгрегатнаяФункцияТаблицыЗначений("Максимум(Количество)", "Количество"));

Результат = ТЗ.Свернуть(ПравилаГруппировки);

Для визуального отображения иерархических данных (например, в отчётах) можно использовать метод Итоги():

ТЗ.Итоги.Добавить("Категория", "Сумма", ТипИтоговТаблицыЗначений.Сумма);
ТЗ.Итоги.Добавить("Категория", "Количество", ТипИтоговТаблицыЗначений.Количество);
ТЗ.ПосчитатьИтоги();

Чем отличается Свернуть() от Итоги()?

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

Оптимизация работы с таблицами значений

При работе с большими объёмами данных в таблицах значений важно следить за производительностью. Вот ключевые рекомендации:

1. Резервирование памяти:

Всегда резервируйте строки заранее, если знаете приблизительный объём данных:

ТЗ.РезервироватьСтроки(10000);

2. Минимизация операций с колонками:

Добавление/удаление колонок после заполнения таблицы данных приводит к перераспределению памяти. Определяйте структуру заранее.

3. Использование индексов:

Создавайте индексы только для колонок, по которым часто выполняется поиск. Избыточные индексы замедляют добавление строк.

4. Альтернативы для больших данных:

Если таблица превышает 10 000 строк, рассмотрите варианты:

- Разбиение на несколько таблиц

- Использование временных таблиц базы данных

- Применение механизма ДеревоЗначений для иерархических данных

Пример оптимизированного кода для загрузки больших данных:

ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Код");
ТЗ.Колонки.Добавить("Наименование");
// Резервируем память под ожидаемое количество
ТЗ.РезервироватьСтроки(50000);

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

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

Типичные ошибки и как их избежать

Даже опытные разработчики иногда допускают ошибки при работе с таблицами значений. Вот наиболее распространённые проблемы и способы их решения:

1. Ошибка "Индекс вне границ"

Возникает при попытке обратиться к несуществующей строке. Всегда проверяйте результат методов Найти():

Индекс = ТЗ.Найти(Условие);
Если Индекс = Неопределено Тогда
// Обработка случая, когда строка не найдена
КонецЕсли;

2. Потеря данных при свертке

Метод Свернуть() не сохраняет исходные данные — он возвращает новую таблицу. Всегда сохраняйте оригинал, если он ещё нужен:

ИсходнаяТЗ = ТЗ.Скопировать();
Результат = ТЗ.Свернуть(...);

3. Несовпадение типов при загрузке

При загрузке данных из запроса или массива убедитесь, что типы колонок совпадают с типами источников:

// Ошибка: пытаемся загрузить строку в числовую колонку
ТЗ.Колонки.Добавить("Цена", Новый ОписаниеТипов("Число"));
ТЗ.ЗагрузитьКолонку(Новый Массив("100", "200"), "Цена"); // Падение!

4. Утечки памяти

Таблицы значений занимают оперативную память. После завершения работы освобождайте ресурсы:

ТЗ = Неопределено; // Освобождаем память

5. Неэффективные циклы

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

💡

Всегда проверяйте результат методов поиска (Найти(), НайтиСтроки()) на Неопределено или пустой массив. Это избавит от большинства ошибок времени выполнения.

Практическое применение: примеры из реальных задач

Рассмотрим несколько типовых задач, где таблицы значений незаменимы.

Задача 1: Формирование прайс-листа

Нужно получить актуальные цены номенклатуры с учётом скидок и вывести в Excel.

ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Артикул");
ТЗ.Колонки.Добавить("Наименование");
ТЗ.Колонки.Добавить("ЦенаСоСкидкой");

// Получаем данные запросом
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ
Номенклатура.Артикул,
Номенклатура.Наименование,
ЦеныНоменклатуры.Цена * (1 - Скидки.Процент/100) КАК ЦенаСоСкидкой
ИЗ ...
ГДЕ ...";
ТЗ.Загрузить(Запрос.Выполнить());

// Выгружаем в Excel
ТабличныйДокумент = Новый ТабличныйДокумент;
ТабличныйДокумент.Вывести(ТЗ);
ТабличныйДокумент.Записать("C:\Pricelist.xlsx", ТипФайлаТабличногоДокумента.XLSX);

Задача 2: Сравнение двух версий данных

Нужно найти различия между текущими и предыдущими остатками товаров.

ТекущиеОстатки = ПолучаемТекущиеОстатки();
ПредыдущиеОстатки = ПолучаемПредыдущиеОстатки();

// Добавляем колонку для пометки изменений
ТекущиеОстатки.Колонки.Добавить("Изменение");

// Сравниваем по артикулу
Для Каждого Строка Из ТекущиеОстатки Цикл
Найдено = ПредыдущиеОстатки.Найти(Новый Структура("Артикул", Строка.Артикул));
Если Найдено <> Неопределено Тогда
Если ПредыдущиеОстатки[Найдено].Количество <> Строка.Количество Тогда
Строка.Изменение = "Количество изменилось";
КонецЕсли;
Иначе
Строка.Изменение = "Новый товар";
КонецЕсли;
КонецЦикла;

Задача 3: Построение динамического отчёта

Формируем сводную таблицу продаж по менеджерам и категориям товаров.

Продажи = ПолучаемДанныеПродаж();

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

СводнаяТаблица = Продажи.Свернуть(Правила);

// Добавляем итоги
СводнаяТаблица.Итоги.Добавить("Менеджер", "СуммаПродаж", ТипИтоговТаблицыЗначений.Сумма);
СводнаяТаблица.ПосчитатьИтоги();

FAQ: Частые вопросы по работе с таблицами значений

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

Используйте метод Скопировать():

КопияТЗ = ИсходнаяТЗ.Скопировать();

Это создаст полную копию со структурой колонок, индексами и всеми строками.

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

Да, но с оговорками. Вы можете хранить ссылки на объекты (тип СправочникСсылка.Номенклатура), но не сами объекты. Пример:

ТЗ.Колонки.Добавить("Номенклатура", Новый ОписаниеТипов("СправочникСсылка.Номенклатура"));
НоваяСтрока = ТЗ.Добавить();
НоваяСтрока.Номенклатура = Справочники.Номенклатура.НайтиПоНаименованию("Товар 1");

Обратите внимание, что при сериализации (например, при записи в файл) такие ссылки превратятся в пустые значения.

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

Используйте ЗаписьJSON:

Запись = Новый ЗаписьJSON;
Запись.УстановитьСтроку();
ЗаписатьJSON(Запись, ТЗ);
JSONСтрока = Запись.Закрыть();

Для обратного импорта используйте ЧтениеJSON.

Почему метод Найти() работает медленно на большой таблице?

Скорее всего, не создан индекс по колонке, по которой выполняется поиск. Добавьте индекс:

ТЗ.Индексы.Добавить("ИндексПоАртикулу");
ТЗ.Индексы.ИндексПоАртикулу.Добавить("Артикул");

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

Как объединить две таблицы значений?

Есть несколько способов:

1. Метод Добавить() в цикле:

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

2. Метод ДобавитьСтроки() (быстрее для больших таблиц):

Таблица1.ДобавитьСтроки(Таблица2);

Обратите внимание, что структуры таблиц должны совпадать (одинаковые имена и типы колонок).

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