Как заполнить массив в 1С: 5 способов с примерами кода

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

Мы разберёмся, когда лучше использовать Добавить(), а когда — Вставить(), почему динамические массивы могут тормозить при больших объёмах данных, и как обойти ограничения платформы при работе с многомерными структурами. Особое внимание уделим недокументированным особенностям поведения массивов при сетевой работе, которые проявляются только в распределённых базах.

Если вы новичок, начните с первых двух разделов — там объяснены базовые концепции с визуальными примерами. Опытным разработчикам будет полезен раздел про оптимизацию производительности и сравнительная таблица методов заполнения.

1. Что такое массив в 1С и зачем он нужен

Массив в 1С:Предприятие — это упорядоченная коллекция элементов, которые могут быть любого типа: числа, строки, даты, ссылки на справочники или даже другие массивы. В отличие от языков вроде Python или JavaScript, где массивы гибкие и динамичные по умолчанию, в 1С они имеют жёсткие правила работы, заложенные платформой.

Основные сценарии использования:

📊 Обработка пакетов данных: например, массовое изменение цен номенклатуры или загрузка справочников из Excel.
🔄 Промежуточное хранение: когда нужно временно сохранить результаты запроса для дальнейшей обработки.
📈 Агрегация данных: расчёт статистики, группировка значений перед выводом в отчёт.
🔗 Интеграция с внешними системами: подготовка данных для JSON/XML при обмене с сайтами или банками.

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

⚡ После завершения сеанса все несохранённые массивы пропадают.
💾 Для долговременного хранения нужно использовать ХранилищеЗначения или записывать данные в справочники/регистры.
🔄 При работе с большими массивами (>10 000 элементов) может возникать переполнение памяти, особенно в тонком клиенте.

2. Ручное заполнение массива: методы Добавить() и Вставить()

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

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

Пример кода для создания массива чисел:

МассивЧисел = Новый Массив;
// Добавим элементы в конец
МассивЧисел.Добавить(10);
МассивЧисел.Добавить(20);
МассивЧисел.Добавить(30);
// Вставим элемент на вторую позицию (индекс 1)
МассивЧисел.Вставить(1, 15);
// Результат: [10, 15, 20, 30]

Ключевые особенности:

📌 Индексация начинается с 0 (как в большинстве языков программирования).
🚫 Метод Вставить() работает медленнее Добавить(), потому что требует перемещения всех последующих элементов.
⚠️ При вставке по несуществующему индексу (например, Вставить(100, 5)) 1С не выдаст ошибку, а просто добавит элемент в конец.

Объявлен ли массив оператором "Новый Массив"?|

Правильно ли указаны индексы (начинаются с 0)?|

Нет ли лишних пробелов в строках (например, " Привет" вместо "Привет")?|

Учтена ли максимальная длина массива для текущей версии платформы?-->

⚠️ Внимание: В версиях 1С ниже 8.3.10 метод Вставить() мог приводить к неявным ошибкам при работе с массивами, содержащими Неопределён. Перед использованием проверьте актуальную версию платформы в Справка → О программе.

3. Заполнение массива данными из запроса

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

📋 Отфильтровать данные по сложным условиям, которые трудно выразить в SQL-подобном синтаксисе 1С.
🔄 Модифицировать значения перед сохранением (например, привести строки к верхнему регистру).
📊 Построить нестандартные отчёты с группировками, которые не поддерживаются штатными средствами.

Пример заполнения массива результатами запроса:

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

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

РезультатЗапроса = Запрос.Выполнить();
МассивДанных = Новый Массив;

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

Обратите внимание на нюансы:

🔹 Для каждой строки результата создаётся структура (ассоциативный массив), что удобно для дальнейшей работы с данными по именованным ключам.
🔹 Если в запросе много колонок (>20), лучше использовать Выгрузить() — это быстрее, чем ручное заполнение.
🔹 При больших объёмах данных (>50 000 строк) стоит разбивать запрос на пакеты с помощью ПакетныйЗапрос.

💡

Если вам нужно только количество строк в результате запроса, используйте РезультатЗапроса.Выбрать(); Количество = РезультатЗапроса.Выбранно(); — это работает в разы быстрее, чем загрузка всех данных в массив.

4. Динамическое заполнение массива в цикле

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

📌 Статический массив имеет фиксированный размер (задаётся при создании). В 1С его эмулируют с помощью Новый Массив(Размер).
📌 Динамический массив расширяется автоматически при добавлении элементов (по умолчанию в 1С).

Пример динамического заполнения массива данными из справочника:

СправочникКонтрагентов = Справочники.Контрагенты;
МассивКонтрагентов = Новый Массив;

Выборка = СправочникКонтрагентов.Выбрать();
Пока Выборка.Следующий() Цикл
// Добавим в массив только активных контрагентов
Если Выборка.ПометкаУдаления = Ложь Тогда
МассивКонтрагентов.Добавить(Выборка.Ссылка);
КонецЕсли;
КонецЦикла;

Типичные ошибки при динамическом заполнении:

