Как вызвать команду в 1С: все способы

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

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

Что такое команда в 1С и какие они бывают

Прежде чем вызывать команду, полезно понимать её тип. В платформе 1С:Предприятие 8 команды делятся на несколько групп, и от типа зависит способ вызова.

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

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

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

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

Третье место — панель навигации раздела и панель действий. В панели навигации расположены команды перехода к спискам (например, «Реализации товаров»), а в панели действий — команды создания и отчёты по текущему разделу. Если нужной команды не видно, проверьте настройку панелей через меню «Вид».

1. 1
   Откройте нужный объект: документ, элемент справочника или список.
2. 2
   Осмотрите командную панель сверху — основные действия расположены там.
3. 3
   Если команды нет, нажмите «Ещё» и проверьте выпадающий список.
4. 4
   Для списков проверьте панель действий раздела и пункт «Создать».
5. 5
   Если команда не найдена нигде — уточните права доступа у администратора: команда может быть скрыта настройкой прав или функциональных опций.

Если команды нет на видном месте

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

Как вызвать команду формы программно

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

&НаКлиенте
Процедура ОтправитьОтчет(Команда)
	ОтправитьОтчетНаСервере();
	ПоказатьОповещениеПользователя("Отчёт отправлен");
КонецПроцедуры

&НаСервере
Процедура ОтправитьОтчетНаСервере()
	// серверная логика обработки данных
КонецПроцедуры

Обратите внимание на директивы компиляции: &НаКлиенте выполняется на клиенте, &НаСервере — на сервере. Работа с данными базы (запросы, изменение объектов) возможна только на сервере, поэтому типовой шаблон — клиентский обработчик вызывает серверную процедуру. Это не стилистика, а требование архитектуры управляемых форм.

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

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

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

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

Вызов команды через консоль кода и внешние инструменты

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

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

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

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

FAQ по вызову команд в 1С