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

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

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

1. Базовый метод: добавление строк по одной

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

Основные шаги:

📌 Создать новую таблицу значений с нужной структурой колонок
🔄 В цикле добавлять новые строки и заполнять их значениями
💾 При необходимости сохранять изменения (для таблиц в формах)

Пример кода для создания таблицы с колонками "Наименование" и "Цена" и заполнения её тремя строками:

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

НоваяСтрока = ТаблицаТоваров.Добавить();
НоваяСтрока.Наименование = "Ноутбук";
НоваяСтрока.Цена = 45000;

НоваяСтрока = ТаблицаТоваров.Добавить();
НоваяСтрока.Наименование = "Смартфон";
НоваяСтрока.Цена = 28000;

НоваяСтрока = ТаблицаТоваров.Добавить();
НоваяСтрока.Наименование = "Наушники";
НоваяСтрока.Цена = 3500;

⚠️ Внимание: При работе с формами не забывайте использовать метод ОбновитьФорму() после изменения таблицы значений, чтобы изменения отобразились на экране. В противном случае пользователь не увидит добавленные строки до переоткрытия формы.

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

2. Оптимизированный подход: загрузка из массива

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

Для этого используется метод ЗагрузитьКолонку() или Загрузить() (для нескольких колонок одновременно). Рассмотрим оба варианта:

Пример с ЗагрузитьКолонку():

МассивНаименований = Новый Массив;
МассивНаименований.Добавить("Монитор");
МассивНаименований.Добавить("Клавиатура");
МассивНаименований.Добавить("Мышь");

МассивЦен = Новый Массив;
МассивЦен.Добавить(12000);
МассивЦен.Добавить(1800);
МассивЦен.Добавить(900);

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

// Добавляем пустые строки
Для Индекс = 1 По 3 Цикл
ТаблицаТоваров.Добавить();
КонецЦикла;

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

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

ДанныеДляЗагрузки = Новый Структура;
ДанныеДляЗагрузки.Вставить("Наименование", МассивНаименований);
ДанныеДляЗагрузки.Вставить("Цена", МассивЦен);

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

💡

Метод Загрузить() работает в 3-5 раз быстрее, чем последовательное добавление строк, при работе с таблицами более 1000 строк.

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

3. Использование конструктора таблицы значений

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

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

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

ТаблицаТоваров.Добавить(
Новый Структура("Наименование, Цена, Количество", "Ноутбук", 45000, 5)
);
ТаблицаТоваров.Добавить(
Новый Структура("Наименование, Цена, Количество", "Смартфон", 28000, 10)
);
ТаблицаТоваров.Добавить(
Новый Структура("Наименование, Цена, Количество", "Наушники", 3500, 15)
);

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

👍 Более компактный и читаемый код по сравнению с классическим подходом
🚀 Автоматическое создание колонок с указанными типами данных
🔧 Возможность гибкой настройки структуры таблицы

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

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

4. Заполнение таблицы через запрос к базе данных

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

Основные шаги:

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

Пример загрузки данных о товарах из справочника "Номенклатура":

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Номенклатура.Ссылка КАК Товар,
|   Номенклатура.Наименование КАК Наименование,
|   Номенклатура.ЦенаПродажи КАК Цена
|ИЗ
|   Справочник.Номенклатура КАК Номенклатура
|ГДЕ
|   НЕ Номенклатура.ПометкаУдаления";

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

Этот метод имеет несколько важных преимуществ:

🔍 Данные всегда актуальны (берутся непосредственно из базы)
📊 Автоматическое формирование структуры таблицы на основе полей запроса
🔄 Возможность применения фильтров, группировок и других операций SQL-подобного языка

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

Определить необходимые поля для выборки

Проверить права доступа к объектам базы

Оптимизировать запрос (индексы, условия отбора)

Ограничить количество возвращаемых строк при больших выборках

Обработать возможные ошибки выполнения запроса-->

5. Продвинутые техники: динамическое заполнение и рефлексия

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

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

// Получаем метаданные справочника
Метаданные = Метаданные.Справочники.Номенклатура;
ТаблицаТоваров = Новый ТаблицаЗначений;

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

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

Этот подход особенно полезен при:

🔄 Создании универсальных обработок, работающих с разными справочниками
📋 Автоматической генерации отчетов по произвольным структурам данных
🔧 Разработке систем интеграции с внешними источниками данных

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

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

Сравнение методов заполнения таблиц значений

Чтобы помочь вам выбрать оптимальный метод для вашей задачи, приведем сравнительную таблицу основных подходов:

Метод	Скорость	Сложность	Когда использовать	Ограничения
Добавление строк по одной	Низкая	Простой	Малые таблицы, простые сценарии	Медленная работа с большими объемами
Загрузка из массива	Средняя	Средняя	Данные уже в памяти, средние объемы	Требует предварительной подготовки данных
Конструктор таблицы	Высокая	Простой	Фиксированные структуры, 8.3.10+	Не работает в старых версиях
Запрос к базе	Высокая	Средняя	Работа с актуальными данными из БД	Требует прав доступа, может быть медленным при больших выборках
Динамическое заполнение	Низкая	Сложный	Универсальные обработки, интеграции	Сложность отладки, возможны ошибки типов

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

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

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

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

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

Таблица.Колонки.Добавить("Цена", Новый ОписаниеТипов("Число"));
НоваяСтрока = Таблица.Добавить();
НоваяСтрока.Цена = "Двадцать тысяч"; // ОШИБКА!

2. Работа с несуществующими колонками

Обращение к несуществующей колонке приведет к ошибке выполнения. Всегда проверяйте существование колонки перед обращением:

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

КонецЕсли;

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

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

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

4. Неучет пустых значений

Попытка записать NULL или Неопределено в колонку, не поддерживающую такие значения, вызовет ошибку. Всегда обрабатывайте пустые значения:

Значение = ПолучениеДанных();
Если Значение = Неопределено Тогда
Значение = 0; // или другое значение по умолчанию
КонецЕсли;

💡

Для отладки работы с таблицами значений используйте метод Выгрузить() — он позволяет быстро просмотреть содержимое таблицы в отладочной информации: Сообщить(Таблица.Выгрузить());

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

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

Самый эффективный способ очистки таблицы значений — использование метода Очистить():

Таблица.Очистить();

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

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

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

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

Для удаления колонки:

Таблица.Колонки.Удалить(Таблица.Колонки.Найти("СтараяКолонка"));

При этом все существующие данные в таблице сохранятся.

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

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

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

Можно сортировать по нескольким колонкам одновременно, указывая направление (Возр — по возрастанию, Убыв — по убыванию).

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

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

НайденныеСтроки = Таблица.НайтиСтроки(Новый Структура("Цена", 1000));
Для Каждого Строка Из НайденныеСтроки Цикл
// Обработка найденных строк
КонецЦикла;

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

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

Для экспорта в Excel используйте объект ЗаписьXML или специализированные библиотеки. Простой пример:

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

Для более сложных сценариев рекомендуется использовать библиотеку OneScript.Xlsx или аналогичные решения.

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