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

Другое · 7 мин

Создание нового перечисления в 1С:Предприятие

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

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

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

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

Где находится перечисление и как его добавить

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

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

Настройка значений перечисления

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

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

Порядок создания перечисления
  1. 1
    Открыть дерево конфигурации и раздел «Перечисления»
  2. 2
    Добавить новый объект и задать имя и синоним
  3. 3
    Открыть список значений и добавить необходимые элементы
  4. 4
    Сохранить конфигурацию и выполнить обновление базы данных
  5. 5
    Проверить доступность типа в атрибутах и формах

Где и как использовать созданное перечисление

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

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

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

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

Открытие списка значений в форме объекта
Норма

Все значения доступны для выбора

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

Список пуст или значение не сохраняется

Сохранение тестовой записи с каждым значением
Норма

Запись создается без ошибок

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

Ошибка при сохранении или ссылка теряется

Код, обращающийся к перечислению
Норма

Компилируется и работает

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

Ошибка компиляции или неопознанное имя

Проверка результата и границы безопасных изменений

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

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

Типичные ошибки при работе с перечислениями

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

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

Типичные ошибки
01
Использование перечисления вместо справочника для часто меняющегося списка
02
Переименование или удаление значения, на которое уже есть ссылки в данных
03
Отсутствие обновления базы после изменения конфигурации

Как выбрать между перечислением и справочником

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

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

Итог

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

Перечисление создается в Конфигураторе, заполняется разработчиком, обновляется в базе и используется в атрибутах и коде; значения не добавляются пользователем в режиме предприятия.

Часто задаваемые вопросы

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

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

Что будет, если удалить значение перечисления, на которое ссылаются данные?

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

Нужно ли перезапускать 1С:Предприятие после создания перечисления?

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

Можно ли использовать перечисление в отчетах и обработках?

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

Когда лучше выбрать справочник вместо перечисления?

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