Построить учебный словарь имён и синонимов перечисления

Учебные задачи

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

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

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

Подготовка

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

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

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

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

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

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

  1. Метаданные.Перечисления описывает схему перечисления, не хранит текущий статус документа.

  2. ЗначенияПеречисления содержит описания каждого элемента с Имя/Синоним.

  3. Динамическое обращение менеджер[Имя] получает реальное значение по имени метаданных.

  4. Родитель описания значения — перечисление, а родитель перечисления — корень конфигурации.

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

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

  1. Начальные четыре проверки Истина, для каждого значения проверка родителя Истина.

  2. Финальная подпись имени Готов — Готов к проверке.

  3. Ни перечень значений схемы, ни рабочие данные не изменяются.

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

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

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

  1. У описания значения нет метода Пустая: он принадлежит ссылке перечисления.

  2. Нельзя добавлять значения в метаданные через Словарь.Добавить; это всего лишь ТаблицаЗначений.

  3. Изменение имени метаданных — изменение схемы, поэтому внешние контракты нужно версионировать отдельно.

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

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

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

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

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