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

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

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

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

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

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

Основные сценарии использования:

• 📊 Промежуточные расчеты — когда нужно обработать данные перед записью в базу (например, расчет зарплаты с учетом премий)
• 📄 Формирование отчетов — когда источником данных служит несколько таблиц БД, а результат нужно показать в единой форме
• 🔄 Обмен данными — при импорте/экспорте информации между системами (например, выгрузка в Excel или загрузка из JSON)
• ⚙️ Реализация сложной логики — когда стандартные механизмы 1С не покрывают бизнес-требования (например, многомерный анализ продаж)

Важное отличие ТЗ от других коллекций (Массив, Структура, Соответствие) — возможность работы с данными в табличном виде, включая сортировку, фильтрацию и группировку без обращения к СУБД. Это значительно ускоряет выполнение операций, критичных к производительности.

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

2. Способы создания таблицы значений в конфигураторе

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

Пошаговая инструкция:

1. Откройте нужный объект конфигурации (например, форму документа или отчета)
2. Перейдите на закладку Реквизиты и добавьте новый реквизит типа ТаблицаЗначений
3. В свойствах реквизита нажмите кнопку Открыть конструктор таблицы значений
4. Добавьте необходимые колонки, указав для каждой:
   • 🏷️ Имя (латинские символы, без пробелов)
   • 📏 Тип данных (число, строка, дата, ссылка и т.д.)
   • 🔢 Длина/точности (для числовых и строковых полей)

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

Указаны все обязательные колонки|

Типы данных соответствуют бизнес-логике|

Заданы корректные длины для строковых полей|

Проверена уникальность имен колонок-->

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

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

Базовый синтаксис:

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

Для ускорения работы с большими таблицами (10 000+ строк) используйте метод ЗагрузитьКолонку() вместо поэлементного заполнения:

МассивНаименований = Новый Массив;
МассивНаименований.Добавить("Товар 1");
МассивНаименований.Добавить("Товар 2");
// ...
ТЗ.ЗагрузитьКолонку(МассивНаименований, "Наименование");

⚠️ Внимание: При работе с колонками типа Ссылка всегда указывайте конкретный тип ссылки (например, СправочникСсылка.Номенклатура), иначе при заполнении данных возникнут ошибки приведения типов.

4. Создание таблицы значений через запрос

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

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

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

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

Преимущества этого метода:

• ⚡ Производительность — обработка данных происходит на стороне СУБД
• 🔍 Гибкость — можно использовать все возможности языка запросов 1С
• 📊 Агрегация — удобно рассчитывать итоги, средние значения, количество

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

5. Импорт данных в таблицу значений из внешних источников

Частая задача — загрузка данных в ТЗ из файлов (Excel, CSV, JSON) или других систем. Рассмотрим основные сценарии:

5.1. Импорт из Excel

Для работы с Excel-файлами используйте объект ЧтениеXLS (для форматов .xls) или ЧтениеXLSX (для .xlsx):

Чтение = Новый ЧтениеXLSX;
Чтение.ОткрытьФайл("C:\data\price_list.xlsx");
// Чтение данных с первого листа, начиная со второй строки
ТаблицаExcel = Чтение.ПрочитатьЛист(1, 1);
ТЗ = ТаблицаExcel.Выгрузить();

5.2. Парсинг CSV

Для CSV-файлов подходит ЧтениеТекста с ручным разбором:

Текст = Новый ЧтениеТекста;
Текст.ОткрытьФайл("C:\data\import.csv");
ТЗ = Новый ТаблицаЗначений;
// Добавляем колонки (предполагаем, что первая строка - заголовки)
Заголовки = Текст.ПрочитатьСтроку();
Для Каждого Колонка Из СтроковыеФункцииКлиентСервер.РазложитьСтрокуВМассивПодстрок(Заголовки, ";") Цикл
ТЗ.Колонки.Добавить(Колонка);
КонецЦикла;
// Читаем данные
Пока Текст.КонецФайла() = Ложь Цикл
СтрокаДанных = Текст.ПрочитатьСтроку();
НоваяСтрока = ТЗ.Добавить();
Данные = СтроковыеФункцииКлиентСервер.РазложитьСтрокуВМассивПодстрок(СтрокаДанных, ";");
Для Инд = 0 По Данные.ВГраница() Цикл
НоваяСтрока[Инд] = Данные[Инд];
КонецЦикла;
КонецЦикла;

5.3. Конвертация JSON в таблицу значений

Для работы с JSON используйте ЧтениеJSON:

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

Попытка
// Код импорта
Исключение
ЗаписьЖурналаРегистрации("Ошибка импорта", УровеньЖурналаРегистрации.Ошибка,, ,
ПодробноеОписаниеОшибки());
СообщитьПользователю("Не удалось загрузить данные. Обратитесь к администратору.");
КонецПопытки;

6. Типовые ошибки и их решение

При работе с таблицами значений разработчики часто сталкиваются с повторяющимися проблемами. Мы собрали топ-5 ошибок и способы их исправления:

