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

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

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

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

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

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

Типизация колонок — шаг, который часто пропускают, и зря. Если тип не указан, колонка принимает значения любого типа, и при загрузке из массива туда попадёт то, что лежит в массиве, без контроля. Если указать ОписаниеТипов, платформа будет приводить значения к заданному типу: строка «123» в числовую колонку превратится в число, а неприводимое значение даст ошибку или значение по умолчанию в зависимости от контекста.

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

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

Загрузка одномерного массива через ЗагрузитьКолонку

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

МассивАртикулов = Новый Массив;
МассивАртикулов.Добавить("АРТ-001");
МассивАртикулов.Добавить("АРТ-002");
МассивАртикулов.Добавить("АРТ-003");

ТЗ = Новый ТаблицаЗначений;
ТЗ.Колонки.Добавить("Артикул", Новый ОписаниеТипов("Строка", , Новый КвалификаторыСтроки(50)));
ТЗ.ЗагрузитьКолонку(МассивАртикулов, "Артикул");

После выполнения в таблице будет три строки, колонка «Артикул» заполнена. Остальные колонки, если они есть, останутся пустыми — их можно заполнить вторым вызовом ЗагрузитьКолонку другим массивом той же длины.

Ограничение метода: если таблица уже содержит строки и их больше, чем элементов в массиве, «лишние» строки получат пустое значение в загружаемой колонке, но не удалятся. Если строк меньше, чем элементов массива, недостающие строки будут добавлены. Поэтому ЗагрузитьКолонку корректно работает либо с пустой таблицей, либо при строгом контроле длин массивов.

ТЗ.ЗагрузитьКолонку(МассивЗначений, "ИмяКолонки");

Загрузка массива структур циклом

На практике чаще встречается массив структур: каждый элемент содержит несколько полей, например результат чтения JSON или файла обмена. Здесь ЗагрузитьКолонку не поможет — нужен цикл с добавлением строк.

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

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

Цикл даёт полный контроль над переносом: можно пропускать невалидные элементы, преобразовывать значения, искать ссылки по коду вместо переноса строк. Например, если в массиве лежит код номенклатуры, а в таблице нужна ссылка, поиск выполняется прямо внутри цикла запросом или методом НайтиПоКоду.

1. 1
   Создайте таблицу значений и опишите колонки с типами
2. 2
   Проверьте, что массив не пустой и элементы имеют ожидаемую структуру
3. 3
   В цикле Для Каждого добавляйте строку методом Добавить()
4. 4
   Заполняйте поля строки вручную или через ЗаполнитьЗначенияСвойств
5. 5
   После цикла проверьте количество строк и содержимое первых записей

Загрузка массива массивов и данных из файлов

Третий распространённый случай — массив, элементами которого являются другие массивы. Так выглядят данные после построчного чтения CSV-файла, разбора строки по разделителю или чтения табличного документа. Здесь обращение к полям идёт по индексу, а не по имени.

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

Главный риск этого подхода — жёсткая привязка к порядку колонок источника. Если в файле поменяют местами колонки, код молча запишет артикул в количество или упадёт с ошибкой преобразования. Защита — проверка длины вложенного массива перед обращением по индексу и, при возможности, чтение заголовков из первой строки файла с построением соответствия «имя колонки → индекс».

Все значения из текстового файла приходят строками. Явное преобразование через Число(), Дата() или приведение типов колонкой таблицы обязательно, иначе дальнейшие сравнения и итоги по таблице будут работать некорректно: строки «10» и «9» сортируются не так, как числа 10 и 9.

Сравнение способов загрузки

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

Проверка результата после загрузки

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

Если ТЗ.Количество() <> МассивДанных.Количество() Тогда
ВызватьИсключение "Количество строк таблицы не совпадает с размером массива";
КонецЕсли;

Для визуальной проверки в отладке таблицу значений можно посмотреть через «Вычислить выражение» — платформа покажет её в табличном виде. В управляемых формах таблицу выводят в реквизит формы типа «ТаблицаЗначений» с динамическим созданием колонок, что удобно для тестирования обработок загрузки.

Типичные ошибки и ограничения

Самая частая ошибка — попытка загрузить массив в несуществующую колонку: ЗагрузитьКолонку с опечаткой в имени колонки падает с ошибкой «Колонка не найдена». Имя проверяется на этапе выполнения, а не компиляции, поэтому опечатки всплывают только в рантайме.

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

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

FAQ