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

Другое · 7 мин

Значение перечисления в 1С как в конфигураторе

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

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

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

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

Что такое значение перечисления в 1С

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

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

Как получить значение перечисления как в конфигураторе

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

Чтобы использовать значение в модуле, обратитесь к нему по полному имени: Перечисления.ИмяПеречисления.ИмяЭлемента. В форме или отчёте можно присвоить это значение реквизиту типа перечисления, сравнить с текущим значением или передать в параметр запроса.

Порядок действий
  1. 1
    Откройте конфигуратор и найдите нужное перечисление
  2. 2
    Запишите точное имя перечисления и элемента
  3. 3
    В коде обращайтесь через Перечисления.Имя.Элемент
  4. 4
    Проверьте компиляцию и результат в режиме предприятия

Сравнение и использование в коде

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

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

1c
Если Документ.ВидОперации = Перечисления.ВидыОпераций.Приход Тогда
    // действие
КонецЕсли;

Сценарий: заполнение реквизита в форме

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

Сценарий: использование в запросе

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

Получение значения по имени и синониму

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

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

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

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

Компиляция конфигурации
Норма

Ошибок нет

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

Ошибки отсутствуют или неясные ссылки на элементы

Отображение в форме
Норма

Показан синоним элемента

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

Пустое значение или техническое имя

Логика условий
Норма

Срабатывает по ожидаемым значениям

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

Условие не срабатывает при видимом совпадении

Ограничения и риски при изменении перечисления

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

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

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

Частые ошибки и проверка результата

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

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

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

Обращение по имени элемента

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

Поиск по синониму

Подходит для отображения, но может быть неточным при совпадающих синонимах

Использование порядкового номера

Не рекомендуется для бизнес-логики, так как зависит от порядка в конфигурации

Как проверить результат перед вводом в эксплуатацию

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

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

Итог

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

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

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

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

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

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

Безопасно ли добавлять новые элементы перечисления?

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

Зависит ли значение от порядка элементов в конфигураторе?

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