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

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

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

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

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

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

🔹 Гибкость: можно динамически добавлять/удалять колонки и строки без изменения конфигурации.
🔹 Производительность: операции с данными в памяти выполняются быстрее, чем чтение/запись в базу.
🔹 Универсальность: используется в отчетах, обработках, при обмене данными между системами.
🔹 Простота отладки: данные можно просматривать в отладчике в удобном табличном виде.

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

📊 Подготовка данных для печатных форм или отчетов.
🔄 Промежуточные расчеты в алгоритмах (например, распределение затрат).
📥 Импорт/экспорт данных из внешних источников (Excel, XML, JSON).
🔍 Фильтрация и группировка данных перед выводом пользователю.

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

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

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

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

Основные способы:

Через конструктор (интерактивно в режиме предприятия).
Программно с использованием метода Новый ТаблицаЗначений.
Копированием из существующей таблицы (метод Скопировать()).
Загрузкой из файла (Excel, CSV) или внешнего источника.

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

🔧 Динамически настраивать структуру таблицы (имена колонок, типы данных).
📝 Автоматически заполнять данными из других источников.
🔄 Использовать таблицу в алгоритмах без ручного вмешательства.

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

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

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

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

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

Разберем этот код подробно:

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

Типы данных для колонок можно указывать следующими способами:

Тип данных	Пример описания	Пример значения
Строка	`Новый ОписаниеТипов("Строка")`	`"Пример текста"`
Число	`Новый ОписаниеТипов("Число", 10, 2)`	`12345.67`
Дата	`Новый ОписаниеТипов("Дата")`	`'2026-12-31'`
Булево	`Новый ОписаниеТипов("Булево")`	`Истина` или `Ложь`
Ссылка	`Новый ОписаниеТипов("СправочникСсылка.Номенклатура")`	`Справочники.Номенклатура.НайтиПоНаименованию("Товар 1")`

Важно: Если не указать тип колонки явно, 1С автоматически определит его по первому добавленному значению. Это может привести к ошибкам при последующем заполнении данными другого типа.

Определены все необходимые колонки

Указаны правильные типы данных

Есть план по заполнению данными

Предусмотрена обработка ошибок (если данные загружаются из внешнего источника)-->

Работа с колонками: добавление, переименование, удаление

Управление колонками — ключевой аспект работы с таблицами значений. От правильной структуры зависит удобство дальнейшей обработки данных.

Основные методы работы с колонками:

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

// 2. Переименование колонки
Таблица.Колонки.Найти("СтараяКолонка").Имя = "НовоеИмя";

// 3. Удаление колонки
Таблица.Колонки.Удалить(Таблица.Колонки.Найти("НенужнаяКолонка"));

// 4. Перемещение колонки (например, сделать первой)
Колонка = Таблица.Колонки.Найти("ВажнаяКолонка");
Таблица.Колонки.Переместить(Колонка, 0);

Полезные свойства колонок:

📌 Имя — название колонки (используется для обращения к данным).
📌 ТипЗначения — тип данных, хранящихся в колонке.
📌 Заголовок — отображаемое имя (может отличаться от системного).
📌 Ширина — ширина колонки при отображении в интерфейсе.

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

Колонка = Таблица.Колонки.Добавить("Сумма");
Колонка.ТипЗначения = Новый ОписаниеТипов("Число", 15, 2);
Колонка.Заголовок = "Итоговая сумма (руб.)";
Колонка.Ширина = 120;

⚠️ Внимание: При переименовании колонки через свойство Имя все ссылки на неё в коде должны быть обновлены. В противном случае возникнет ошибка "Поле объекта не обнаружено".

💡

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

Заполнение таблицы значений данными

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

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

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

2. Загрузка из массива или выборки (оптимально для больших объемов данных):

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

3. Копирование из другой таблицы (полезно для промежуточных расчетов):

НоваяТаблица = ИсходнаяТаблица.Скопировать();
НоваяТаблица.Колонки.Добавить("Процент", Новый ОписаниеТипов("Число", 5, 2));

4. Импорт из Excel или CSV (для интеграции с внешними системами):

// Пример загрузки из Excel (требуется подключение библиотеки)
ТаблицаДокумента = ПолучитьТаблицуИзExcel("C:\data.xlsx", 1);
Для Каждого СтрокаExcel Из ТаблицаДокумента Цикл
Строка = Таблица.Добавить();
Строка.Наименование = СтрокаExcel[0];
Строка.Количество = Число(СтрокаExcel[1]);
КонецЦикла;

При заполнении таблицы большими объемами данных (тысячи строк) рекомендуется:

🔹 Отключать автоматическое отображение таблицы в интерфейсе (Таблица.ТолькоПросмотр = Истина).
🔹 Использовать НачатьИзменение() и ЗакончитьИзменение() для пакетной записи.
🔹 Очищать ненужные данные после обработки (Таблица.Очистить()).

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

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

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

Это работает в 3-5 раз быстрее, чем построчное заполнение.

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

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

