Как добавить глобальную команду на форму в 1С 8.3

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

Механизм работает и в обычных, и в управляемых формах, но чаще всего применяется именно в управляемом интерфейсе «Такси». Платформа автоматически выводит глобальные команды в командную панель формы объекта, если тип параметра команды совпадает с типом данных формы. Разработчику остаётся только написать обработчик в общем модуле и при необходимости настроить размещение кнопки вручную.

Ниже разобран полный цикл: от создания общей команды в конфигураторе до проверки её видимости на форме, с примерами кода обработчика, разбором свойств и типичных ошибок, из-за которых кнопка не появляется.

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

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

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

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

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

Откройте конфигуратор, разверните ветку «Общие» и найдите «Общие команды». Через контекстное меню выберите «Добавить». Платформа создаст новую команду и откроет палитру свойств, где нужно заполнить несколько ключевых полей.

Основные свойства, которые следует задать сразу:

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

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

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

Настройка состава: где команда будет видна

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

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

Команды без параметра размещают через подсистемы: в свойствах подсистемы есть вкладка «Состав», куда добавляют общие команды. Такие команды появляются в панели действий раздела, а не на формах объектов, и для их показа тип параметра должен быть пустым.

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

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

Пример простого обработчика, открывающего отчёт по переданному документу:

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

ПараметрыФормы = Новый Структура;
ПараметрыФормы.Вставить("Отбор", Новый Структура("Регистратор", ПараметрКоманды));
ПараметрыФормы.Вставить("СформироватьПриОткрытии", Истина);

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

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

Параметр ПараметрыВыполненияКоманды содержит сведения о контексте вызова: источник (форма, из которой вызвана команда), уникальность и окно. Их удобно передавать в ОткрытьФорму, чтобы новая форма правильно позиционировалась и не плодила дубликаты.

&НаКлиенте
Процедура ОбработкаКоманды(ПараметрКоманды, ПараметрыВыполненияКоманды)
	Состояние("Выполняется обработка...");
	ОбработатьНаСервере(ПараметрКоманды);
	ПоказатьОповещениеПользователя("Готово");
КонецПроцедуры

Если логика требует серверных вызовов — чтения данных, записи, проведения — её выносят в общий серверный модуль (с флагами «Сервер», «Вызов сервера») или используют директиву &НаСервере в модуле команды, если конфигурация это позволяет. Модуль команды компилируется в контексте клиентского приложения, поэтому прямое обращение к запросам из клиентской процедуры вызовет ошибку.

Ручное размещение кнопки на форме

Автоматическое размещение удобно, но не всегда подходит: иногда кнопку нужно перенести в другое место командной панели, добавить в подменю или оформить иначе. Для этого откройте нужную форму в конфигураторе, перейдите на вкладку «Командный интерфейс» — там отображаются все глобальные команды, доступные форме, с флажками видимости.

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

При ручном размещении проверьте свойство «ТолькоВоВсехДействиях» у кнопки: если оно установлено, кнопка попадёт только в меню «Ещё» и не будет видна в командной панели напрямую.

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

После обновления конфигурации базы данных (команда «Конфигурация» → «Обновить конфигурацию базы данных» или клавиша F7) откройте форму объекта подходящего типа в режиме предприятия. Кнопка должна появиться в командной панели формы или в меню «Ещё» — в зависимости от свойства «Группа команд».

Если кнопка не появилась, чаще всего причина в одной из типовых ошибок:

• не обновлена конфигурация базы данных после добавления команды;
• тип параметра команды не включает тип открываемого объекта;
• у пользователя нет прав на общую команду — проверьте роли, право «Использование»;
• команда отключена на закладке «Командный интерфейс» конкретной формы;
• для формы списка установлен одиночный режим параметра вместо множественного.

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

Ограничения и безопасные границы доработки

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

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

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