❌ Утечка памяти: если в цикле создаются временные объекты (например, Структура) и не очищаются.
❌ Избыточные проверки: проверка Массив.Количество() на каждой итерации тормозит выполнение.
❌ Неучтённые NULL-значения: если в массив добавляется Неопределён, это может привести к ошибкам при сортировке.

⚠️ Внимание: При работе с распределёнными базами (УРИБ, УРБД) динамическое заполнение массивов в цикле может приводить к блокировкам транзакций. В таких случаях лучше использовать Объект.ПолучитьДанные() с последующей пакетной обработкой.

5. Оптимизация производительности: быстрые способы заполнения

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

Метод	Скорость	Память	Когда использовать
`Добавить()` в цикле	Низкая	Средняя	Массивы до 1 000 элементов
`ЗаполнитьЗначениями()`	Высокая	Низкая	Массивы с одинаковыми значениями
`Вставить()` с предварительным размером	Средняя	Низкая	Известен конечный размер массива
`Объединить()` массивов	Очень высокая	Высокая	Объединение нескольких больших массивов
`Выгрузить()` из запроса	Максимальная	Средняя	Работа с результатами запросов

Пример использования ЗаполнитьЗначениями() для инициализации массива:

// Создаём массив из 100 элементов, заполненных нулями
МассивНулей = Новый Массив(100);
МассивНулей.ЗаполнитьЗначениями(0);

// Создаём массив из 50 элементов со строкой "Пусто"
МассивСтрок = Новый Массив(50);
МассивСтрок.ЗаполнитьЗначениями("Пусто");

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

🔹 Используйте ВыгрузитьКолонку(), если нужна только одна колонка из результата запроса.
🔹 Для массовой обработки применяйте ПакетныйЗапрос с размером пакета 100–500 строк.
🔹 Избегайте вложенных циклов при заполнении многомерных массивов — это экспоненциально увеличивает время выполнения.

💡

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

6. Работа с многомерными массивами

В 1С нет встроенной поддержки многомерных массивов (как, например, в Python с его списками списков), но их можно эмулировать с помощью массивов, содержащих другие массивы. Это востребовано для:

📊 Построения матриц данных (например, таблиц продаж по регионам и периодам).
🔄 Реализации сложных алгоритмов (например, путь коммивояжёра для логистики).
📋 Хранения иерархических данных (дерево категорий товаров).

Пример создания двумерного массива (матрицы 3×3):

Матрица = Новый Массив;

// Создаём строки матрицы
Для СчетчикСтроки = 1 По 3 Цикл
Строка = Новый Массив;
// Заполняем строку элементами
Для СчетчикСтолбца = 1 По 3 Цикл
Строка.Добавить(СчетчикСтроки * СчетчикСтолбца);
КонецЦикла;
Матрица.Добавить(Строка);
КонецЦикла;

// Результат:
// [
//   [1, 2, 3],
//   [2, 4, 6],
//   [3, 6, 9]
// ]

Особенности работы с многомерными массивами:

🔹 Нет встроенных методов для работы с многомерными структурами — всё приходится реализовывать вручную.
🔹 Производительность падает квадратично при увеличении размерности (например, массив 100×100 обрабатывается в 10 000 раз медленнее, чем 10×10).
🔹 Для хранения разреженных матриц (где большинство элементов пустые) лучше использовать Структура или Соответствие.

Как ускорить работу с большими матрицами?

Для матриц размером более 100×100 рекомендуется:

1. Использовать одномерный массив с расчётом индекса по формуле: индекс = номерСтроки * количествоСтолбцов + номерСтолбца.

2. Разбивать обработку на пакеты с промежуточным сохранением в ХранилищеЗначения.

3. Применять ленточный алгоритм (block processing), если матрица симметричная.

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

Даже опытные разработчики сталкиваются с неочевидными проблемами при работе с массивами. Вот самые распространённые:

🔸 Путаница с индексацией: попытка обратиться к элементу с индексом, равным Массив.ВГраница(), приводит к ошибке (последний индекс на 1 меньше).
🔸 Изменение массива в цикле: если в цикле Для каждого модифицировать массив (добавлять/удалять элементы), это приведёт к непредсказуемому поведению.
🔸 Копирование ссылок, а не значений: при присваивании Массив2 = Массив1 копируется только ссылка, а не данные. Для глубокого копирования нужно использовать Клонировать().
🔸 Неучтённые типы данных: если в массиве смешаны числа и строки, операции вроде Сортировать() могут работать некорректно.

Пример ошибочного кода и его исправление:

// ❌ ОШИБКА: изменение массива в цикле Для каждого
Массив = Новый Массив;
Массив.Добавить(1);
Массив.Добавить(2);
Массив.Добавить(3);

Для Каждый Элемент Из Массив Цикл
Если Элемент = 2 Тогда
Массив.Удалить(1); // Это приведёт к пропуску элемента 3!
КонецЕсли;
КонецЦикла;

// ✅ ПРАВИЛЬНО: использование обратного цикла
Для i = Массив.ВГраница() По 0 Шаг -1 Цикл
Если Массив[i] = 2 Тогда
Массив.Удалить(i);
КонецЕсли;
КонецЦикла;

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

