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

Другое · 9 мин

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

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

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

Важно сразу разделить два понятия: имя элемента перечисления и его синоним или представление. Имя — это идентификатор в конфигурации, например «Товар» или «Услуга», а синоним может отображаться пользователю и отличаться от имени. В зависимости от задачи нужно выбирать разный способ получения.

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

1. Отличие имени элемента от его представления

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

Например, элемент может называться «Товар», а отображаться пользователю как «Товар (розница)». Для логики, обмена и хранения лучше использовать именно имя, а для вывода пользователю — синоним или представление. Перед выбором метода уточните, какое значение требуется в конкретной задаче.

Нужно имя для кода или обменаРабота с идентификатором элемента

Предпочитайте чтение свойства Имя через метаданные или прямое сравнение с константой перечисления.

Нужно текст для пользователяРабота с представлением

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

Значение уже есть в переменнойНужно получить имя по существующему значению

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

2. Получение имени через преобразование в строку

Один из простейших способов — привести значение перечисления к строке. Во многих контекстах встроенный язык возвращает имя элемента при преобразовании значения перечисления к строковому типу. Это подходит для быстрой отладки и записи в журналы регистрации.

Пример в коде может выглядеть так: Строка(Перечисления.ВидыНоменклатуры.Товар). Результат зависит от реализации платформы и конфигурации, поэтому перед использованием в логике сверьте полученную строку с ожидаемым именем элемента.

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

Порядок действий для получения имени через строку
  1. 1
    Убедитесь, что переменная содержит значение перечисления, а не обычную строку.
  2. 2
    Примените преобразование значения к строке.
  3. 3
    Сравните результат с именем элемента из конфигуратора.
  4. 4
    Используйте строку только для отображения или логирования, не для критических расчетов без проверки.

3. Чтение имени через метаданные

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

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

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

Имя самого перечисления

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

Имя элемента по его значению

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

Сравнение вариантов получения имени

Преобразование в строку

Быстрый способ для известного значения, подходит для логов и отладки, но требует проверки результата.

Чтение через метаданные

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

Прямая ссылка на элемент

Надежнее всего, если имя элемента известно заранее и не меняется в конфигурации.

4. Поиск элемента перечисления по имени

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

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

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

5. Ограничения и контексты выполнения

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

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

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

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

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

Частая ошибка — принимать строковое представление за имя элемента и использовать его для сравнения или записи. Синоним может быть изменен пользователем или переведен, а имя остается стабильным. Для логики приложения полагайтесь на имя, для вывода — на представление.

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

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

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

Имя элемента получено верно

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

Получено представление, синоним или пустая строка

Значение перечисления найдено по имени из внешнего источника
Норма

Соответствие установлено, код работает

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

Ошибка выполнения или неверное значение

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

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

7. Рекомендации по выбору способа

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

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

Итог

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

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

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

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

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

Различаются ли имя элемента и то, что показано пользователю?

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

Что делать, если имя пришло из внешнего файла в виде строки?

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

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

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

Нужно ли проверять результат на копии базы?

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