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

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

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

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

Архитектура объекта и отличие от других коллекций

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

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

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

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

Создание и инициализация колонок

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

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

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

Попытка создать две колонки с именем "Сумма" вызовет исключение. Также типы данных должны соответствовать тем данным, которые вы планируете загружать.

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

Заполнение данными и работа со строками

После того как структура определена, наступает этап наполнения. Существует два основных способа добавления данных: построчное добавление через метод Добавить и массовая загрузка через метод Загрузить.

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

• 📝 Метод Добавить создает новую строку в конце таблицы и возвращает ссылку на неё.
• 📝 Метод Вставить позволяет добавить строку в конкретную позицию, сдвигая остальные вниз.
• 📝 Свойство Количество возвращает текущее число строк в таблице.
• 📝 Доступ к ячейке осуществляется как Строка.ИмяКолонки или Строка["ИмяКолонки"].

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

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

Рассмотрим пример типичного цикла заполнения, где мы вычисляем сумму на лету:

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

Оптимизация циклов

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

Индексация, поиск и сортировка данных

Одним из главных преимуществ использования ТаблицыЗначений перед обычными массивами является наличие встроенных механизмов поиска и сортировки. Однако для эффективной работы поиска необходимо предварительно создать индексы.

Индекс создается методом Индексы.Добавить, куда передается имя колонки или список имен колонок, по которым будет вестись поиск. Без индекса поиск будет выполняться полным перебором всех строк, что при больших объемах данных недопустимо медленно.

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

Метод	Назначение	Требует индекса	Возвращаемое значение
Найти	Поиск точного совпадения	Желательно	Строка или Неопределено
НайтиПо	Поиск по условию (как в запросе)	Нет	ТаблицаЗначений (подмножество)
Сортировать	Упорядочивание строк	Нет	Нет (меняет порядок в памяти)

Сортировка выполняется методом Сортировать, которому передается строка описания сортировки, аналогичная предложению ORDER BY в языке запросов 1С. Например, "Сумма Убыв, Номенклатура Возр".

Агрегатные функции и группировка

Часто возникает задача не просто отобразить данные, но и получить по ним итоги: суммы, количества, средние значения. Для этого в объекте реализован мощный метод Итоги, который работает аналогично предложению GROUP BY в SQL.

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

ТЗ_Итоги = ТЗ.Итоги(
"Сумма(Сумма) КАК ОбщаяСумма, Сумма(Количество) КАК ВсегоШтук",
"Номенклатура"
);

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

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

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

Взаимодействие с элементами формы и вывод

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

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

Если необходимо вывести данные в печатную форму или экспортный файл (Excel, MXL), таблица значений служит идеальным промежуточным форматом. Механизмы компоновки данных (СКД) также принимают этот объект в качестве набора данных.

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

Частые ошибки и оптимизация производительности

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

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

• 🚫 Избегайте использования строковых имен колонок в интенсивных циклах, лучше обращаться к колонкам по индексам или кэшировать ссылки на колонки.
• 🚫 Не храните в таблице значений объекты, не подлежащие сериализации, если планируете передавать таблицу между контекстами выполнения.
• 🚫 Не используйте таблицу значений как временный буфер для одной-двух строк — для этого достаточно Структуры или Массива.

Оптимизация также касается выбора типов данных. Использование универсального типа Строка(1000) для всех колонок"на всякий случай" увеличивает потребление памяти и замедляет сравнение значений. Всегда используйте максимально точные типы.

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

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

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

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

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

Для полного копирования используется метод Скопировать. Он создает глубокую копию объекта, включая все строки, данные и настройки колонок. Присваивание переменной (например, ТЗ2 = ТЗ1) копирует только ссылку на объект.

Поддерживает ли таблица значений вложенные таблицы?

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