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