8. Практическое применение: примеры из реальных задач

Рассмотрим несколько типичных задач, где массивы незаменимы:

📌 Задача 1: Массовое изменение реквизитов справочника

Допустим, нужно для всех номенклатурных позиций с определённой группой установить новый ставку НДС. Логика:

Выгрузить данные в массив.
Обработать массив (изменить значения).
Записать изменения обратно в базу.

МассивНоменклатуры = Новый Массив;
Выборка = Справочники.Номенклатура.Выбрать();
Пока Выборка.Следующий() Цикл
Если Выборка.Группа = Справочники.ГруппыНоменклатуры.Товары Тогда
Данные = Новый Структура;
Данные.Вставить("Ссылка", Выборка.Ссылка);
Данные.Вставить("СтавкаНДС", Справочники.СтавкиНДС.НДС20);
МассивНоменклатуры.Добавить(Данные);
КонецЕсли;
КонецЦикла;

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

📌 Задача 2: Построение отчёта с группировкой

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

Группировка = Новый Соответствие; // Ключ - "Регион.Месяц", значение - сумма

Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ Регион, МЕСЯЦ(Дата) КАК Месяц, Сумма(СуммаДокумента) КАК Сумма ИЗ Документ.РеализацияТоваровУслуг";

Результат = Запрос.Выполнить();
Пока Результат.Следующий() Цикл
Ключ = Результат.Регион + "|" + Результат.Месяц;
Если Группировка.СодержитКлюч(Ключ) Тогда
Группировка[Ключ] = Группировка[Ключ] + Результат.Сумма;
Иначе
Группировка.Вставить(Ключ, Результат.Сумма);
КонецЕсли;
КонецЦикла;

📌 Задача 3: Парсинг CSV-файла

При загрузке данных из CSV удобно сначала сохранить всё в массив, а затем валидировать и записывать в базу:

ТекстФайла = Новый ЧтениеТекста(ПутьКФайлу);
МассивСтрок = Новый Массив;

Пока ТекстФайла.ПрочитатьСтроку() Цикл
МассивСтрок.Добавить(ТекстФайла.ТекущаяСтрока);
КонецЦикла;

// Удаляем заголовок (первую строку)
Если МассивСтрок.Количество() > 0 Тогда
МассивСтрок.Удалить(0);
КонецЕсли;

💡

При работе с внешними данными (CSV, JSON) всегда сначала загружайте их в массив, а затем обрабатывайте. Это позволит избежать блокировок базы и ускорит валидацию.

FAQ: Ответы на частые вопросы

🔹 Как узнать размер массива?

Используйте метод Количество() для динамических массивов или свойство ВГраница() + 1 для статических. Пример:

Массив = Новый Массив;
Массив.Добавить(1);
Массив.Добавить(2);

Сообщить(Массив.Количество()); // Вернёт 2
Сообщить(Массив.ВГраница());   // Вернёт 1 (индекс последнего элемента)

🔹 Можно ли в массиве хранить разные типы данных?

Да, в 1С массивы не типизированы. Вы можете хранить в одном массиве числа, строки и даже объекты. Однако это может привести к ошибкам при сортировке или сравнении. Пример:

СмешанныйМассив = Новый Массив;
СмешанныйМассив.Добавить(100);          // Число
СмешанныйМассив.Добавить("Строка");    // Строка
СмешанныйМассив.Добавить(ТекущаяДата()); // Дата

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

🔹 Как отсортировать массив?

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

Массив = Новый Массив;
Массив.Добавить(3);
Массив.Добавить(1);
Массив.Добавить(2);

// Сортировка по возрастанию
Массив.Сортировать(НаправлениеСортировки.Возр);

// Пользовательская сортировка (по убыванию)
Массив.Сортировать(СравнениеПоУбыванию);

Функция СравнениеПоУбыванию(Значение1, Значение2)
Если Значение1 > Значение2 Тогда
Возврат -1;
ИначеЕсли Значение1 < Значение2 Тогда
Возврат 1;
Иначе
Возврат 0;
КонецЕсли;
КонецФункции

🔹 Как объединить два массива?

Используйте метод Добавить() в цикле или Объединить() (доступен с версии 8.3.14):

Массив1 = Новый Массив;
Массив1.Добавить(1);
Массив1.Добавить(2);

Массив2 = Новый Массив;
Массив2.Добавить(3);
Массив2.Добавить(4);

// Способ 1: через цикл
Для Каждый Элемент Из Массив2 Цикл
Массив1.Добавить(Элемент);
КонецЦикла;

// Способ 2: через Объединить() (быстрее)
МассивОбъединённый = Массив1.Объединить(Массив2);

🔹 Почему при добавлении в массив возникает ошибка "Индекс вне границ"?

Эта ошибка появляется в двух случаях:

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

Пример ошибочного кода:

Массив = Новый Массив(5); // Статический массив на 5 элементов
Массив.Вставить(10, "Ошибка"); // Индекс 10 вне границ (максимум 4)

Как заполнить массив в 1С: от простого к сложному