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

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

Ключевой момент, который нужно понять сразу: массив — это линейный набор значений, а таблица значений — двумерная структура «строки × колонки». Поэтому массив можно поместить в таблицу либо как колонку (каждый элемент — отдельная строка), либо как строку (каждый элемент — значение своей колонки), либо как значение одной ячейки, если колонка имеет произвольный тип. Ниже разобраны все три сценария с готовым кодом.

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

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

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

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

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

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

МассивТоваров = Новый Массив;
МассивТоваров.Добавить(Справочники.Номенклатура.НайтиПоКоду("0000001"));
МассивТоваров.Добавить(Справочники.Номенклатура.НайтиПоКоду("0000002"));

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

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

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

ТЗ.Очистить();
ТЗ.ЗагрузитьКолонку(МассивТоваров, "Номенклатура");
// Проверка: количество строк должно совпасть с размером массива
Если ТЗ.Количество() <> МассивТоваров.Количество() Тогда
    ВызватьИсключение "Размеры не совпадают";
КонецЕсли;

Построчное добавление элементов массива через цикл

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

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

Если элементы массива — структуры или соответствия (типичный случай после разбора JSON или строки файла), значения берутся из свойств элемента. Перед присваиванием полезно проверять наличие свойства, потому что обращение к отсутствующему свойству структуры вызывает исключение.

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

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

Размещение массива в одной ячейке таблицы

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

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

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

Добавление массива как одной строки таблицы

Обратная задача: элементы массива должны стать значениями колонок одной строки — например, массив получен разбором строки CSV через СтрРазделить(). Здесь порядок элементов массива жёстко привязан к порядку колонок, и заполнение идёт по индексу.

Части = СтрРазделить(СтрокаФайла, ";");
НоваяСтрока = ТЗ.Добавить();
НоваяСтрока.Номенклатура = Справочники.Номенклатура.НайтиПоКоду(Части[0]);
НоваяСтрока.Количество   = Число(Части[1]);
НоваяСтрока.Комментарий  = Части[2];

Перед обращением по индексу обязательно проверяйте размер массива: Если Части.Количество() >= 3 Тогда ... КонецЕсли;. Строки файлов часто содержат пустые хвосты или лишние разделители, и обращение к несуществующему индексу прерывает выполнение всей обработки.

Сравнение способов и выбор под задачу

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

По производительности разница между ЗагрузитьКолонку и циклом на типовых объёмах (тысячи строк) несущественна. На очень больших объёмах выигрыш даёт не выбор метода добавления, а отказ от промежуточных массивов вообще — например, заполнение таблицы напрямую из запроса через Запрос.Выполнить().Выгрузить().

Проверка результата и типичные ошибки

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

Наиболее частые ошибки при этой задаче собраны ниже — почти каждая встречается в реальных доработках.

Отдельно стоит упомянуть типовую ситуацию с управляемыми формами: таблица значений как реквизит формы фактически хранится как ДанныеФормыКоллекция, и метод ЗагрузитьКолонку у неё отсутствует. Там работает только цикл с Добавить() либо преобразование через РеквизитФормыВЗначение(), загрузку и обратное ЗначениеВРеквизитФормы().

Частые вопросы