Как заполнить таблицу значений в 1С: пошаговая инструкция 2026

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

В этой статье мы разберём все актуальные способы работы с таблицами значений — от базового ручного заполнения в пользовательском режиме до продвинутых программных техник с примерами на встроенном языке. Особое внимание уделим типовым ошибкам, которые приводят к потере данных или сбоям в отчётах, а также покажем, как избежать распространённых «подводных камней» при массовом заполнении. Если вы когда-либо терялись в меню Действия → Добавить или не могли понять, почему ТаблицаЗначений.Добавить() не работает как ожидалось — этот материал для вас.

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

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

📊 Промежуточных расчётов — например, формирования отчётных форм до выгрузки в Excel.
🔄 Обмена данными между формами, отчётами и обработками.
📝 Временного хранения пользовательского ввода перед записью в справочники или документы.
🤖 Автоматизации — обработки массивов данных в циклах без обращения к базе.

Важно понимать, что ТЗ не является полноценной таблицей базы данных. Она не поддерживает индексы, транзакции или сложные связи (как в SQL), но зато позволяет гибко манипулировать данными прямо в коде. Например, вы можете динамически добавлять/удалять колонки, сортировать строки или фильтровать их по условию — всё это без обращения к серверу.

Ручное заполнение таблицы значений: пошаговая инструкция

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

Чтобы добавить строку в таблицу значений:

Откройте форму, содержащую таблицу (например, обработку или отчёт с ТЗ).
Нажмите кнопку Действия → Добавить (или используйте горячие клавиши Insert/Ctrl+N, если они настроены).
Заполните ячейки новой строки. Для перемещения между колонками используйте клавишу Tab.
Повторите шаги 2–3 для добавления следующих строк.

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

Убедиться, что таблица не заблокирована для редактирования

Проверить наличие всех необходимых колонок

Сверить типы данных колонок (число, строка, дата и т.д.)

Сохранить или применить изменения после заполнения-->

⚠️ Внимание: Если таблица значений используется в документе или справочнике, её данные могут автоматически очищаться при записи объекта. Всегда проверяйте логику обработки ПередЗаписью() в модуле объекта.

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

Для автоматизации работы с ТЗ в 1С используется встроенный язык. Рассмотрим ключевые методы и приёмы, которые пригодятся как начинающим, так и опытным разработчикам.

1. Создание новой таблицы значений

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

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

2. Добавление строк

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

НоваяСтрока = Таблица.Добавить();
НоваяСтрока.Наименование = "Товар 1";
НоваяСтрока.Количество = 5;
НоваяСтрока.Цена = 1200.50;

Альтернативный способ — заполнение через индекс:

Таблица.Добавить();
Таблица[Таблица.Количество() - 1].Наименование = "Товар 2";

3. Массовое заполнение из запроса

Один из самых эффективных способов — заполнение ТЗ результатами запроса:

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

Результат = Запрос.Выполнить(НачалоПериода, КонецПериода).Выгрузить();

Метод Выгрузить() автоматически преобразует результат запроса в таблицу значений.

💡

Если вам нужно скопировать структуру колонок из одной ТЗ в другую, используйте метод Таблица2.Колонки.Добавить(Таблица1.Колонки[Индекс].Имя, Таблица1.Колонки[Индекс].ТипЗначения). Это сэкономит время при создании аналогичных таблиц.

Типовые ошибки при заполнении таблиц значений и как их избежать

Даже опытные разработчики иногда сталкиваются с неожиданными проблемами при работе с ТЗ. Рассмотрим наиболее распространённые ошибки и способы их решения.

Ошибка	Причина	Решение
`Ошибка при обращении к значению объекта (ТаблицаЗначений)`	Обращение к несуществующей колонке или строке	Проверьте имя колонки на опечатки или используйте `Таблица.Колонки.Найти()`
Данные не сохраняются после закрытия формы	Отсутствует обработчик `ПередЗаписью()` или не вызван метод `Записать()`	Добавьте явное сохранение данных в модуле формы
`Тип не совпадает с типом колонки`	Попытка записать строку в числовую колонку (или наоборот)	Преобразуйте значение к нужному типу: `Число(Значение)` или `Строка(Значение)`
Пустые строки в результате запроса	Неправильные условия в запросе или отсутствие данных	Проверьте запрос в отладчике или добавьте `РАЗРЕШИТЬ ПУСТЫЕ ЗНАЧЕНИЯ`

Критическая ошибка: если вы используете таблицу значений в цикле с большим количеством итераций (10 000+ строк), никогда не добавляйте строки по одной в цикле — это приведёт к катастрофическому падению производительности. Вместо этого используйте метод ЗагрузитьКолонку() или формируйте массив данных заранее.

⚠️ Внимание: При копировании таблиц значений через Таблица2 = Таблица1.Скопировать() копируются только данные, но не обработчики событий. Если у вас есть подписки на события (например, ПриИзменении), их нужно настраивать отдельно.

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

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

1. Фильтрация строк

Чтобы отфильтровать строки по условию, используйте метод ВыбратьСтроки() с предикатом:

