Глобальные параметризуемые команды в 1С: пошаговое руководство

Глобальные параметризуемые команды в 1С — это команды, которые доступны из любого окна приложения и при этом получают на вход параметр текущего контекста. Классический пример: пользователь открыл документ «Реализация товаров», нажимает кнопку в панели команд — и открывается обработка или отчёт, уже «знающий», с каким документом работает пользователь. Такой механизм избавляет от лишних действий: не нужно сначала копировать ссылку, а потом искать её в форме обработки.

От обычных глобальных команд параметризуемые отличаются наличием типа параметра команды. Если тип задан, платформа автоматически передаёт в команду значение, связанное с активным объектом — например, ссылку на текущий документ из открытой формы. Если тип не задан, команда считается простой глобальной и выполняется без параметров.

Механизм особенно полезен при разработке расширений, когда нужно добавить к типовой конфигурации универсальную кнопку «Печать по шаблону», «Проверить контрагента», «Открыть связанные документы» и тому подобное — без изменения каждой формы вручную. Ниже разобрано, как создать такую команду, где она появится в интерфейсе и какие ограничения нужно учитывать.

Что такое глобальная параметризуемая команда и когда она нужна

В дереве конфигурации общие команды находятся в ветке «Общие → Общие команды». Каждая команда имеет свойство «Тип параметра команды». Если оно заполнено, команда становится параметризуемой: платформа ожидает, что при вызове ей будет передано значение указанного типа. Глобальность означает, что команда не привязана к конкретной форме объекта, а размещается в общем командном интерфейсе и может вызываться из разных окон.

Типичные сценарии применения: открытие универсальной обработки с передачей текущего документа, запуск отчёта по выбранному контрагенту, вызов сервисной функции (проверка, аудит, отправка) для объекта, который пользователь сейчас редактирует. Без параметризуемой команды пришлось бы добавлять кнопку в каждую форму каждого вида документов — это десятки одинаковых доработок.

Создание общей команды в конфигураторе

Откройте конфигуратор, разверните ветку «Общие → Общие команды» и добавьте новую команду. Задайте имя и синоним — синоним увидит пользователь в интерфейсе. Затем заполните ключевые свойства:

• Тип параметра команды — составной или одиночный тип, например «ДокументСсылка.РеализацияТоваровУслуг» или составной тип из нескольких видов документов и справочников. Именно это свойство делает команду параметризуемой.
• Режим использования параметра — «Одиночный» (передаётся одна ссылка) или «Множественный» (передаётся массив, например при выделении нескольких строк в списке).
• Группа — куда поместить команду в командном интерфейсе (панель навигации, панель действий).
• Картинка и отображение — влияют на внешний вид кнопки.

После заполнения свойств нажмите кнопку открытия модуля команды — платформа создаст заготовку обработчика ОбработкаКоманды(ПараметрКоманды, ПараметрыВыполненияКоманды). В переменной ПараметрКоманды вы получите ссылку на объект (или массив ссылок при множественном режиме).

1. 1
   Откройте «Общие → Общие команды» и добавьте новую команду
2. 2
   Заполните синоним и тип параметра команды
3. 3
   Выберите режим использования параметра: одиночный или множественный
4. 4
   Напишите код в обработчике ОбработкаКоманды
5. 5
   Разместите команду в командном интерфейсе подсистем или формы
6. 6
   Обновите конфигурацию и проверьте вызов из формы объекта

Написание обработчика команды

Минимальный обработчик открывает форму обработки и передаёт в неё полученный параметр. Важно передавать параметр через структуру параметров формы — тогда на стороне обработки его можно прочитать в событии «ПриСозданииНаСервере».

&НаКлиенте
Процедура ОбработкаКоманды(ПараметрКоманды, ПараметрыВыполненияКоманды)

Если ПараметрКоманды = Неопределено Тогда
ПоказатьПредупреждение(, "Команда вызвана без параметра.");
Возврат;
КонецЕсли;

