Содержит варианты режимов использования параметра команды. Если свойствах команды РежимИспользованияПараметра и РежимИспользованияПараметра имеет значение Множественный, то в обработчик команды передается массив значений, а не одно значение даже, если в конкретном случае значение одно. Массив значений может быть передан в том случае, если источником для параметра команды является динамический список в режиме множественного выделения.
Полное описание, параметры и ограничения
РежимИспользованияПараметраКоманды (CommandParameterUseMode)
РежимИспользованияПараметраКоманды (CommandParameterUseMode)
Доступен, начиная с версии 8.2.
Значения
Множественный (Multiple)
Одиночный (Single)
Описание:
Содержит варианты режимов использования параметра команды.
Если свойствах команды РежимИспользованияПараметра и РежимИспользованияПараметра имеет значение Множественный, то в обработчик команды передается массив значений, а не одно значение даже, если в конкретном случае значение одно.
Массив значений может быть передан в том случае, если источником для параметра команды является динамический список в режиме множественного выделения.
Доступность:
Сервер, толстый клиент, внешнее соединение, мобильное приложение (сервер), мобильный автономный сервер.
Использование в версии:
Доступен, начиная с версии 8.2.
Методическая информация
Практические примеры
Проверить тип и кратность параметра общей команды
Для АрхивСообщенийОбменов читаем допустимые типы ссылок и режим параметра до изучения обработчика. Команду не выполняем.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Запускайте в учебной копии конфигурации. Примеры читают структуру метаданных, но не создают объекты, не записывают регистры и не проводят документы.
Сверяйте вывод с деревом конфигурации в Конфигураторе. Имена, длины и настройки в УНФ, КА2, БП, УТ 11 и УТ 10.3 могут различаться.
Имена объектов взяты из XML КА2 Progress: C:\claude\KA2\Progress\XML_CF_KA2_PROGRESS. Исходные XML не изменяйте. Выполняйте код только в своей учебной копии соответствующей конфигурации.
В другой конфигурации предварительно найдите аналогичный объект в Конфигураторе и замените только строку имени в поиске. Отсутствие имени обрабатывается до чтения свойств; оно не доказывает отсутствие аналогичной возможности.
Каждый урок запускайте отдельно. Код не вызывает бизнес-функции модулей и обработчики команд, не переключает привилегированный режим и не меняет параметры сеанса.
Описание = Метаданные.ОбщиеКоманды.Найти("АрхивСообщенийОбменов");
Если Описание = Неопределено Тогда
ВызватьИсключение "В учебной конфигурации отсутствует ОбщиеКоманды.АрхивСообщенийОбменов";
КонецЕсли;
Сообщить("Команда: " + Описание.ПолноеИмя());
Сообщить(Описание.РежимИспользованияПараметра);
Типы = Описание.ТипПараметраКоманды.Типы();
Сообщить("Допустимых типов: " + Строка(Типы.Количество()));
Для Каждого ДопустимыйТип Из Типы Цикл
Сообщить(ДопустимыйТип);
КонецЦикла;
Если Описание.РежимИспользованияПараметра = РежимИспользованияПараметраКоманды.Множественный Тогда
Сообщить("Изучите обработку массива значений в обработчике команды");
Иначе
Сообщить("Изучите обработку одного параметра команды");
КонецЕсли;Разбор по шагам
ТипПараметраКоманды — ОписаниеТипов, а не текущая ссылка выбранного узла.
Типы() раскрывает список допустимых типов; состав зависит от релиза.
РежимИспользованияПараметра определяет одиночную или множественную передачу.
Пример не выбирает узел обмена и не вызывает обработчик.
Как проверить результат
В предоставленном XML перечислены три типа ссылок планов обмена и одиночный режим. Сверьте свой релиз.
Число выведенных типов совпадает со счётчиком; это не число узлов обмена в базе.
Ожидаемый результат
Составлен контракт параметра до переноса команды в собственную форму.
На что обратить внимание
Допустимый тип не доказывает существование или права на конкретный узел.
Массив значений при множественном режиме нельзя обрабатывать как одну ссылку.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.