Тип: ГруппаКоманд. Группа команд, в которую входит команда. Устанавливает расположение команды в глобальном командном интерфейсе приложения.
Полное описание, параметры и ограничения
ОбъектМетаданных: Команда.Группа (MetadataObject: Command.Group)
ОбъектМетаданных: Команда (MetadataObject: Command)
Группа (Group)
Доступен, начиная с версии 8.2.
Использование:
Только чтение.
Описание:
Тип: ГруппаКоманд.
Группа команд, в которую входит команда. Устанавливает расположение команды в глобальном командном интерфейсе приложения.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Отделить оформление команды НовыйЭлемент от её действия
Читаем настоящие настройки кнопки номенклатуры, не вызывая создание элемента.
Где и как запускать
Полный серверный общий модуль собственной учебной копии КА2 Progress 2.5.20.75, только чтение схемы.
Подготовка
Используйте отдельную учебную копию КА2 Progress из C:\claude\KA2\Progress\XML_CF_KA2_PROGRESS, конфигурация КомплекснаяАвтоматизация 2.5.20.75, платформа 8.5.1.1343. Это не инструкция запуска в рабочей базе.
Создайте серверный общий модуль УчебныеКонтрактыИнтерфейса с флагом Сервер. Вставьте полный модуль одного урока и вызовите УчебныеКонтрактыИнтерфейса.ВыполнитьПример() из серверной учебной команды.
Команды подтверждены в Catalogs\Номенклатура.xml и Documents\РеализацияТоваровУслуг.xml; форма — в Catalogs\Номенклатура\Forms\ФормаСписка.xml; нумератор — в DocumentNumerators\ДокументыРеализацииТоваров.xml.
Исходники конфигурации не меняются. Код только читает метаданные и обрабатывает собственные значения в памяти: не вызывает штатную команду, не открывает форму списка, не получает новый номер и не записывает документы.
При отличающейся версии или расширениях результат может отличаться от выгрузки. Сверяйте активную конфигурацию, а не исправляйте её ради зелёных сообщений.
Процедура ВыполнитьПример() Экспорт
Каталог = Метаданные.Справочники.Найти("Номенклатура");
Если Каталог = Неопределено Тогда
ВызватьИсключение "Нет подтверждённого справочника Номенклатура";
КонецЕсли;
КомандаМетаданных = Каталог.Команды.Найти("НовыйЭлемент");
Если КомандаМетаданных = Неопределено Тогда
ВызватьИсключение "Нет команды Номенклатура.НовыйЭлемент";
КонецЕсли;
Сообщить(КомандаМетаданных.Отображение = ОтображениеКнопки.Авто);
Сообщить(НЕ КомандаМетаданных.ИзменяетДанные);
Сообщить("Группа командного интерфейса: " + Строка(КомандаМетаданных.Группа));
Сообщить("Подсказка заполнена: " + Строка(НЕ ПустаяСтрока(КомандаМетаданных.Подсказка)));
Сообщить("Тип картинки: " + Строка(ТипЗнч(КомандаМетаданных.Картинка)));
Сообщить("Тип сочетания клавиш: " + Строка(ТипЗнч(КомандаМетаданных.СочетаниеКлавиш)));
Сообщить("Поведение без основного сервера: " + Строка(КомандаМетаданных.ПоведениеПриНедоступностиОсновногоСервера));
Сообщить("Прочитаны настройки, команда НовыйЭлемент не выполнена");
КонецПроцедурыРазбор по шагам
XML у НовыйЭлемент содержит Representation=Auto, ModifiesData=false, Group=ActionsPanelCreate. Первые два свойства сравниваем с нативным перечислением/Булево.
ИзменяетДанные управляет перечитыванием данных формы после команды; Ложь не является доказательством, что код команды никогда ничего не записывает.
Группа определяет положение в командном интерфейсе. Это не объект ГруппаФормы и не произвольная CSS-группа.
Картинку и сочетание клавиш показываем только по типу, а подсказку — по заполненности. Не обещаем одинаковую видимость и геометрию в каждом интерфейсе.
ПоведениеПриНедоступностиОсновногоСервера лишь читается. Оно не переводит клиента в автономную работу и не доказывает доступность сети.
Как проверить результат
Две первые проверки ожидаются Истина на исходной схеме; остальные значения диагностические.
Форма нового товара не открыта, справочник не изменён.
Ожидаемый результат
Разобраны семь настроек настоящей команды без подмены декларативной настройки поведением обработчика.
На что обратить внимание
Авто отображения не гарантирует всегда картинку или всегда текст.
Флаг ИзменяетДанные=Ложь нельзя использовать как разрешение без аудита выполнять штатную команду.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Отличить стандартную группу Создать от общей группы
Команда Номенклатура.НовыйЭлемент привязана к ПанельДействийСоздать. Не угадываем группу по подписи команды.
Где и как запускать
Полный серверный модуль учебной копии КА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. Нет записи нового товара.
Ожидаемый результат
Практический пример настоящего перехода от метаданных команды к её группе.
На что обратить внимание
Команда.Группа нельзя сразу сравнивать с перечислением без Получить.
Результат Получить у другой команды может быть пользовательской группой, а не СтандартнаяГруппаКоманд.
Название группы не доказывает фактическую видимость кнопки: это зависит от формы, интерфейса и прав.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.