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

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

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

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

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

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

📊 промежуточных расчетов (например, при формировании отчетов);
🔄 обмена данными между формами или модулями;
📝 временного хранения информации перед записью в базу;
🔍 фильтрации и обработки массивов данных без изменения исходных справочников.

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

🚀 Быстродействие: все операции выполняются в оперативной памяти, без обращений к базе;
🛠️ Гибкость: можно динамически добавлять/удалять колонки и строки;
🔄 Универсальность: поддерживаются разные типы данных (число, строка, дата, ссылка и др.).

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

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

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

Способ 1: Создание через конструктор (без программирования)

Если вам нужно быстро создать ТЗ для временных расчетов или тестирования:

Откройте любую обработку или отчет в режиме 1С:Предприятие;
Перейдите на закладку Данные (или Реквизиты, в зависимости от версии);
Нажмите Добавить → Таблица значений;
Задайте имя таблицы (например, ТаблицаТоваров);
В открывшемся окне добавьте необходимые колонки, указав для каждой:
- 📌 Имя (например, Наименование);
- 📌 Тип (строка, число, дата, ссылка на справочник и т.д.);
- 📌 Заголовок (отображаемое имя в интерфейсе).

После сохранения таблица будет доступна для заполнения вручную или через код.

Способ 2: Программное создание таблицы

Для автоматизации создания таблиц используйте следующий код на встроенном языке 1С:

// Создаем новую таблицу значений
Таблица = Новый ТаблицаЗначений;

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

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

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

💡

Если вам нужно создать таблицу с колонками, аналогичными существующей таблице (например, из запроса), используйте метод СкопироватьКолонки(). Это сэкономит время при работе с большими структурами данных.

Как добавлять строки и заполнять данные

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

Ручное заполнение через интерфейс

Если таблица создана через конструктор и отображается на форме:

Дважды кликните по таблице или нажмите Добавить на панели инструментов;
Заполните ячейки в новой строке;
Для добавления еще одной строки повторите действие или используйте клавишу Insert;
Чтобы отредактировать существующую строку, выделите ее и измените нужные ячейки.

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

Программное добавление строк

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

// Способ 1: Добавление строки по одной
НоваяСтрока = Таблица.Добавить();
НоваяСтрока.Наименование = "Монитор 24\"";
НоваяСтрока.Количество = 5;
НоваяСтрока.Цена = 12500.50;
НоваяСтрока.ДатаПоступления = ТекущаяДата();

// Способ 2: Массовая загрузка данных (например, из массива)
Данные = Новый Массив;
Данные.Добавить(Новый Структура("Наименование,Количество,Цена", "Клавиатура", 10, 1200));
Данные.Добавить(Новый Структура("Наименование,Количество,Цена", "Мышь", 15, 800));

Таблица.Загрузить(Данные);

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

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

Редактирование существующих строк

Чтобы изменить данные в уже существующей строке, обратитесь к ней по индексу или используйте метод Найти():

// Изменение по индексу (нумерация с 0)
Таблица[0].Цена = 13000; // Изменили цену в первой строке

// Поиск и редактирование
НайденнаяСтрока = Таблица.Найти("Мышь", "Наименование");
Если НайденнаяСтрока <> Неопределено Тогда
НайденнаяСтрока.Количество = 20;
КонецЕсли;

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

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

Удалите пустые строки, если они не нужны

Сохраните резервную копию данных при массовых изменениях-->

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

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

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

Чтобы добавить колонку программно:

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

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

После добавления колонки все существующие строки автоматически получат пустые значения в новых ячейках. Для колонок типа Число пустым значением будет 0, для строк — пустая строка, для дат — '00010101' (минимальная дата).

Удаление и переименование колонок

Для изменения структуры таблицы используйте следующие методы:

// Удаление колонки по имени
Таблица.Колонки.Удалить(Таблица.Колонки.Найти("Скидка"));

// Переименование колонки
КолонкаЦена = Таблица.Колонки.Найти("Цена");
КолонкаЦена.Имя = "ЦенаЗаЕдиницу";
КолонкаЦена.Заголовок = "Цена за ед., руб.";

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

Изменение типов данных колонок

Тип данных колонки можно изменить, но это требует осторожности:

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

