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