Тип: Строка. Произвольная строка символов. Как правило, расшифровывает и поясняет имя объекта метаданных.
Полное описание, параметры и ограничения
ОбъектМетаданных: ЗначениеПеречисления.Комментарий (MetadataObject: EnumValue.Comment)
ОбъектМетаданных: ЗначениеПеречисления (MetadataObject: EnumValue)
Комментарий (Comment)
Доступен, начиная с версии 8.1.
Использование:
Только чтение.
Описание:
Тип: Строка.
Произвольная строка символов. Как правило, расшифровывает и поясняет имя объекта метаданных.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.1.
Методическая информация
Практические примеры
Проверить имя и владельца конкретного значения перечисления
Описание ПерваяГруппа подчинено перечислению АмортизационныеГруппы, а не напрямую корню конфигурации. Расширения исследуем без переключения.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Запускайте в учебной копии конфигурации. Примеры читают структуру метаданных, но не создают объекты, не записывают регистры и не проводят документы.
Сверяйте вывод с деревом конфигурации в Конфигураторе. Имена, длины и настройки в УНФ, КА2, БП, УТ 11 и УТ 10.3 могут различаться.
Имена объектов взяты из XML КА2 Progress: C:\claude\KA2\Progress\XML_CF_KA2_PROGRESS. Исходные XML не изменяйте. Выполняйте код только в своей учебной копии соответствующей конфигурации.
В другой конфигурации предварительно найдите аналогичный объект в Конфигураторе и замените только строку имени в поиске. Отсутствие имени обрабатывается до чтения свойств; оно не доказывает отсутствие аналогичной возможности.
Каждый урок запускайте отдельно. Код не вызывает бизнес-функции модулей и обработчики команд, не переключает привилегированный режим и не меняет параметры сеанса.
Описание = Метаданные.Перечисления.Найти("АмортизационныеГруппы");
Если Описание = Неопределено Тогда
ВызватьИсключение "В учебной конфигурации отсутствует Перечисления.АмортизационныеГруппы";
КонецЕсли;
Поле = Описание.ЗначенияПеречисления.Найти("ПерваяГруппа");
Если Поле = Неопределено Тогда
ВызватьИсключение "Значение ПерваяГруппа отсутствует в учебной схеме";
КонецЕсли;
Сообщить(СтрШаблон("%1: %2", Поле.ПолноеИмя(), Поле.Представление()));
Сообщить(Поле.Родитель() = Описание);
Сообщить("Комментарий: " + Поле.Комментарий);
Сообщить(Поле.ПринадлежностьОбъекта);
Сообщить(Поле.ОбъектРасширяемойКонфигурации);
Сообщить(Поле.ЕстьИзмененияРасширениямиКонфигурации());
Расширение = Поле.РасширениеКонфигурации();
Если Расширение <> Неопределено Тогда
Сообщить("Добавившее расширение: " + Расширение.Имя);
КонецЕсли;Разбор по шагам
Ищем имя значения внутри нужного перечисления, проверяя отсутствие.
ПолноеИмя и Представление имеют разные назначения.
Родитель описания значения — описание перечисления, не организация или бизнес-документ.
Добавление расширением и изменение расширениями проверяем раздельно.
Как проверить результат
Сравнение родителя даёт Истина; полное имя указывает значение нужного перечисления.
Замените имя значения на УчебноеОтсутствующее: исключение возникает до обращения к его свойствам.
Ожидаемый результат
Установлены программная идентичность, владелец и происхождение значения схемы.
На что обратить внимание
Описание значения не равно прикладному значению перечисления, полученному через менеджер.
Идентификатор расширяемого объекта не является номером амортизационной группы.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Получить значения перечисления по именам метаданных
Связываем техническое имя и синоним значения с реальным значением перечисления, пригодным для сравнения в коде.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Запускайте в учебной копии конфигурации. Примеры читают структуру метаданных, но не создают объекты, не записывают регистры и не проводят документы.
Сверяйте вывод с деревом конфигурации в Конфигураторе. Имена, длины и настройки в УНФ, КА2, БП, УТ 11 и УТ 10.3 могут различаться.
Если Метаданные.Перечисления.Количество() = 0 Тогда
ВызватьИсключение "В конфигурации нет перечислений";
КонецЕсли;
Описание = Метаданные.Перечисления.Получить(0);
Сообщить(СтрШаблон("Перечисление %1 (%2)", Описание.Имя, Описание.Синоним));
Сообщить(Описание.Комментарий);
Сообщить(Описание.ПолноеИмя());
Менеджер = Перечисления[Описание.Имя];
Для Каждого ОписаниеЗначения Из Описание.ЗначенияПеречисления Цикл
Значение = Менеджер[ОписаниеЗначения.Имя];
Сообщить(СтрШаблон("%1 (%2): представление %3; тип %4",
ОписаниеЗначения.Имя, ОписаниеЗначения.Синоним, Значение, ТипЗнч(Значение)));
Сообщить(ОписаниеЗначения.Комментарий);
КонецЦикла;
Сообщить(СтрШаблон("Описаний значений: %1", Описание.ЗначенияПеречисления.Количество()));Разбор по шагам
Берём существующее перечисление из текущей конфигурации; внешний текст не используется как имя объекта.
Метаданные содержат технические имена и синонимы, а Перечисления[Имя] возвращает менеджер соответствующего перечисления.
Доступ менеджера по имени значения даёт значение перечисления, не строку с подписью.
ТипЗнч помогает увидеть различие между ПеречислениеСсылка и обычной Строкой.
Как проверить результат
Число сообщений о значениях совпадает с количеством ЗначенияПеречисления.
В Конфигураторе найдите выведенное перечисление: технические имена и синонимы совпадают.
Синоним может содержать пробелы; код по-прежнему использует техническое Имя.
Ожидаемый результат
Получена таблица соответствия имён метаданных реальным значениям перечисления.
На что обратить внимание
Нельзя сравнивать значение перечисления со строкой его синонима: совпадение подписи не делает типы одинаковыми.
Не принимайте произвольные имена из API для динамического доступа. Используйте согласованный белый список обмена.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.