1. Ошибка приведения типа (Недопустимое приведение типа)

   Причина: Попытка записать в колонку значение несовместимого типа (например, строку в числовую колонку).

   Решение: Проверяйте типы данных перед записью или используйте явное приведение:

   НоваяСтрока.Количество = Число(ЗначениеИзИсточника);

2. Индекс вне границ (Индекс вне допустимого диапазона)

   Причина: Обращение к несуществующей строке или колонке по индексу.

   Решение: Проверяйте количество строк (ТЗ.Количество()) и колонок перед обращением.

3. Переполнение памяти (Недостаточно памяти)

   Причина: Слишком большая таблица значений (>100 000 строк) или рекурсивные операции.

   Решение: Разбивайте обработку на пакеты или используйте временные таблицы БД.

4. Потеря ссылок (пустые ссылки после загрузки)

   Причина: При выгрузке/загрузке таблицы со ссылками без сохранения идентификаторов объектов.

   Решение: Используйте колонку с УникальныйИдентификатор для восстановления ссылок.

5. Медленная работа с большими таблицами

   Причина: Поэлементное заполнение строк или частые операции Найти().

   Решение: Используйте ЗагрузитьКолонку() и создавайте индексы для часто используемых колонок.

Критическая информация: При работе с таблицами значений в серверных процедурах (фоновые задания, HTTP-сервисы) всегда ограничивайте максимальный размер таблицы через настройку МаксимальныйРазмерПамяти в параметрах информационной базы. Это предотвратит зависание сервера при неконтролируемом росте данных.

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

Производительность при работе с ТЗ зависит от нескольких факторов. Следующие рекомендации помогут ускорить код в 2-5 раз:

• ⚡ Минимизируйте количество колонок — удаляйте ненужные колонки сразу после использования
• 🔄 Используйте пакетную загрузку — ЗагрузитьКолонку() вместо циклов
• 🔍 Создавайте индексы для колонок, по которым часто ищут данные:

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

• 🗑️ Очищайте память — удаляйте большие таблицы после использования (ТЗ = Неопределено;)
• 📊 Используйте временные таблицы для промежуточных расчетов с большими объемами данных

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

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

// 2. Загружаем данные пакетом из массива
МассивАртикулов = ПолучитьМассивАртикуловИзБазы(); // Предполагаем, что это массив строк
МассивЦен = ПолучитьМассивЦенИзБазы();             // Массив чисел
ТЗ.ЗагрузитьКолонку(МассивАртикулов, "Артикул");
ТЗ.ЗагрузитьКолонку(МассивЦен, "Цена");

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

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

8. Практическое применение таблиц значений

Рассмотрим реальные примеры использования ТЗ в бизнес-задачах:

8.1. Сравнение версий документов

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

Процедура СравнитьВерсииДокумента(ТекущийДок, ПредыдущийДок)
ТЗРезультаты = Новый ТаблицаЗначений;
ТЗРезультаты.Колонки.Добавить("Товар");
ТЗРезультаты.Колонки.Добавить("ИзменениеКоличества");
ТЗРезультаты.Колонки.Добавить("СтароеКоличество");
ТЗРезультаты.Колонки.Добавить("НовоеКоличество");

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

Возврат ТЗРезультаты;
КонецПроцедуры

8.2. Формирование сводного отчета

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

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

ТЗОтчет = Запрос.Выполнить(НачалоКвартала(ТекущаяДата()), КонецКвартала(ТекущаяДата())).Выгрузить();

8.3. Импорт цен из Excel с валидацией

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

Процедура ЗагрузитьЦеныИзExcel(ПутьКФайлу)
Чтение = Новый ЧтениеXLSX;
Попытка
Чтение.ОткрытьФайл(ПутьКФайлу);
ТЗДанные = Чтение.ПрочитатьЛист(1, 1); // Чтение с первого листа, пропуская заголовок

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

Для Каждого СтрокаИзФайла Из ТЗДанные Цикл
НоваяСтрока = ТЗРезультаты.Добавить();
НоваяСтрока.Артикул = СтрокаИзФайла.Артикул;
НоваяСтрока.Статус = "ОК";

Попытка
НоваяСтрока.Цена = Число(СтрокаИзФайла.Цена);
Если НоваяСтрока.Цена <= 0 Тогда
НоваяСтрока.Статус = "Ошибка";
НоваяСтрока.Сообщение = "Цена должна быть положительной";
КонецЕсли;
Исключение
НоваяСтрока.Статус = "Ошибка";
НоваяСтрока.Сообщение = "Некорректный формат цены: " + ОписаниеОшибки();
КонецПопытки;
КонецЦикла;

Возврат ТЗРезультаты;
Исключение
Сообщить("Ошибка чтения файла: " + ОписаниеОшибки());
Возврат Неопределено;
КонецПопытки;
КонецПроцедуры

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

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

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

Запись = Новый ЗаписьXLSX;
Запись.ОткрытьФайл("C:\export\report.xlsx");
Запись.ЗаписатьТаблицуЗначений(ТЗ, "Отчет", Истина); // Третий параметр - записывать заголовки
Запись.Закрыть();