ПараметрыФормы = Новый Структура("ДокументОснование", ПараметрКоманды);
ОткрытьФорму("Обработка.ПроверкаДокумента.Форма", ПараметрыФормы,
ПараметрыВыполненияКоманды.Источник,
ПараметрыВыполненияКоманды.Уникальность,
ПараметрыВыполненияКоманды.Окно);

КонецПроцедуры

Обратите внимание на структуру ПараметрыВыполненияКоманды: поля «Источник», «Уникальность» и «Окно» позволяют корректно связать открываемую форму с формой-владельцем. Если их не передать, форма откроется как независимое окно, и при повторном нажатии команды будут плодиться дубликаты окон. При множественном режиме ПараметрКоманды содержит массив — обрабатывайте его циклом или передавайте целиком.

&НаКлиенте
Процедура ОбработкаКоманды(ПараметрКоманды, ПараметрыВыполненияКоманды)
    ПараметрыФормы = Новый Структура("СсылкаНаОбъект", ПараметрКоманды);
    ОткрытьФорму("Обработка.МояОбработка.Форма", ПараметрыФормы,
        ПараметрыВыполненияКоманды.Источник);
КонецПроцедуры

Где команда появится в интерфейсе

Глобальная команда сама по себе не появится «нигде и везде» — её нужно разместить. Есть два основных способа. Первый — включить команду в командный интерфейс подсистем: откройте свойства подсистемы, перейдите к настройке командного интерфейса и добавьте команду в панель действий или панель навигации. Тогда она будет видна на начальной странице и в разделах.

Второй способ — добавить команду в командную панель конкретной формы: в редакторе формы перетащите общую команду из панели «Команды» на дерево элементов. Платформа автоматически свяжет кнопку с параметром формы: если основной реквизит формы имеет тип, совместимый с типом параметра команды, при нажатии в обработчик попадёт ссылка текущего объекта. Это и есть основной сценарий параметризуемого вызова «из формы документа».

Передача параметра из формы списка и множественный режим

При размещении команды в форме списка поведение зависит от режима использования параметра. В одиночном режиме в команду передаётся ссылка текущей строки списка. В множественном — массив ссылок всех выделенных строк. Это удобно для групповых операций: например, пользователь выделяет десять документов и одной кнопкой запускает их проверку или печать.

При множественном режиме учитывайте ограничения: массив может быть пустым (ничего не выделено), а обработка большого числа объектов на клиенте недопустима — вызывайте серверную процедуру и передавайте массив туда. Также помните, что длительные операции лучше выполнять через фоновые задания с индикацией прогресса, иначе интерфейс «зависнет» на время выполнения.

Добавление команды через расширение конфигурации

Если конфигурация на поддержке, глобальную команду удобно добавить расширением. В расширении создаётся собственная общая команда с типом параметра и обработчиком — типовой код при этом не меняется. Далее команду нужно разместить: либо заимствовать форму объекта в расширение и добавить кнопку, либо включить команду в подсистему расширения.

Ограничение подхода: заимствование формы увеличивает риск конфликтов при обновлении типовой конфигурации — если вендор изменит форму, заимствованная копия потребует перепроверки. Поэтому предпочтительный путь — программное добавление кнопки в событии «ПриСозданииНаСервере» через механизм подключаемых команд, если он предусмотрен в конфигурации (например, через БСП-подсистему «Подключаемые команды»).

Проверка результата и типичные ошибки

После обновления конфигурации базы данных проверьте команду в пользовательском режиме: откройте форму объекта подходящего типа, убедитесь, что кнопка видна, и нажмите её. В обработчик должна прийти ссылка именно текущего объекта. Затем повторите проверку из формы списка и из панели действий — во всех точках вызова поведение должно быть предсказуемым.

Отдельная частая проблема — права доступа. Если у пользователя нет права на обработку, которую открывает команда, он получит ошибку нарушения прав. Проверяйте роли на все объекты, задействованные в цепочке вызова: сама команда, открываемая обработка или отчёт, читаемые данные.

FAQ: частые вопросы о параметризуемых командах