К статье
Практический материал

Другое · 6 мин

Как ввести массив в 1С и работать с его элементами

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

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

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

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

Когда массив подходит, а когда выбрать другое

Массив оправдан, если достаточно одного списка и не нужно вести аналитику по колонкам. Он хорошо подходит для временных наборов в процедурах расчёта, выбора вариантов или передачи данных между формами.

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

Сравнение вариантов

Массив

Подходит для простых упорядоченных списков и временных расчётов

Таблица значений

Удобна для структурированных данных с несколькими колонками, но требует больше памяти

Справочник или регистр

Выбирайте для постоянного хранения и отчётности, а не для временной работы в коде

-->

Создание массива в модуле

Объявите переменную или укажите тип в параметре процедуры, затем создайте экземпляр. В коде это выглядит как присвоение результата оператора Новый Массив переменной. После этого массив существует, но не содержит элементов.

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

Порядок действий
  1. 1
    Объявите переменную или укажите тип в параметре процедуры
  2. 2
    Создайте экземпляр с помощью Новый Массив
  3. 3
    Добавьте элементы методом Добавить
  4. 4
    Проверьте количество элементов методом Количество

Ввод вручную в коде

Подходит, когда набор значений известен заранее и не меняется. Пропишите элементы явно методом Добавить. Такой способ прост, но при росте списка становится неудобным и требует правки кода.

Заполнение из таблицы значений или запроса

Часто массив формируется циклом по строкам таблицы значений или результату запроса. На каждой итерации извлекается нужное значение и добавляется в массив методом Добавить. Проверяйте, что источник не пуст, перед началом цикла.

Добавление, вставка и чтение элементов

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

Чтение элемента осуществляется по индексу в квадратных скобках. Индексация начинается с нуля, поэтому первый элемент имеет индекс 0, а последний — Количество() минус 1. Обращение к несуществующему индексу вызывает ошибку выполнения.

Контрольные точки

Как проверить результат

Количество элементов после заполнения
Норма

Соответствует числу добавленных значений

Тревожный признак

Ноль или несовпадает с ожидаемым

Доступ к первому и последнему элементу
Норма

Возвращаются значения без ошибки

Тревожный признак

Ошибка выхода за границы массива

Поиск известного значения
Норма

Метод Найти возвращает индекс элемента

Тревожный признак

Возвращает неопределённое значение, элемент отсутствует

Проверка результата и границы индексов

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

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

Типичные ошибки
01
Обращение к индексу, равному или большему количества элементов, вызывает ошибку выполнения
02
Неинициализированная переменная вместо массива делает невозможным добавление элементов
03
Смешивание разных типов без необходимости усложняет отбор, сортировку и отчёты

-->

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

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

Массив может хранить значения разных типов, но это не всегда целесообразно. Однородные наборы проще проверять, сортировать и выводить в отчёты. Помните также, что массив не заменяет полноценную базу данных и не подходит для постоянного хранения больших массивов информации.

Безопасная работа с конфигурацией и данными

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

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

Итог

Что важно запомнить

Массив создаётся через Новый Массив, заполняется методами добавления, а доступ к элементам требует проверки индекса и количества.

Как создать пустой массив в 1С?

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

Как получить элемент по индексу и чего избежать?

Обращайтесь к массиву через квадратные скобки с индексом, начиная с нуля. Перед доступом убедитесь, что индекс находится в интервале от 0 до Количество() минус 1, иначе возникнет ошибка выполнения.

Чем массив отличается от таблицы значений?

Массив представляет собой один упорядоченный список значений, а таблица значений содержит строки с несколькими колонками и типами. Для аналитики и отчётов удобнее таблица значений, для простого временного списка — массив.

Что делать, если массив не заполняется или элемент недоступен?

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

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

Технически массив позволяет хранить разные типы, но это усложняет обработку, отбор и вывод в отчёты. Лучше использовать однородные наборы, если нет специальной необходимости в смешанных данных.