При изменении типа 1С попытается автоматически преобразовать существующие данные. Однако это не всегда возможно:

- Число можно преобразовать в строку, но не наоборот;

- Дату можно преобразовать в строку, но строку в дату — только если формат совпадает;

- Ссылки на объекты при преобразовании в строку потеряют свою функциональность.

Исходный тип	Новый тип	Результат преобразования	Примечание
`Число`	`Строка`	Успешно	Число 123 станет строкой "123"
`Строка`	`Число`	Ошибка или 0	Если строка не является числом (например, "abc"), будет ошибка
`Дата`	`Строка`	Успешно	Дата преобразуется в строку в формате дд.мм.гггг
`Ссылка`	`Строка`	Успешно	Ссылка станет строкой с именем объекта, но потеряет функциональность

Сортировка, фильтрация и поиск в таблице значений

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

Сортировка данных

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

// Сортировка по одной колонке (по возрастанию)
Таблица.Сортировать("Цена");

// Сортировка по нескольким колонкам
МассивКолонок = Новый Массив;
МассивКолонок.Добавить("Наименование"); // По алфавиту
МассивКолонок.Добавить("ДатаПоступления Убыв"); // По дате (по убыванию)
Таблица.Сортировать(МассивКолонок);

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

Сортировка выполняется "на месте" — исходная таблица изменяется. Если нужно сохранить первоначальный порядок, предварительно создайте копию таблицы с помощью метода Скопировать().

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

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

// Фильтрация с использованием Отбор
Отбор = Новый Структура("Цена", Новый УсловиеОтбора(">= 10000"));
Результат = Таблица.Выбрать(,, Отбор);

Пока Результат.Следующий() Цикл
Сообщить(Результат.Наименование + ": " + Результат.Цена);
КонецЦикла;

// Альтернативный способ (создание новой таблицы с отфильтрованными данными)
ФильтрованнаяТаблица = Таблица.Скопировать(Отбор);

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

Отбор = Новый Структура();
Отбор.Вставить("Количество", Новый УсловиеОтбора("> 5"));
Отбор.Вставить("ДатаПоступления", Новый УсловиеОтбора(">= '01.01.2023'"));

Поиск строк по значению

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

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

// Поиск по нескольким колонкам
НайденнаяСтрока = Таблица.НайтиСтроку(
Новый Структура("Наименование,Количество", "Мышь", 15)
);

Метод Найти() возвращает Неопределено, если строка не найдена, поэтому всегда проверяйте результат перед использованием.

Что делать если поиск работает медленно?

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

1. Предварительно отсортируйте таблицу по колонке, по которой ищете;

2. Используйте двоичный поиск с помощью метода НайтиСтрокуНачинаяС() (требует отсортированной таблицы);

3. Для сложных условий создайте индекс с помощью метода Индексировать() (доступно в последних версиях платформы).

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

Рассмотрим реальные сценарии, в которых таблицы значений незаменимы.

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

Допустим, нам нужно создать прайс-лист с товарами, ценами и остатками:

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

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

// 3. Сортируем по наименованию
ПрайсЛист.Сортировать("Наименование");

// 4. Выводим результат (например, в табличный документ)
ТабДок = Новый ТабличныйДокумент;
ТабДок.Вывести(ПрайсЛист);

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

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

// 1. Получаем данные из внешнего источника (например, Excel)
ВнешниеДанные = ПолучаемДанныеИзExcel();

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

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

// 4. Создаем документ и заполняем его табличную часть
Док = Документы.РеализацияТоваровУслуг.СоздатьДокумент();
Док.ТабличнаяЧастьТовары.Загрузить(ТаблицаДокумента);
Док.Записать();

Пример 3: Агрегация данных для отчета

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

// 1. Получаем данные запросом Запрос = Новый Запрос; Запрос.Текст = "ВЫБРАТЬ | Номенклатура.Наименование КАК Наименование, | СУММА(ДокументРеализацияТоваровУслугТовары.Количество) КАК Продано |ИЗ | Документ.РеализацияТоваровУслуг.Товары КАК ДокументРеализацияТоваровУслугТовары |СГРУППИРОВАТЬ ПО | Номенклатура.Наименование"; РезультатЗапроса = Запрос.Выполнить(); ВыборкаРезультата = РезультатЗапроса.Выбрать(); // 2. Загружаем в таблицу значений для дальнейшей обработки ТаблицаОтчета = Новый ТаблицаЗначений; ТаблицаОтчета.Загрузить(ВыборкаРезультата); // 3. Добавляем расчетный столбец (например, доля от общего количества) ОбщееКоличество = ТаблицаОтчета.Итог("Продано"); Для Каждого Строка Из ТаблицаОтчета Цикл Строка.Вставить("Доля", Строка.Продано / ОбщееКоличество * 100);

