Как добавить команду в командный интерфейс 1С

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

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

Что такое командный интерфейс и где он настраивается

Командный интерфейс прикладного решения формируется из подсистем. Каждая подсистема — это раздел меню (например, «Продажи», «Склад», «Настройки»), внутри которого располагаются команды навигации (открытие списков) и команды действий (создание объектов, открытие обработок). Состав и порядок этих команд задаётся в конфигураторе на уровне каждой подсистемы.

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

Как добавить стандартную команду объекта в подсистему

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

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

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

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

Как добавить общую команду в командный интерфейс

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

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

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

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

Настройка порядка, групп и видимости команд

Когда команд в разделе много, важен их порядок и группировка. В редакторе командного интерфейса подсистемы команды перемещаются кнопками «Вверх» и «Вниз» или перетаскиванием. Чем выше команда в списке, тем выше она отображается в меню раздела.

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

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

Добавление команды в командную панель формы

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

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

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

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

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

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

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

Часто задаваемые вопросы