1. Изменение данных в строках:

// Изменение конкретной строки Таблица[0].Цена = 1200; // Первая строка (индексация с 0) // Изменение всех строк по условию Для Каждого Строка Из Таблица Цикл Если Строка.Количество > 10 Тогда Строка.Цена = Строка.Цена * 0.9; // Скидка 10% КонецЕсли;

КонецЦикла;

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

// Создание нового таблицы с отфильтрованными данными
ФильтрованнаяТаблица = Таблица.Скопировать();
ФильтрованнаяТаблица.Очистить();
Для Каждого Строка Из Таблица Цикл
Если Строка.Цена > 1000 Тогда
ФильтрованнаяТаблица.Добавить(Строка);
КонецЕсли;
КонецЦикла;

3. Сортировка:

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

4. Группировка и итоги:

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

Итоги = Таблица.Итоги("Категория", "Сумма", ТипИтогов.Сумма);

5. Поиск строк:

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

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

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

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

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

Рассмотрим реальные сценарии, где таблицы значений незаменимы:

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

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

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

// Выгрузка в Excel
Таблица.Записать("C:\Прайс.xlsx", ТипФайлаExcel.Excel2007);

2. Расчет premiй сотрудникам:

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

Для Каждого Строка Из ТаблицаСотрудников Цикл
Если Строка.Оклад > 100000 Тогда
Строка.Премия = Строка.Оклад * 0.2;
Иначе
Строка.Премия = Строка.Оклад * 0.1;
КонецЕсли;
КонецЦикла;

3. Сравнение данных из двух источников:

Таблица1 = ЗагрузитьДанныеИзExcel("Склад1.xlsx");
Таблица2 = ЗагрузитьДанныеИзExcel("Склад2.xlsx");

// Поиск расхождений
Расхождения = Новый ТаблицаЗначений;
Расхождения.Колонки.Добавить("Артикул");
Расхождения.Колонки.Добавить("Наименование");
Расхождения.Колонки.Добавить("Количество1");
Расхождения.Колонки.Добавить("Количество2");

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

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

💡

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

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

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

1. Несоответствие типов данных:

Если в колонке указан тип Число, а вы пытаетесь записать туда строку, возникнет ошибка. Всегда проверяйте типы:

Попытка
Строка.Цена = "1000"; // Ошибка!
Исключение
Сообщить("Некорректный тип данных: " + ОписаниеОшибки());
КонецПопытки;

2. Обращение к несуществующей колонке:

Перед обращением проверяйте наличие колонки:

Если Таблица.Колонки.Найти("НесуществующаяКолонка") = Неопределено Тогда
Таблица.Колонки.Добавить("НесуществующаяКолонка");
КонецЕсли;

3. Изменение таблицы во время итерации:

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

// Правильный способ удаления строк в цикле
Для Инд = Таблица.Количество() - 1 По 0 Цикл
Если Таблица[Инд].Количество = 0 Тогда
Таблица.Удалить(Инд);
КонецЕсли;
КонецЦикла;

4. Неэффективная работа с большими таблицами:

При тысячах строк избегайте:

🚫 Построчного добавления без НачатьИзменение().
🚫 Частых операций сортировки или фильтрации в цикле.
🚫 Хранения в таблице ненужных колонок.

5. Утечки памяти:

После использования больших таблиц всегда очищайте их:

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

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

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

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

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

Создать документ или справочник с аналогичной структурой.
Пройти по строкам таблицы и записать их как элементы справочника или строки документа.
Использовать метод Записать() для сохранения.

Пример:

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

Можно ли в таблице значений хранить картинки или файлы?

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

Таблица.Колонки.Добавить("Изображение", Новый ОписаниеТипов("ДвоичныеДанные"));
Строка = Таблица.Добавить();
Строка.Изображение = Новый ДвоичныеДанные("C:\photo.jpg");

Однако имейте в виду:

Объем данных ограничен памятью сеанса.
Для долговременного хранения лучше использовать справочник с реквизитом типа ХранилищеЗначения.

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

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

Таблица.Записать("C:\Отчет.xlsx", ТипФайлаExcel.Excel2007, Истина);

Параметры метода:

ТипФайлаExcel.Excel2007 — формат XLSX.
Истина — открыть файл после сохранения.

Для сложных отчетов с форматированием лучше использовать библиотеку OneScriptExcel или Аспан Excel.

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

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

Простое слияние (добавляем строки второй таблицы в первую):

Для Каждого Строка Из Таблица2 Цикл
Таблица1.Добавить(Строка);
КонецЦикла;

Объединение по ключу (аналог SQL JOIN):

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

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

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

Для отладки используйте:

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

Сообщить(Таблица.ВыгрузитьВСтрокуJSON());

Запись в файл для больших таблиц:

Таблица.Записать("C:\debug.txt", ТипФайлаТекста.ТекстовыйДокумент);

Для визуального анализа данных временно выведите таблицу в форму:

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

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