Фильтр = Новый Структура("Количество", 10);
ОтфильтрованныеСтроки = Таблица.ВыбратьСтроки(Фильтр);
// Или с произвольным условием:
ОтфильтрованныеСтроки = Таблица.ВыбратьСтроки(
Новый ПредикатСравнения("Цена", ЗначениеСравнения.Больше, 1000)
);

2. Сортировка

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

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

3. Агрегация данных

Метод Свернуть() позволяет группировать данные с расчётом итогов:

Итоги = Таблица.Свернуть("Наименование", "Количество,Цена");

// Результат: таблица с уникальными наименованиями и суммарными количеством/ценой

Как ускорить работу с большими ТЗ (100 000+ строк)

Для таблиц значений объёмом более 100 000 строк рекомендуется:

1. Отключать автоматическую перерисовку формы через Форма.ОбновлениеОтображения(Ложь)

2. Использовать НачатьТранзакцию()/ЗафиксироватьТранзакцию() для пакетного добавления

3. Загружать данные порциями по 10 000–50 000 строк с паузами через Приостановить()

4. Избегать частого вызова Количество() в циклах — сохраняйте значение в переменную

Обмен данными между таблицами значений и другими объектами

Часто требуется перенести данные из ТЗ в справочник, документ или наоборот. Рассмотрим типовые сценарии.

1. Загрузка данных из ТЗ в документ

Пример заполнения табличной части документа РеализацияТоваровУслуг из ТЗ:

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

2. Выгрузка данных из справочника в ТЗ

Пример заполнения ТЗ данными из справочника Контрагенты:

Выборка = Справочники.Контрагенты.Выбрать();
Пока Выборка.Следующий() Цикл
Строка = Таблица.Добавить();
Строка.Наименование = Выборка.Наименование;
Строка.ИНН = Выборка.ИНН;
КонецЦикла;

3. Экспорт/импорт в Excel

Для обмена данными с Excel используйте объект ЧтениеXLS/ЗаписьXLS:

// Экспорт в Excel
ЗаписьXLS = Новый ЗаписьXLS;
ЗаписьXLS.ОткрытьФайл("C:\temp\export.xlsx");
Таблица.Записать(ЗаписьXLS);
ЗаписьXLS.Закрыть();

// Импорт из Excel
ЧтениеXLS = Новый ЧтениеXLS;
ЧтениеXLS.ОткрытьФайл("C:\temp\import.xlsx");
Таблица.Прочитать(ЧтениеXLS);
ЧтениеXLS.Закрыть();

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

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

Работа с таблицами значений объёмом более 50 000 строк требует особого подхода, чтобы избежать «зависаний» 1С. Вот ключевые рекомендации:

⚡ Отключайте обновление формы при массовых операциях:

Форма.ОбновлениеОтображения(Ложь);
// ... операции с ТЗ
Форма.ОбновлениеОтображения(Истина);

🔄 Используйте пакетную обработку: разбивайте операции на порции по 5 000–10 000 строк с вызовом Приостановить(0) между пакетами.
🗑️ Очищайте ненужные данные: если в ТЗ остаются промежуточные результаты, используйте Таблица.Очистить().
📊 Избегайте вложенных циклов: для обработки данных используйте методы Свернуть(), Индексировать() или НайтиСтроки().

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

💡

Для таблиц значений объёмом более 100 000 строк рассмотрите возможность использования временных таблиц базы данных вместо ТЗ. Это значительно ускорит обработку, особенно в распределённых информационных базах.

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

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

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

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

Это создаст полную копию со всеми строками и колонками. Если нужно скопировать только структуру (без данных), используйте:

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

КонецЦикла;

Почему при добавлении строки в ТЗ возникает ошибка "Тип не совпадает"?

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

Явно преобразуйте значение: Строка.Количество = Число(Значение);
Проверьте тип колонки: Таблица.Колонки[Индекс].ТипЗначения
Используйте ЗначениеЗаполнено() для проверки перед записью.

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

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

НайденныеСтроки = Таблица.НайтиСтроки(
Новый ПредикатГруппировки(
Новый ПредикатСравнения("Наименование", ЗначениеСравнения.Равно, "Товар1"),
Новый ПредикатСравнения("Количество", ЗначениеСравнения.Больше, 5)
)
);

Для поиска первой подходящей строки используйте Найти():

Строка = Таблица.Найти("Товар1", "Наименование");

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

Да, но с оговорками:

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

Номенклатура = СтрокаТЗ.Номенклатура.ПолучитьОбъект();

Если нужно хранить все реквизиты объекта, создайте отдельные колонки для каждого реквизита.

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

Для отладки:

Установите точку останова на строке с операцией над ТЗ.
В окне отладчика используйте Вычислить выражение (F9), чтобы просмотреть содержимое ТЗ:

Таблица.Выгрузить()

Для пошагового анализа используйте ПоказатьВОтладчике(Таблица).
Проверяйте количество строк через Таблица.Количество() на каждом этапе.

Если ТЗ заполняется в цикле, добавьте счётчик итераций, чтобы локализовать проблему.

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