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

Другое · 8 мин

Коллекции в 1С: что это, виды и способы работы

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

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

Не каждый список в 1С является коллекцией в строгом смысле. К типовым вариантам относятся массивы, списки значений, таблицы значений и объекты коллекций значений. Разница между ними важна, потому что доступ к элементам, порядок хранения и допустимые операции различаются.

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

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

Что понимают под коллекциями в 1С

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

В языке встроенной коллекцией может быть массив, где элементы нумеруются с одного, список значений с парой «ключ — значение», таблица значений с колонками и строками, а также специализированный объект коллекции. У каждого вида есть свой набор методов: добавление, очистка, поиск, копирование и удаление.

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

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

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

Массив

Подходит для упорядоченного перебора, доступ по индексу, неудобен для поиска по ключу.

Список значений

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

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

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

Объект коллекции значений

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

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

Как создавать, заполнять и читать коллекции

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

Порядок работы с коллекцией
  1. 1
    Определите вид коллекции по задаче: перебор, поиск по ключу или табличный вывод.
  2. 2
    Создайте коллекцию и добавьте элементы из источника данных.
  3. 3
    Проверьте количество элементов и отсутствие неожиданных дублей.
  4. 4
    Обращайтесь к элементам по индексу, ключу или строке таблицы.
  5. 5
    После изменений убедитесь, что данные записаны корректно.

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

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

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

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

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

Соответствует ожидаемому числу строк или записей

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

Меньше или больше ожидаемого, возможны потери или дубли

Доступ по ключу
Норма

Элемент находится без ошибки

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

Ошибка отсутствующего ключа или неверного индекса

Сохранение данных
Норма

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

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

Данные возвращаются к исходному состоянию

Как выбрать подходящий вид и проверить результат

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

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

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

Ограничения, ошибки и безопасная работа

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

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

Ещё одна ошибка — использование ссылки на элемент после очистки коллекции. Такая ссылка становится недействительной, и попытка обратиться к реквизитам объекта приведёт к сбою. Перед очисткой стоит завершить все операции с полученными элементами.

Типичные ошибки
01
Удаление элементов во время перебора коллекции приводит к пропуску строк или ошибке индекса.
02
Обращение к элементу после очистки коллекции вызывает сбой из-за недействительной ссылки.
03
Использование неподходящего вида коллекции замедляет работу и усложняет поддержку кода.

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

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

Итог

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

Коллекции в 1С объединяют однородные данные, но отличаются способом доступа и операциями. Выбирайте вид по задаче, проверяйте результат и не меняйте коллекцию во время перебора.

Чем массив отличается от списка значений?

Массив хранит элементы по порядковому номеру и подходит для последовательного перебора. Список значений хранит пары «ключ — значение» и удобен для быстрого поиска по коду или наименованию, но требует уникальности ключей.

Когда лучше использовать таблицу значений?

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

Можно ли удалять элементы коллекции во время цикла перебора?

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

Что проверить после заполнения коллекции?

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

Нужно ли тестировать изменения коллекций на копии базы?

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