КонецЦикла;

💡

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

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

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

Ошибка 1: Попытка обращения к несуществующей колонке

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

// Неправильно (выдаст ошибку, если колонки "Скидка" нет)
Таблица.Колонки.Найти("Скидка").Тип = Новый ОписаниеТипов("Число");

// Правильно
Если Таблица.Колонки.Найти("Скидка") <> Неопределено Тогда
Таблица.Колонки.Найти("Скидка").Тип = Новый ОписаниеТипов("Число");
Иначе
Таблица.Колонки.Добавить("Скидка", Новый ОписаниеТипов("Число"));
КонецЕсли;

Ошибка 2: Изменение таблицы во время обхода

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

// Опасный код (может привести к ошибке)
Для Каждого Строка Из Таблица Цикл
Если Строка.Количество = 0 Тогда
Таблица.Удалить(Строка); // Ошибка! Коллекция изменяется во время обхода
КонецЕсли;
КонецЦикла;

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

// Безопасный вариант 2: работа с копией
ТаблицаКопия = Таблица.Скопировать();
Для Каждого Строка Из ТаблицаКопия Цикл
Если Строка.Количество = 0 Тогда
Таблица.Удалить(Строка);
КонецЕсли;
КонецЦикла;

Ошибка 3: Неучет регистра при поиске

По умолчанию поиск в таблицах значений чувствителен к регистру. Если вам нужно найти строку независимо от регистра, используйте функцию НРег():

// Поиск без учета регистра
НайденнаяСтрока = Таблица.НайтиСтроку(
Новый Структура("Наименование", НРег("монитор"))
);

Ошибка 4: Потеря данных при изменении типов колонок

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

// Безопасное изменение типа колонки
РезервнаяКопия = Таблица.Скопировать();
Колонка = Таблица.Колонки.Найти("Цена");
Колонка.Тип = Новый ОписаниеТипов("Строка");

// Если что-то пошло не так, можно восстановить данные
Если НужноВосстановить Тогда
Таблица.Очистить();
Таблица.Загрузить(РезервнаяКопия.Выгрузить());
КонецЕсли;

⚠️ Внимание: В последних версиях платформы 1С:Предприятие 8.3 появились новые методы работы с таблицами значений (например, Индексировать() для ускорения поиска). Однако их поддержка может отличаться в разных режимах (управляемое/обычное приложение). Перед использованием проверьте доступность метода в вашей конфигурации.

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

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

Способ 1: Использование методов массовой загрузки

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

// Медленный способ (для 10 000 строк будет долго)
Для Инд = 1 По 10000 Цикл
Строка = Таблица.Добавить();
Строка.Наименование = "Товар " + Инд;
Строка.Цена = Инд * 100;
КонецЦикла;

// Быстрый способ
Данные = Новый Массив;
Для Инд = 1 По 10000 Цикл
Данные.Добавить(Новый Структура("Наименование,Цена", "Товар " + Инд, Инд * 100));
КонецЦикла;
Таблица.Загрузить(Данные);

Разница в производительности может достигать 10-50 раз при работе с большими объемами данных.

Способ 2: Отключение автосортировки

Если вам не нужна автоматическая сортировка при добавлении строк, отключите ее:

Таблица.АвтоСортировка = Ложь;

Способ 3: Использование колонок с простыми типами

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

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

// Быстрее (хранение только идентификатора или наименования)
Таблица.Колонки.Добавить("НоменклатураID", Новый ОписаниеТипов("Строка"));

Способ 4: Разделение больших таблиц

Если таблица становится слишком большой (десятки тысяч строк), рассмотрите возможность разделения ее на несколько меньших таблиц. Например, вместо одной таблицы с данными за год можно создать 12 таблиц по месяцам.

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

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

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Товары.Ссылка

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