ПеречислениеСсылка.<Имя перечисления>.Метаданные

Методы · Metadata

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

Синтаксис

Метаданные()
Полное описание, параметры и ограничения

ПеречислениеСсылка.<Имя перечисления>.Метаданные (EnumRef.<Enumeration name>.Metadata)

ПеречислениеСсылка.<Имя перечисления> (EnumRef.<Enumeration name>)

Метаданные (Metadata)

Доступен, начиная с версии 8.0.

Синтаксис:
Метаданные()
Возвращаемое значение:
Тип: ОбъектМетаданных: Перечисление.

Описание:

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

Доступность:

Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.

Использование в версии:

Доступен, начиная с версии 8.0.

Методическая информация

Практические примеры

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

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

Где и как запускать

Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.

Подготовка

  1. Создайте НОВУЮ пустую файловую учебную базу с именем корня конфигурации Учебная85. Не меняйте рабочие конфигурации ради этого примера.

  2. Перечисления → Добавить: УчебныйСтатус, синоним Учебный статус. Значения в порядке Черновик, Готов, Отменен; синонимы соответственно Черновик, Готов к проверке, Отменён.

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

  4. Код без директив вставляется в тело ВыполнитьПример() Экспорт серверного общего модуля УчебныеЗадачи. Полный модуль формы вставляется отдельно по подготовке формы.

Если Метаданные.Перечисления.Найти("УчебныйСтатус") = Неопределено Тогда
    ВызватьИсключение "Подготовьте собственное перечисление УчебныйСтатус";
КонецЕсли;
Менеджер = Перечисления.УчебныйСтатус;
Сообщить(Менеджер.Количество() = 3);
Готов = Менеджер.Готов;
Сообщить(Менеджер.Индекс(Готов) = 1);
Сообщить(Менеджер.Получить(1) = Готов);
Сообщить(Не Готов.Пустая());
Сообщить(Менеджер.ПустаяСсылка().Пустая());
Сообщить(Готов.Метаданные().Имя = "УчебныйСтатус");
Для Каждого Значение Из Менеджер Цикл
    Сообщить("Позиция " + Строка(Менеджер.Индекс(Значение)) + ": " + Строка(Значение));
КонецЦикла;
Сообщить(Готов = Перечисления.УчебныйСтатус.Готов);

Разбор по шагам

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

  2. Индекс начинается с нуля, поэтому Готов в подготовленном порядке имеет позицию 1.

  3. Строка(Готов) показывает представление Готов к проверке, а само значение имеет тип ПеречислениеСсылка.УчебныйСтатус.

  4. ПустаяСсылка не равна автоматически Черновику. Проверять заполнение нужно через Пустая.

  5. Сравниваем типизированные значения перечисления, не строки их изменяемых синонимов.

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

  1. Все семь булевых проверок Истина.

  2. Выводятся три позиции и синонимы в порядке подготовки.

  3. В рабочих документах и регистрах ничего не меняется.

Ожидаемый результат

Показаны реальные значения перечисления, их позиции и пустое состояние.

На что обратить внимание

  1. Позиция 1 может измениться при изменении порядка метаданных. Не храните индекс как долговременный внешний код.

  2. Синоним можно перевести/переименовать, поэтому сравнение Строка(Статус) = "Готов к проверке" хрупкое.

  3. УчебныйСтатус существует только в специально созданной схеме.

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

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.