Другое · 7 мин
Создание набора в 1С: выбор типа и порядок действий
Практическая инструкция по созданию набора в 1С: выбор типа, набор записей, таблица значений, проверка результата и типичные ошибки для самостоятельной работы.
В 1С слово «набор» может относиться к разным объектам: набору записей регистра, таблице значений, массиву или списку значений. Перед созданием нужно определить, где данные будут использоваться: в регистре накопления или сведений, в отчёте, в обработке или в временных расчётах. От выбора зависит способ создания, порядок сохранения и доступные методы.
Создание набора не всегда требует изменения конфигурации. Если достаточно стандартного объекта языка, можно открыть модуль объекта, формы или общего модуля и создать нужный тип программно. Для данных, которые должны остаться после закрытия программы, подойдёт набор записей регистра с записью в базу; для промежуточных расчётов обычно достаточно таблицы значений в памяти.
Работа с наборами связана с правами доступа, блокировками и целостностью информации. Неправильная запись в регистры может привести к несоответствию остатков, поэтому изменения лучше проверять на копии базы и, где это возможно, выполнять внутри транзакции.
Как выбрать тип набора для задачи
Если нужно работать с записями регистра сведений или накопления, используйте набор записей. Он связан со структурой регистра, позволяет читать, добавлять, изменять и удалять записи, а затем записывать изменения в базу. Такой набор подходит, когда данные должны быть доступны другим пользователям и сохраняться надолго.
Для временных расчётов, импорта, отчётов или передачи данных между формами удобнее таблица значений, массив или список значений. Таблица значений подходит для структурированных данных с колонками и строками, массив — для упорядоченного набора однотипных значений, список значений — для пар «значение — представление». Эти объекты существуют только в памяти сессии, если не сохранить их отдельно.
- 1Определите, нужно ли сохранять данные после закрытия сессии
- 2Уточните, связаны ли данные с регистром или документом
- 3Выберите набор записей для регистров, таблицу значений для отчётов, массив или список для простых наборов
- 4Проверьте права доступа перед записью в регистр
Создание набора записей регистра
Набор записей обычно создаётся через менеджер нужного регистра. В коде указывается регистр, после чего к набору можно добавлять строки, заполнять измерения, ресурсы и реквизиты. Важно соблюдать структуру регистра: не все поля можно заполнять произвольными значениями, некоторые определяются настройками конфигурации.
После заполнения набора вызывается метод записи. Если запись отменяется или вызывается исключение, изменения могут не примениться. В многопользовательском режиме возможны блокировки, поэтому длительные операции с большими наборами лучше выполнять осторожно и в подходящее время.
Таблица значений, массив и список значений
Таблица значений создаётся путем добавления колонок и строк. Каждая строка может содержать значения разных типов, что удобно для промежуточных расчётов и выгрузки в отчёт. Массив подходит, если нужна простая последовательность элементов, а список значений — когда требуется отображать пользователю понятное представление при скрытом коде.
Объекты в памяти не требуют записи в базу, но и не сохраняются автоматически после завершения работы. Если данные нужны при следующем запуске, их следует сохранить в регистр, документ, справочник или другой постоянный объект. Не путайте временное заполнение таблицы с постоянным хранением.
Сохранение, проверка и права доступа
Результат создания набора проверяется по количеству строк, заполненности обязательных реквизитов и возможности чтения данных после записи. Для набора записей убедитесь, что записи видны в регистре и не вызывают ошибок при проведении документов. Для таблицы значений проверьте, что колонки и типы данных соответствуют ожидаемой структуре.
Права доступа могут ограничивать создание и запись наборов даже если код написан верно. Если пользователь не видит созданные данные, причина может быть не в коде, а в ролях и правах. Перед массовыми изменениями рекомендуется убедиться в наличии резервной копии и согласовать действия с администратором информационной базы.
Типичные ошибки и ограничения
Одна из частых ошибок — использование набора записей для простых временных расчётов. Это усложняет код и создаёт лишнюю нагрузку на базу. Другая ошибка — попытка записать в регистр значения, не соответствующие его структуре, что приводит к ошибкам или некорректным остаткам.
Ограничения могут зависеть от вида приложения: толстый клитон, тонкий клиент или веб-интерфейс могут по-разному поддерживать работу с формами и наборами. Также не стоит создавать набор в цикле без необходимости, если достаточно одной таблицы значений, так как это снижает производительность и усложняет отладку.
Как проверить результат
Соответствует ожидаемому
Ноль строк или неполное заполнение
Записи доступны после записи
Данные не сохраняются или вызывают ошибку
Пользователь видит и может использовать набор
Доступ ограничен ролями
Альтернативы и отказ от создания набора
Иногда набор создавать не нужно: можно использовать уже существующий отчёт, запрос или встроенную функцию выбора. Если задача заключается в отображении данных пользователю, подойдет форма со списком или динамический список без программного набора. Это снижает объём кода и количество возможных ошибок.
Если данные нужны только в рамках одной операции, лучше использовать локальную таблицу значений или массив. Если данные должны быть доступны другим разделам системы, выбирайте постоянное хранение в справочниках, документах или регистрах. Отказ от лишнего набора упрощает поддержку и делает поведение системы предсказуемее.
Что важно запомнить
Выбирайте тип набора по задаче, проверяйте права и структуру, временные объекты не сохраняются сами, а запись в регистры требует осторожности.
Чем отличается набор записей от таблицы значений?
Набор записей связан с регистром и позволяет сохранять изменения в базе, тогда как таблица значений обычно существует в памяти сессии и не записывается автоматически. Выбирайте набор записей для постоянных данных регистров, а таблицу значений — для промежуточных расчётов.
Можно ли создать набор без программирования?
В некоторых ситуациях достаточно настроек конфигурации, отчёта или динамического списка, но создание набора записей или таблицы значений с заполнением обычно требует кода в модуле объекта, формы или общего модуля. Без кода возможности ограничены стандартными средствами конфигурации.
Почему созданные данные не сохраняются?
Скорее всего, использовался временный объект в памяти, например таблица значений или массив, без записи в регистр, документ или справочник. Также запись может отменяться из-за ошибок, отсутствия прав или невызова метода сохранения.
Нужно ли делать резервную копию перед созданием набора?
Если планируется запись в регистры или массовое изменение данных, резервная копия и проверка на копии базы рекомендуются. Это помогает избежать несоответствия остатков и потери информации при ошибке в коде или правах доступа.