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

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

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

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

Таблица значений (ТЗ) в 1С:Предприятие — это динамический объект, который представляет собой двумерный массив данных. В отличие от базы данных, таблица значений существует только в оперативной памяти и используется для временных вычислений. Ее основные особенности:

• 📊 Хранит данные в виде строк и колонок (аналог таблицы Excel)
• 🔄 Поддерживает динамическое добавление/удаление строк и колонок
• 🔍 Позволяет выполнять поиск, сортировку и группировку данных
• 🔗 Может использоваться для обмена данными между формами и модулями

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

• 📑 Формирование промежуточных данных для отчетов
• 🔄 Обработка массивов информации перед записью в базу
• 📊 Создание динамических таблиц в формах
• 🔗 Обмен данными между клиентом и сервером

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

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

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

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

При создании колонок можно сразу задавать:

• 🏷️ Имя колонки (обязательный параметр)
• 🔢 Тип данных (если не указан, будет "Строка")
• 📏 Длину (для строковых типов)
• 🔢 Точность (для числовых типов)

Для удобства работы с таблицей можно сразу задать заголовки колонок, которые будут отображаться в интерфейсе:

ТЗ.Колонки.Наименование.Заголовок = "Название товара";
ТЗ.Колонки.Количество.Заголовок = "Кол-во, шт.";

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

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

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

1. 📝 Добавление новой строки с последующим заполнением
2. 🔄 Добавление строки с immediate заполнением
3. 📋 Загрузка данных из массива или запроса

Пример добавления строки с последующим заполнением:

НоваяСтрока = ТЗ.Добавить();
НоваяСтрока.Наименование = "Монитор 24\"";
НоваяСтрока.Количество = 5;
НоваяСтрока.Цена = 12500.50;

Более компактный вариант — добавление строки с immediate заполнением:

ТЗ.Добавить(Новый Структура("Наименование, Количество, Цена", "Клавиатура", 10, 1200.00));

Для работы с существующими строками используйте метод Получить():

Строка = ТЗ.Получить(0); // Получаем первую строку
Строка.Цена = Строка.Цена * 1.1; // Увеличиваем цену на 10%

Поиск, сортировка и фильтрация данных

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

НайденнаяСтрока = ТЗ.Найти("Монитор 24\"", "Наименование");
Если НайденнаяСтрока = Неопределено Тогда
Сообщить("Товар не найден!");
Иначе
Сообщить("Найден на позиции: " + ТЗ.Индекс(НайденнаяСтрока));
КонецЕсли;

Для сортировки данных используйте метод Сортировать():

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

Более сложная фильтрация реализуется с помощью метода Выбрать():

Выборка = ТЗ.Выбрать();
Пока Выборка.Следующий() Цикл
Если Выборка.Количество > 5 Тогда
Сообщить(Выборка.Наименование + " - большое количество!");
КонецЕсли;
КонецЦикла;

Для группировки данных по определенному признаку используйте Свернуть():

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

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

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

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

Одной из самых полезных техник является использование индексов. Индексирование колонок значительно ускоряет операции поиска:

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

Еще одна мощная возможность — связанные таблицы значений. Они позволяют создать отношение "родитель-потомок" между таблицами:

РодительскаяТЗ = Новый ТаблицаЗначений;
РодительскаяТЗ.Колонки.Добавить("Наименование");

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

РодительскаяТЗ.СвязанныеТаблицы.Добавить("Детали", ДочерняяТЗ, "Связь");

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

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

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

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

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

• 🐢 Построчное добавление без пакетной обработки — приводит к значительному замедлению при работе с большими объемами данных
• 🔍 Поиск без индексов — линейный поиск по неиндексированным колонкам работает очень медленно
• 🗑️ Утечки памяти — забывают очищать большие таблицы значений после использования
• 🔄 Неправильная сортировка — сортировка по несуществующим колонкам или с ошибками в синтаксисе

Пример неправильного кода, который приводит к утечке памяти:

Процедура ОбработатьДанные()
ТЗ = Новый ТаблицаЗначений;
// ... заполнение таблицы большим количеством данных
// Забыли очистить ТЗ перед выходом из процедуры!
КонецПроцедуры

Исправленный вариант:

Процедура ОбработатьДанные()
ТЗ = Новый ТаблицаЗначений;
Попытка
// ... обработка данных
Исключение
// обработка ошибок
КонецПопытки;
ТЗ.Очистить(); // или ТЗ = Неопределено;
КонецПроцедуры

