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

Глобальные параметризуемые команды в 1С 8.3 — это команды, объявленные в общей ветке конфигурации, которые принимают параметр и могут вызываться из форм любых объектов. Их часто путают с командами конкретных объектов (справочников, документов), поэтому разработчики тратят время на поиски не в том разделе дерева конфигурации.

Найти их нужно не внутри объекта метаданных, а в отдельной ветке верхнего уровня. Ниже разобрано, где именно расположены эти команды, чем они отличаются от команд объектов, как создать собственную параметризуемую команду и как проверить, что она корректно работает в интерфейсе.

Где в конфигураторе находятся глобальные команды

Откройте конфигуратор и разверните дерево конфигурации (меню «Конфигурация → Открыть конфигурацию» или «Конфигурация → Конфигурация базы данных»). В корне дерева есть ветка «Общие», а внутри неё — узел «Общие команды». Именно здесь размещаются все глобальные команды конфигурации: как обычные (без параметра), так и параметризуемые.

Это принципиально отличается от команд, заданных у конкретного объекта. У справочников, документов, регистров и отчётов есть собственная вкладка «Команды» в палитре свойств и окне редактирования объекта — такие команды видны только в контексте этого объекта. Глобальные команды в ветке «Общие команды» доступны потенциально везде, где подходит тип параметра.

Если вы ищете уже существующую команду в типовой конфигурации, удобнее воспользоваться поиском: Ctrl+Shift+F по имени команды или через окно «Все функции» найти обработчик. В больших конфигурациях (например, ERP или УТ) в ветке «Общие команды» могут находиться десятки элементов, и ручной просмотр занимает много времени.

Чем параметризуемая команда отличается от обычной

Обычная глобальная команда просто выполняет действие — например, открывает обработку или форму. Параметризуемая команда дополнительно получает параметр: ссылку на объект, из формы которого она вызвана. Типичный пример — кнопка «Печать» или «Создать на основании», которая появляется в форме документа и получает ссылку на этот документ.

Ключевое свойство — «Тип параметра команды». Если оно пустое, команда считается обычной. Если указан тип (например, «ДокументСсылка.РеализацияТоваровУслуг» или составной тип из нескольких видов документов), команда становится параметризуемой и появляется в командном интерфейсе форм соответствующих объектов.

Второе важное свойство — «Режим использования параметра». Значение «Одиночный» означает, что команда работает с одним объектом; «Множественный» позволяет вызывать её из списка с несколькими выделенными строками, и в обработчик придёт массив ссылок.

Какие свойства задать при создании команды

Создайте новый элемент в ветке «Общие → Общие команды» через контекстное меню «Добавить». В палитре свойств задайте имя, синоним (его увидит пользователь на кнопке) и заполните параметры, перечисленные ниже.

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

Как написать обработчик команды

После настройки свойств нажмите кнопку с лупой у поля «Действие» или откройте модуль команды. Платформа создаст процедуру ОбработкаКоманды(ПараметрКоманды, ПараметрыВыполненияКоманды). В ПараметрКоманды придёт ссылка на объект (или массив при множественном режиме), в ПараметрыВыполненияКоманды — сведения об источнике вызова, включая форму-владельца.

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

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

Где команда появится в пользовательском режиме

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

Если кнопка не появилась, проверьте следующее: обновлена ли конфигурация БД (F7), перезапущен ли сеанс, не скрыта ли команда настройками командного интерфейса конкретной формы (разработчик мог переопределить состав командной панели вручную), есть ли у пользователя права на объекты, к которым обращается обработчик.

Типичные ошибки и ограничения

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

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

Альтернативы глобальным командам

В конфигурациях на базе БСП (УТ, ERP, Бухгалтерия) для печатных форм и команд заполнения предпочтительнее использовать подсистемы «Печать» и «Дополнительные отчеты и обработки» — они дают готовую регистрацию команд без изменения конфигурации. Собственные общие команды оправданы для нестандартных сценариев, которых нет в этих подсистемах.

Частые вопросы