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

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

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

1. Ручной ввод массива через конструктор значения

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

Чтобы создать массив вручную:

• 📌 Откройте модуль (например, модуль объекта или модуль формы) и введите код:
• 🔧 Используйте ключевое слово Новый Массив, а затем перечислите элементы через запятую в круглых скобках.
• 🔄 Для многомерных массивов вложите конструкторы друг в друга.

// Пример одомерного массива
МассивЦветов = Новый Массив("Красный","Зеленый","Синий");

// Пример двумерного массива (таблица 2x3)
МассивТаблица = Новый Массив(
Новый Массив(1, 2, 3),
Новый Массив(4, 5, 6)
);

⚠️ Внимание: При ручном вводе легко допустить ошибку с типами данных. Например, если вы укажете число без кавычек (123), а затем строку в кавычках ("123"), платформа 1С создаст массив с разными типами, что может привести к ошибкам при сортировке или сравнении. Всегда проверяйте типы элементов через ТипЗнч.

2. Заполнение массива через цикл

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

Рассмотрим дваных сценария:

• 🔢 Числовые последовательности: заполнение массива числами от 1 до N с шагом.
• 📋 Данные из справочников: перенос наименований или кодов из справочника Номенклатура в массив.

// Пример 1: массив чисел от 1 до 10
МассивЧисел = Новый Массив;
Для Сч = 1 По 10 Цикл
МассивЧисел.Добавить(Сч);
КонецЦикла;

// Пример 2: массив наименований номенклатуры
МассивНоменклатуры = Новый Массив;
Выборка = Справочники.Номенклатура.Выбрать;
Пока Выборка.Следующий Цикл
МассивНоменклатуры.Добавить(Выборка.Наименование);
КонецЦикла;

⚠️ Внимание: При работе с большими справочниками (тысячи записей) не заполняйте массив всеми элементами сразу — это приведет к перегрузке памяти. Вместо этого используйте Позиция = Выборка.НайтиПоНаименованию("Товар") для выборки только нужных данных.

3. Создание массива из результата запроса

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

Алгоритм действий:

1. Сформируйте запрос с нужными полями (используйте конструктор запросов для удобства).
2. Выполните запрос и получите результат в виде РезультатЗапроса.
3. Преобразуйте результат в массив с помощью метода Выгрузить или вручную через цикл.

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

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

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

📌 Метод Выгрузить возвращает массив массивов, где каждый вложенный массив соответствует строке результата запроса, а его элементы — колонкам. Если вам нужны только отдельные колонки (например, только наименования товаров), извлекайте их явно:

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

4. Импорт массива из внешних источников (Excel, JSON, XML)

В реальных задачах данные часто поступают извне: прайс-листы в Excel, ответы от API в формате JSON или выгрузки из других систем в XML. Платформа 1С 8.3 предоставляет инструменты для разбора этих форматов и преобразования их в массивы.

Рассмотрим триных сценария:

⚠️ Внимание: При чтении Excel через COMОбъект убедитесь, что на компьютере установлен Microsoft Excel соответствующей версии. Альтернатива — использование библиотеки EPPlus (требует подключения через внешние компоненты). Для JSON/XML проверяйте структуру данных: если формат не соответствует ожидаемому, платформа выбросит исключение.

Проверьте формат файла (xlsx или xls)

Убедитесь, что первая строка содержит заголовки колонок

Закройте файл Excel перед чтением в 1С

Сопоставьте типы данных (даты, числа, строки) с типами в 1С-->

5. Динамические массивы и коллекции

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

• 🔄 Динамические списки: ДинамическийСписок автоматически подгружает данные по мере прокрутки.
• 📊 Коллекции значений: Структура, Соответствие или Множество для уникальных данных.
• 🔗 Связанные массивы: когда один массив ссылается на элементы другого (например, массив ссылок на документы).

Пример использования Соответствия для хранения пар"ключ-значение":

СоответствиеЦен = Новый Соответствие;
СоответствиеЦен.Вставить("Товар1", 1000);
СоответствиеЦен.Вставить("Товар2", 1500);

// Получение значения по ключу
Цена = СоответствиеЦен.Получить("Товар1"); // Вернет 1000

📌 Ключевой вывод: Если вам нужно часто искать элементы по ключу (например, цены по коду номенклатуры), Соответствие работает быстрее, чем перебор массива в цикле. Для уникальных значений (например, список email-адресов без повторов) используйте Множество.

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

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

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

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

FAQ: Частые вопросы о массивах в 1С

Массив1 = Новый Массив(1, 2, 3);
Массив2 = Новый Массив(4, 5, 6);
Для Каждого Элемент Из Массив2 Цикл
Массив1.Добавить(Элемент);
КонецЦикла;

Массив1.Вставить(Массив1.ВерхняяГраница + 1, Массив2);

АссоциативныйМассив = Новый Соответствие;
АссоциативныйМассив.Вставить("ключ1","значение1");
АссоциативныйМассив.Вставить("ключ2", 100);
Значение = АссоциативныйМассив.Получить("ключ1");

Массив.Сортировать(НаправлениеСортировки.Убывание);

Массив.Сортировать(СравнитьПоДлине);
Функция СравнитьПоДлине(Знач1, Знач2)
Возврат?(СтрДлина(Знач1) > СтрДлина(Знач2), 1, -1);
КонецФункции

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

Сообщение ="";
Для Каждого Элемент Из Массив Цикл
Сообщение = Сообщение +?(Сообщение ="","",",") + Элемент;
КонецЦикла;
Сообщить(Сообщение);