Как выполнить команду на форме 1С

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

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

Какие команды существуют на форме 1С

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

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

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

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

&НаКлиенте
Процедура ПослеЗаписи(ПараметрыЗаписи)
ЗаполнитьПоДанным(Команды.Найти("ЗаполнитьПоДанным"));
КонецПроцедуры

Параметр Команда в обработчике — это объект типа «КомандаФормы». Получить его можно через коллекцию ЭтаФорма.Команды методом Найти("ИмяКоманды"). Если обработчик не использует параметр, допустимо передать Неопределено, но корректнее передать реальный объект команды — тогда код внутри обработчика, обращающийся к свойствам команды, не сломается.

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

&НаКлиенте
Процедура ВыполнитьКомандуПоИмени(ИмяКоманды)
    КомандаФормы = ЭтаФорма.Команды.Найти(ИмяКоманды);
    Если КомандаФормы = Неопределено Тогда
        ВызватьИсключение "Команда не найдена: " + ИмяКоманды;
    КонецЕсли;
    // Далее вызываем обработчик этой команды напрямую
КонецПроцедуры

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

Стандартные команды (Записать, Провести, Отменить проведение) не обязаны вызываться через имитацию нажатия кнопки. Для них есть прямые методы объекта, которые надёжнее и предсказуемее.

На форме документа запись выполняется методом Записать() формы, проведение — Записать(Новый Структура("РежимЗаписи", РежимЗаписиДокумента.Проведение)). Если нужно выполнить действие без формы (например, из фонового задания или другой формы), работайте с объектом данных: ДокументОбъект.Записать(РежимЗаписиДокумента.Проведение). Это безопаснее, чем искать открытую форму и дёргать её команды.

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

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

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

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

Пошаговый порядок добавления и выполнения своей команды

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

Затем перетащите команду в дерево элементов формы (например, в командную панель), чтобы появилась кнопка, либо оставьте команду без кнопки, если она нужна только для программного вызова. Напишите код в обработчике и проверьте выполнение: интерактивно — нажатием кнопки, программно — вызовом обработчика из другого места модуля.

1. 1
   Откройте форму в конфигураторе, вкладка «Команды формы»
2. 2
   Добавьте команду, задайте имя и создайте обработчик «Действие»
3. 3
   Разместите кнопку в командной панели или оставьте команду скрытой
4. 4
   Напишите код обработчика с учётом контекста (клиент/сервер)
5. 5
   Проверьте интерактивный вызов кнопкой и программный вызов обработчика
6. 6
   Убедитесь, что при программном вызове передаётся корректный параметр команды

Как проверить, что команда выполнилась

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

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

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

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

Вторая ошибка — передача произвольного значения вместо объекта команды. Если обработчик обращается к свойствам параметра (например, Команда.Имя), передача строки или Неопределено вызовет ошибку. Третья — попытка выполнить команду закрытой или ещё не созданной формы: при обращении извне всегда проверяйте, что форма открыта, либо используйте оповещения, которые просто не сработают при отсутствии подписчика, не ломая код.

FAQ