Используется для обращения к метаданным группы команд.
Полное описание, параметры и ограничения
ОбъектМетаданных: ГруппаКоманд (MetadataObject: CommandGroup)
ОбъектМетаданных: ГруппаКоманд (MetadataObject: CommandGroup)
Доступен, начиная с версии 8.2.
Свойства:
Имя (Name)
Комментарий (Comment)
ОбъектРасширяемойКонфигурации (ExtendedConfigurationObject)
ПринадлежностьОбъекта (ObjectBelonging)
Синоним (Synonym)
Картинка (Picture)
Категория (Category)
Отображение (Representation)
Подсказка (Tooltip)
Методы:
ЕстьИзмененияРасширениямиКонфигурации (ChangedByConfigurationExtensions)
ПолноеИмя (FullName)
Представление (Presentation)
РасширениеКонфигурации (ConfigurationExtension)
Родитель (Parent)
Описание:
Используется для обращения к метаданным группы команд.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Разобраться, где размещается группа Документы
Группа Документы в этой КА2 относится к командной панели формы. Синоним Документ и имя Документы — разные строки.
Где и как запускать
Полный серверный модуль учебной копии КА2 Progress 2.5.20.75; чтение метаданных и собственная память.
Подготовка
Отдельная учебная копия КА2 Progress 2.5.20.75 из C:\claude\KA2\Progress\XML_CF_KA2_PROGRESS, платформа 8.5.1.1343. Не рабочая база и не произвольная другая КА2.
Создайте серверный общий модуль УчебныеПаспортаМетаданных. Вставьте полный текст одного урока и вызовите УчебныеПаспортаМетаданных.ВыполнитьПример() из своей учебной команды.
Источники: CommandGroups\Документы.xml; Catalogs\Номенклатура.xml; XDTOPackages\Адрес.xml и Адрес\Ext\Package.bin; SessionParameters\АвторизованныйПользователь.xml.
Исходники и база не меняются. Код не выполняет команды интерфейса, не заполняет параметры настоящего сеанса, не отправляет адрес и не читает персональные данные пользователя.
URI пакета является идентификатором уже установленного XDTO, не адресом для HTTP-запроса. Учебный город и улица вымышленные, объект XDTO создаётся только в памяти.
Активные расширения и язык представлений могут менять сведения. Диагностические строки о расширениях не имеют фиксированного ожидаемого значения.
Процедура ВыполнитьПример() Экспорт
Группа = Метаданные.ГруппыКоманд.Найти("Документы");
Если Группа = Неопределено Тогда
ВызватьИсключение "Нет подтверждённой группы Документы";
КонецЕсли;
Сообщить(Группа.Имя = "Документы");
Сообщить(Группа.Категория = КатегорияГруппыКоманд.КоманднаяПанельФормы);
Сообщить(Группа.Отображение = ОтображениеКнопки.Авто);
Сообщить(Группа.Подсказка = "Дополнительные действия с документами");
Сообщить(ТипЗнч(Группа.Картинка) = Тип("Картинка"));
Сообщить(Группа.Синоним);
Сообщить(Группа.Комментарий);
Сообщить(Группа.ПолноеИмя());
Сообщить(Группа.Представление());
Сообщить(Группа.ПринадлежностьОбъекта);
Сообщить(ТипЗнч(Группа.ОбъектРасширяемойКонфигурации));
Сообщить(Группа.ЕстьИзмененияРасширениямиКонфигурации());
Сообщить(ТипЗнч(Группа.РасширениеКонфигурации()));
Сообщить(Группа.Родитель() = Метаданные);
КонецПроцедурыРазбор по шагам
Найти именно общую группу в Метаданные.ГруппыКоманд, не искать документ с похожим названием.
Сравнить категорию, отображение и подсказку с исходным XML. Картинка может быть пустой: тип Картинка не доказывает наличие видимой иконки.
Вывести полное имя и представление. Представление зависит от языка и настроек, это не ключ для поиска в коллекции.
Прочитать принадлежность и сведения расширений. Родитель общей группы — конфигурация, не командная панель конкретной формы.
Как проверить результат
Шесть фиксированных булевых проверок дают Истина; остальные сообщения диагностические.
В исходном XML Name = Документы, русское Synonym = Документ, Category = FormCommandBar. Команды и права пользователя этот урок не меняет.
Ожидаемый результат
Самостоятельная диагностика группы интерфейса по реальной конфигурации.
На что обратить внимание
Категория не означает, что группа уже отображается на любой форме.
Метаданные не проверяют доступность команды текущему пользователю.
Не присваивайте новые значения свойствам реальных метаданных ради изменения интерфейса во время выполнения.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Отличить стандартную группу Создать от общей группы
Команда Номенклатура.НовыйЭлемент привязана к ПанельДействийСоздать. Не угадываем группу по подписи команды.
Где и как запускать
Полный серверный модуль учебной копии КА2 Progress 2.5.20.75; чтение метаданных и собственная память.
Подготовка
Отдельная учебная копия КА2 Progress 2.5.20.75 из C:\claude\KA2\Progress\XML_CF_KA2_PROGRESS, платформа 8.5.1.1343. Не рабочая база и не произвольная другая КА2.
Создайте серверный общий модуль УчебныеПаспортаМетаданных. Вставьте полный текст одного урока и вызовите УчебныеПаспортаМетаданных.ВыполнитьПример() из своей учебной команды.
Источники: CommandGroups\Документы.xml; Catalogs\Номенклатура.xml; XDTOPackages\Адрес.xml и Адрес\Ext\Package.bin; SessionParameters\АвторизованныйПользователь.xml.
Исходники и база не меняются. Код не выполняет команды интерфейса, не заполняет параметры настоящего сеанса, не отправляет адрес и не читает персональные данные пользователя.
URI пакета является идентификатором уже установленного XDTO, не адресом для HTTP-запроса. Учебный город и улица вымышленные, объект XDTO создаётся только в памяти.
Активные расширения и язык представлений могут менять сведения. Диагностические строки о расширениях не имеют фиксированного ожидаемого значения.
Процедура ВыполнитьПример() Экспорт
Группа = Метаданные.ГруппыКоманд.Найти("Документы");
Каталог = Метаданные.Справочники.Найти("Номенклатура");
Если Группа = Неопределено ИЛИ Каталог = Неопределено Тогда
ВызватьИсключение "Нет подтверждённых метаданных";
КонецЕсли;
Команда = Каталог.Команды.Найти("НовыйЭлемент");
Если Команда = Неопределено Тогда
ВызватьИсключение "Нет команды Номенклатура.НовыйЭлемент";
КонецЕсли;
ФактическаяГруппа = Команда.Группа.Получить();
Сообщить(ФактическаяГруппа = СтандартнаяГруппаКоманд.ПанельДействийСоздать);
Сообщить(Группа.Категория = КатегорияГруппыКоманд.КоманднаяПанельФормы);
Сообщить(Группа.Имя = "Документы");
Сообщить("НовыйЭлемент относится к стандартной группе Создать, а не к общей группе Документы.");
Сообщить(Группа.Синоним);
Сообщить(Группа.Комментарий);
Сообщить(Группа.ПолноеИмя());
Сообщить(Группа.Представление());
Сообщить(Группа.ПринадлежностьОбъекта);
Сообщить(ТипЗнч(Группа.ОбъектРасширяемойКонфигурации));
Сообщить(Группа.ЕстьИзмененияРасширениямиКонфигурации());
Сообщить(ТипЗнч(Группа.РасширениеКонфигурации()));
Сообщить(Группа.Родитель() = Метаданные);
КонецПроцедурыРазбор по шагам
Найти подтверждённый справочник и его команду НовыйЭлемент.
Команда.Группа — объект ГруппаКоманд. Вызвать его Получить без аргументов, чтобы получить стандартное значение или метаданные пользовательской группы.
В этой выгрузке результат — СтандартнаяГруппаКоманд.ПанельДействийСоздать. Общая группа Документы относится к другой категории.
Вывести паспорт общей группы для сравнения. Код не вызывает команду создания номенклатуры и не открывает карточку.
Как проверить результат
Четыре фиксированных булевых проверки дают Истина; сведения расширений диагностические.
В Catalogs/Номенклатура.xml у команды НовыйЭлемент Group = ActionsPanelCreate. Нет записи нового товара.
Ожидаемый результат
Практический пример настоящего перехода от метаданных команды к её группе.
На что обратить внимание
Команда.Группа нельзя сразу сравнивать с перечислением без Получить.
Результат Получить у другой команды может быть пользовательской группой, а не СтандартнаяГруппаКоманд.
Название группы не доказывает фактическую видимость кнопки: это зависит от формы, интерфейса и прав.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.