⚠️ Внимание: При работе с таблицами значений в клиент-серверном варианте 1С:Предприятие помните, что передача больших таблиц между клиентом и сервером может значительно замедлить работу системы. Старайтесь передавать только необходимые данные.

Примеры практического применения

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

Пример 1. Формирование прайс-листа

ТЗПрайс = Новый ТаблицаЗначений;
ТЗПрайс.Колонки.Добавить("Товар");
ТЗПрайс.Колонки.Добавить("Цена");
ТЗПрайс.Колонки.Добавить("Остаток");

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

Результат = Запрос.Выполнить(Структура("Дата", ТекущаяДата()));
ТЗПрайс.Загрузить(Результат.Выгрузить());

Пример 2. Обработка данных перед записью в документ

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

// Заполняем таблицу данными из формы
Для Каждого СтрокаТабличнойЧасти Из ДокументОбъект.Товары Цикл
НоваяСтрока = ТЗДокумент.Добавить();
НоваяСтрока.Номенклатура = СтрокаТабличнойЧасти.Номенклатура;
НоваяСтрока.Количество = СтрокаТабличнойЧасти.Количество;
НоваяСтрока.Цена = ПолучитьЦену(СтрокаТабличнойЧасти.Номенклатура);
НоваяСтрока.Сумма = НоваяСтрока.Количество * НоваяСтрока.Цена;
КонецЦикла;

// Проверяем и корректируем данные перед записью
Для Каждого Строка Из ТЗДокумент Цикл
Если Строка.Количество <= 0 Тогда
ТЗДокумент.Удалить(Строка);
КонецЕсли;
КонецЦикла;

Пример 3. Сравнение двух таблиц значений

Процедура СравнитьТаблицы(ТЗ1, ТЗ2, РезультатСравнения)
// Добавляем колонки для результата
РезультатСравнения.Колонки.Добавить("ТипИзменения");
РезультатСравнения.Колонки.Добавить("Наименование");
РезультатСравнения.Колонки.Добавить("Значение1");
РезультатСравнения.Колонки.Добавить("Значение2");

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

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

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

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

• ⚡ Используйте пакетную обработку при добавлении большого количества строк
• 🔍 Создавайте индексы для колонок, по которым часто выполняется поиск
• 🧹 Очищайте ненужные таблицы после использования, особенно на сервере
• 📊 Избегайте лишних колонок — храните только необходимые данные
• 🔄 Минимизируйте передачу данных между клиентом и сервером

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

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

ТЗ = Новый ТаблицаЗначений;
ТЗ.Загрузить(Результат.Выгрузить()); // Быстрая загрузка результата запроса

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

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

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

Запрос.УстановитьПараметр("ТЗ", ТЗ);
Результат = Запрос.Выполнить();

⚠️ Внимание: Характеристики производительности могут варьироваться в зависимости от версии платформы 1С:Предприятие и конфигурации оборудования. Для критических операций всегда тестируйте производительность на реальных данных.

FAQ: Ответы на частые вопросы

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

Процедура СохранитьВCSV(ТЗ, ИмяФайла)
Текст = Новый ЗаписьТекста(ИмяФайла, КодировкаТекста.UTF8);
// Записываем заголовки
Разделитель = ";";
СтрокаЗаголовков = "";
Для Каждого Колонка Из ТЗ.Колонки Цикл
СтрокаЗаголовков = СтрокаЗаголовков + Колонка.Заголовок + Разделитель;
КонецЦикла;
Текст.ЗаписатьСтроку(Лев(СтрокаЗаголовков, СтрДлина(СтрокаЗаголовков)-1));

// Записываем данные
Для Каждого Строка Из ТЗ Цикл
СтрокаДанных = "";
Для Каждого Колонка Из ТЗ.Колонки Цикл
СтрокаДанных = СтрокаДанных + ?(Строка[Колонка.Имя] = Неопределено, "",
Строка[Колонка.Имя]) + Разделитель;
КонецЦикла;
Текст.ЗаписатьСтроку(Лев(СтрокаДанных, СтрДлина(СтрокаДанных)-1));
КонецЦикла;
Текст.Закрыть();
КонецПроцедуры

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

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

// Серверный код
Процедура ОбработатьТаблицу(ТЗ) Экспорт
// Обработка данных
Для Каждого Строка Из ТЗ Цикл
// ... обработка строки
КонецЦикла;
Возврат Истина;
КонецПроцедуры