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

Другое · 7 мин

Создание набора в 1С: выбор типа и порядок действий

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

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

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

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

Как выбрать тип набора для задачи

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

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

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

Создание набора записей регистра

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

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

Таблица значений, массив и список значений

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

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

Сохранение, проверка и права доступа

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

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

Типичные ошибки
01
Использование набора записей для временных расчётов вместо таблицы значений
02
Запись в регистр без проверки структуры и прав доступа
03
Создание больших наборов в цикле без необходимости

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

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

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

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

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

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

Соответствует ожидаемому

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

Ноль строк или неполное заполнение

Видимость записей в регистре
Норма

Записи доступны после записи

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

Данные не сохраняются или вызывают ошибку

Права доступа
Норма

Пользователь видит и может использовать набор

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

Доступ ограничен ролями

Альтернативы и отказ от создания набора

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

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

Итог

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

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

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

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

Можно ли создать набор без программирования?

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

Почему созданные данные не сохраняются?

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

Нужно ли делать резервную копию перед созданием набора?

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