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

Другое · 7 мин

Как получить имя элемента перечисления в 1С

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

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

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

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

Когда внутреннее имя элемента перечисления нужно

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

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

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

Получение имени через свойство Имя

Самый прямой способ — обратиться к свойству Имя у ссылки на элемент перечисления. Синтаксис выглядит так: Перечисления.ИмяПеречисления.ИмяЭлемента.Имя. Результатом будет строка, совпадающая с именем, заданным в конфигураторе.

1c
ИмяЭлемента = Перечисления.ВидыНоменклатуры.Товар.Имя;

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

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

Представление, синоним и разница с именем

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

Когда использовать представление

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

Когда использовать синоним

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

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

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

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

Ссылка на элемент получена
Норма

Элемент существует и доступен

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

Ссылка неопределена или элемент отсутствует

Имя не пустое
Норма

Возвращена строка с именем

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

Пустая строка или ошибка выполнения

Имя совпадает с конфигуратором
Норма

Имя соответствует разработанному

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

Имя отличается или не найдено

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

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

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

Типичные ошибки
01
Сравнение представления вместо внутреннего имени ломается при переименовании синонима.
02
Обращение к свойству Имя у неопределённой ссылки вызывает ошибку выполнения.

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

Типичные ошибки и ограничения

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

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

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

Итог

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

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

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

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

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

Отличается ли имя элемента от его синонима?

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

Что делать, если свойство Имя возвращает пустую строку?

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

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

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

Зависит ли имя элемента от языка интерфейса?

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