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

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

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

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

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

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

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

📌 Создать новую таблицу значений с нужными колонками
🔄 Организовать цикл по элементам исходного массива
➕ Добавлять новую строку на каждой итерации
🔧 Заполнять значения колонок текущим элементом массива

Пример кода для массива структур:

МассивДанных = Новый Массив;
МассивДанных.Добавить(Новый Структура("Код,Наименование,Цена", 1, "Товар1", 100));
МассивДанных.Добавить(Новый Структура("Код,Наименование,Цена", 2, "Товар2", 200));

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

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

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

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

🔹 Простота реализации — понятно даже новичкам
🔹 Гибкость — можно обрабатывать элементы массива перед добавлением
🔹 Поддержка всех версий платформы 1С 8.x

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

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

Алгоритм работы:

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

Пример для массива чисел:

МассивЧисел = Новый Массив;
МассивЧисел.Добавить(10);
МассивЧисел.Добавить(20);
МассивЧисел.Добавить(30);

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

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

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

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

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

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

Создать таблицу значений с нужными колонками|

Подготовить отдельные массивы для каждой колонки|

Убедиться в совпадении типов данных массива и колонки|

Использовать ЗагрузитьКолонку() для каждой колонки-->

3. Работа с объектами 1С: выгрузка реквизитов

Часто требуется выгрузить в таблицу значений не просто массив примитивов, а реквизиты объектов (справочников, документов, регистров). В этом случае удобно использовать метод ВыгрузитьКолонку() или конструкцию с Выбрать().

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

// Получаем выборку номенклатуры
Выборка = Справочники.Номенклатура.Выбрать();

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

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

Для ускорения обработки больших выборок (более 1000 элементов) рекомендуется:

🚀 Использовать Выгрузить() с указанием нужных реквизитов
📊 Отключать автоматическое управление транзакциями
🔄 Применять пакетную обработку (по 100-500 элементов за итерацию)

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

Метод	Скорость	Память	Применимость
Цикл по элементам	Низкая	Средняя	Универсальный
ЗагрузитьКолонку()	Высокая	Низкая	Однородные данные
Выгрузить() для объектов	Средняя	Высокая	Реквизиты объектов
Конструктор запроса	Очень высокая	Оптимальная	Сложные выборки

4. Использование конструктора запросов

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

🔍 Выполнять фильтрацию и сортировку на уровне СУБД
🔗 Объединять данные из нескольких источников
📊 Агрегировать данные (группировки, суммы, средние)

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

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

Запрос.УстановитьПараметр("НачалоПериода", НачалоМесяца(ТекущаяДата()));
Запрос.УстановитьПараметр("КонецПериода", КонецМесяца(ТекущаяДата()));

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

Преимущества подхода:

🔹 Минимальная нагрузка на клиентскую часть
🔹 Возможность работы с большими объемами данных
🔹 Гибкая настройка выходной структуры

💡

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

5. Продвинутые техники: работа с большими данными

При обработке массивов размером более 10 000 элементов стандартные методы могут приводить к:

🐢 Замедлению интерфейса (зависаниям формы)
💥 Переполнению памяти
🛑 Прерыванию выполнения по таймауту

Для таких случаев применяют специализированные техники:

1. Пакетная обработка

Делим массив на части (пакеты) по 500-1000 элементов и обрабатываем их последовательно:

РазмерПакета = 1000;
КоличествоПакетов = Цел(МассивДанных.Количество() / РазмерПакета) + 1;

Для НомерПакета = 0 По КоличествоПакетов - 1 Цикл
Начало = НомерПакета * РазмерПакета;
Конец = Мин(Начало + РазмерПакета, МассивДанных.Количество()) - 1;

// Обрабатываем текущий пакет
ТекущийПакет = МассивДанных.Получить(Начало, Конец + 1);
ЗагрузитьПакетВТаблицу(ТекущийПакет, ОсновнаяТаблица);

// Освобождаем память
ТекущийПакет = Неопределено;
КонецЦикла;

2. Использование временных таблиц

Для очень больших массивов (100 000+ элементов) эффективнее:

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

3. Оптимизация типов данных

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

🔢 Для чисел используйте Число(10,2) вместо Число
📅 Для дат — Дата вместо Строка
🔤 Для строк ограничьте длину (например, Строка(100))

Как проверить потребление памяти

Откройте Администрирование → Журнал регистрации и включите отображение системных событий. Во время выполнения операции следите за параметром Использование памяти (МБ). Если значение превышает 80% от доступной памяти, оптимизируйте код.

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

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

1. Ошибка типов данных

Ситуация: При загрузке колонки возникает ошибка "Тип не совпадает с типом колонки".

Решение: Проверьте соответствие типов:

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

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

2. Пустые строки в таблице

Ситуация: Таблица создается, но строки не добавляются.

Причины и решения:

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

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

Ситуация: Операция выполняется более 30 секунд.

Решения:

🔹 Разбейте массив на пакеты (раздел 5)
🔹 Используйте ЗагрузитьКолонку() вместо поэлементного добавления
🔹 Отключите обновление экрана: ПриостановитьОбновлениеИнтерфейса(Истина);

4. Потеря данных при выгрузке

Ситуация: В таблице меньше строк, чем в исходном массиве.

Причины:

🔸 Ошибка в условии цикла (например, Пока Индекс < Массив.Количество() - 1)
🔸 Исключения в теле цикла → Оберните код в Попытка...Исключение
🔸 Фильтрация данных → Проверьте условия внутри цикла

💡

Всегда проверяйте количество строк в результирующей таблице сразу после выгрузки. Это поможет быстро обнаружить потерю данных: Если Таблица.Количество() <> Массив.Количество() Тогда...

FAQ: Частые вопросы по выгрузке массивов

Как выгрузить массив структур с вложенными массивами?

Для структур с вложенными массивами используйте сериализацию в строку (например, JSONЗапись) или создайте отдельные колонки для каждого элемента вложенного массива:

Для Каждого Элемент Из МассивСтруктур Цикл
НоваяСтрока = Таблица.Добавить();
НоваяСтрока.ОсновныеДанные = JSONЗапись.Записать(Элемент.ОсновныеПоля);
// Для вложенного массива "Дополнительно"
Если Элемент.Дополнительно.Количество() > 0 Тогда
НоваяСтрока.ДопИнформация = JSONЗапись.Записать(Элемент.Дополнительно);
КонецЕсли;
КонецЦикла;

В 1С 8.3.18+ можно использовать тип Произвольный для колонок с комплексными данными.

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

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

Пример без цикла:

Таблица.ЗагрузитьКолонку(МассивЧисел, "Значение");

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

Используйте метод ВыгрузитьКолонку() для отдельных колонок или организуйте обратный цикл:

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

Для выгрузки всей таблицы в массив структур:

МассивСтруктур = Таблица.Выгрузить();

Почему при выгрузке теряются русские символы?

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

Убедитесь, что тип колонки — Строка без ограничения длины или с достаточным запасом (например, Строка(255))
Проверьте кодировку исходных данных (должна быть UTF-8 для 1С 8.3)
При экспорте/импорте данных используйте параметры кодировки: Текст = Новый Текст(ДвоичныеДанные, КодировкаТекста.UTF8);

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

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

🔹 Объявляйте таблицу значений с ключевым словом НаСервере
🔹 Для больших данных используйте НаСервереБезКонтекста
🔹 Передавайте массивы по ссылке, чтобы избежать копирования

Пример:

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

КонецПроцедуры

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