Добавление команды формы в 1С: полное руководство с примерами

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

Особое внимание уделим типичным ошибкам, которые возникают при работе с командами. Например, почему команда не появляется в панели действий, хотя вы её добавили, или как правильно привязать обработчик к событию ПриНажатии. Также рассмотрим практические примеры: создание кнопки "Печать" с выводом отчёта, добавление команды в контекстное меню табличного поля и настройку видимости команд в зависимости от прав пользователя. Если вы только начинаете работать с формами в 1С или хотите систематизировать свои знания — этот материал для вас.

Что такое команда формы в 1С и зачем она нужна

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

• 🔹 Централизованное управление — одна команда может быть привязана к нескольким элементам интерфейса (кнопка на форме, пункт в меню "Действия", горячая клавиша).
• 🔹 Контроль видимости и доступности — можно гибко настраивать, когда команда будет активна, а когда скрыта (например, только для администраторов).
• 🔹 Обработку на стороне клиента и сервера — код может выполняться как на форме, так и в модуле объекта.
• 🔹 Интеграцию с ролями — ограничение доступа через механизм прав 1С.

Без команд формы прикладному решению пришлось бы дублировать логику в каждом обработчике кнопок, что усложняет поддержку кода. Например, если нужно добавить кнопку "Экспорт в Excel" на 10 разных форм, с командами вы создаёте одну процедуру и привязываете её ко всем формам. Без команд — придётся копировать код в каждый модуль формы.

Способы добавления команды формы в конфигураторе

Есть три основных способа добавить команду формы в 1С:Предприятие 8.3. Выбор метода зависит от задачи:

1. Через палитру свойств формы — самый быстрый способ для добавления одиночных команд.
2. Через дерево объектов конфигурации — удобно, если нужно создать команду заранее и привязать её к нескольким формам.
3. Программно в модуле формы — используется для динамического создания команд (например, в зависимости от данных).

Рассмотрим каждый способ подробно.

Метод 1: Добавление команды через палитру свойств формы

Это самый простой способ, который подходит для большинства задач. Инструкция:

1. Откройте форму в конфигураторе (например, форму документа или справочника).
2. В палитре свойств формы перейдите на вкладку Команды.
3. Нажмите кнопку Добавить и выберите тип команды:
   • 📌 Команда формы — для стандартных действий (сохранение, печать и т.д.).
   • 📌 Команда группы — если команда должна относиться к группе команд (например, в меню "Действия").

Задайте имя команды (латиницей, например ПечатьАкта) и заголовок (то, что будет видно пользователю, например "Печать акта выполненных работ").

Сохраните конфигурацию (Ctrl+S).

Имя команды указано латиницей без пробелов|

Заголовок команды заполнен на русском языке|

Тип команды выбран правильно (форма/группа)|

Команда добавлена в нужную форму-->

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

Метод 2: Создание команды в дереве конфигурации

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

1. В дереве конфигурации найдите ветку Общие → Команды.
2. Создайте новую команду через контекстное меню (Добавить → Команда).
3. Заполните свойства:
   • 🔹 Имя — уникальный идентификатор (например, ОбщийЭкспортВExcel).
   • 🔹 Заголовок — отображаемое имя (например, "Экспорт в Excel").
   • 🔹 Использование — выберите Клиент, Сервер или Клиент и сервер в зависимости от того, где будет выполняться код.

В модуле команды добавьте обработчик события ПриНажатии (пример кода — в следующем разделе).

Сохраните конфигурацию и привяжите команду к нужным формам через палитру свойств.

Метод 3: Динамическое создание команды в модуле формы

Иногда команды нужно создавать программно — например, если их список зависит от данных на форме. Для этого используется метод ДобавитьКоманду(). Пример:

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
// Добавляем команду динамически
Команда = ЭлементыФормы.ДобавитьКоманду(
"ДинамическаяКоманда",  // Имя команды
"Динамическая команда", // Заголовок
"Команда1"             // Имя группы команд (опционально)
);
Команда.Действие = "МойОбработчик"; // Имя процедуры-обработчика
КонецПроцедуры

Процедура МойОбработчик(Команда)
Сообщить("Команда сработала!");
КонецПроцедуры

Динамические команды удобны для:

• 🔹 Контекстных меню, которые зависят от выбранной строки в таблице.
• 🔹 Кнопок, которые появляются только при определённых условиях (например, "Утвердить" только для неутверждённых документов).
• 🔹 Горячих клавиш, которые настраиваются пользователем.

Ограничения динамических команд

Динамические команды не сохраняются в конфигурации и создаются заново при каждом открытии формы. Их нельзя использовать в ролях для ограничения доступа — только через программную проверку.

Привязка команды к элементам интерфейса

Созданная команда сама по себе не видна пользователю. Чтобы она стала доступна, её нужно привязать к:

• 🔹 Кнопке на форме.
• 🔹 Пункту меню в панели действий.
• 🔹 Контекстному меню (например, табличного поля).
• 🔹 Горячей клавише.

Рассмотрим каждый вариант.

Добавление кнопки для команды

Самый распространённый способ — создать кнопку на форме и привязать её к команде:

1. Откройте форму в конфигураторе.
2. Перейдите на вкладку Элементы в палитре свойств.
3. Добавьте новый элемент типа Кнопка.
4. В свойствах кнопки укажите:
   • 🔹 Имя — идентификатор кнопки (например, КнопкаПечать).
   • 🔹 Заголовок — текст на кнопке (например, "Печать").
   • 🔹 Действие — выберите созданную команду из выпадающего списка.

Настройте расположение кнопки на форме (например, в командную панель).

Пример кода для обработчика команды (добавляется в модуль формы):

Процедура ПечатьАкта(Команда)
// Код для печати документа
Отчет = ПолучитьОбъект("Отчет.АктВыполненныхРабот");
Отчет.Сформировать(Объект.Ссылка);
Отчет.Показать();
КонецПроцедуры

Добавление команды в панель действий

Панель действий — это меню в верхней части формы (например, "Создать", "Изменить", "Удалить"). Чтобы добавить команду туда:

1. В палитре свойств формы перейдите на вкладку Командный интерфейс.
2. Найдите раздел Панель действий и добавьте новую группу или команду.
3. Выберите созданную команду из списка.
4. Настройте порядок отображения (перетащите команду мышью в нужное место).

Пример структуры панели действий:

Группа команд	Пример команд	Типичное расположение
Создание	Добавить, Скопировать, Провести	В начале панели
Изменение	Изменить, Удалить, Пометить на удаление	После группы "Создание"
Отчёты и печать	Печать, Экспорт в Excel, Отправить по почте	В конце панели
Действия	Заполнить, Рассчитать, Обновить	Выпадающий список

Привязка команды к контекстному меню

Контекстное меню появляется при нажатии правой кнопкой мыши на элемент формы (например, на строку табличного поля). Чтобы добавить команду туда:

1. Выделите табличное поле (или другой элемент) на форме.
2. В палитре свойств найдите свойство Контекстное меню.
3. Нажмите на кнопку ... рядом с полем и добавьте новую команду.
4. Выберите созданную команду из списка.

Пример: если вы добавите команду "Посмотреть историю изменений" в контекстное меню таблицы документов, пользователь сможет вызвать её правым кликом на любой строке.

Назначение горячей клавиши

Чтобы команда срабатывала по нажатию клавиш (например, Ctrl+P для печати), нужно:

1. Открыть свойства команды.
2. Найти поле Сочетание клавиш.
3. Нажать на кнопку ... и выбрать комбинацию (например, Ctrl+Shift+S).
💡

Избегайте стандартных комбинаций (например, Ctrl+C или Ctrl+V), чтобы не конфликтовать с системными действиями.

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

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

• 🔹 В модуле формы — если логика относится только к этой форме.
• 🔹 В модуле объекта — если команда используется в нескольких формах.
• 🔹 В общем модуле — для универсальных действий (например, экспорт в Excel).

Рассмотрим несколько практических примеров.

Пример 1: Простая команда с сообщением

Самый базовый вариант — команда, которая показывает сообщение:

Процедура МояПерваяКоманда(Команда)
Сообщить("Привет из команды!", СтатусСообщения.Информация);
КонецПроцедуры

Этот код можно разместить в модуле формы. При нажатии на кнопку пользователь увидит всплывающее сообщение.

Пример 2: Команда для печати документа

Типичная задача — добавить кнопку "Печать", которая формирует печатную форму документа:

Процедура ПечатьДокумента(Команда)
// Получаем объект документа из формы
Док = ЭтотОбъект.Объект;

// Формируем печатную форму
ПечатнаяФорма = Док.ПолучитьПечатнуюФорму();

// Показываем предварительный просмотр
ПечатнаяФорма.Показать();
КонецПроцедуры

Если печатная форма требует дополнительных параметров (например, выбор шаблона), можно использовать ПоказатьСДиалогомНастроек():

ПечатнаяФорма.ПоказатьСДиалогомНастроек(Истина);

Пример 3: Команда с проверкой прав пользователя

Часто команды должны быть доступны только определённым ролям. Например, кнопка "Утвердить документ" видна только руководителям. Для этого используем РолиДоступа:

Процедура УтвердитьДокумент(Команда)
// Проверяем, есть ли у пользователя роль "Руководитель"
Если НЕ РолиДоступа.НазначенаРоль("Руководитель") Тогда
Сообщить("У вас нет прав на утверждение!", СтатусСообщения.Важное);
Возврат;
КонецЕсли;

// Логика утверждения
Док = ЭтотОбъект.Объект;
Док.Утвердить();
Сообщить("Документ утверждён!", СтатусСообщения.Информация);
КонецПроцедуры

Чтобы кнопка была неактивна для пользователей без прав, настройте свойство Доступность команды:

Процедура ПриОткрытии(Отказ)
КомандаУтвердить = ЭлементыФормы.УтвердитьДокумент;
КомандаУтвердить.Доступность = РолиДоступа.НазначенаРоль("Руководитель");
КонецПроцедуры

Пример 4: Команда с параметрами

Иногда команде нужно передавать дополнительные данные. Например, при экспорте в Excel можно выбрать, какие колонки включать. Для этого используем параметр Параметр:

Процедура ЭкспортВExcel(Команда)
// Показываем диалог с настройками экспорта
ПараметрыЭкспорта = Новый Структура();
ПараметрыЭкспорта.Вставить("ВключатьЗаголовки", Истина);
ПараметрыЭкспорта.Вставить("ТолькоВидимыеКолонки", Ложь);

// Вызываем общую процедуру экспорта с параметрами
ОбщийМодуль.ЭкспортироватьВExcel(ЭтотОбъект, ПараметрыЭкспорта);
КонецПроцедуры

В общем модуле процедура может выглядеть так:

Процедура ЭкспортироватьВExcel(Форма, Параметры) Экспорт
Таблица = Форма.ЭлементыФормы.ТаблицаДокументов;
Экспорт = Новый ЭкспортВExcel;
Экспорт.ВключатьЗаголовки = Параметры.ВключатьЗаголовки;
Экспорт.ТолькоВидимыеКолонки = Параметры.ТолькоВидимыеКолонки;
Экспорт.Экспортировать(Таблица);
КонецПроцедуры

Пример 5: Асинхронная команда (для длинных операций)

Если команда выполняет долгую операцию (например, обмен данными с внешней системой), её стоит сделать асинхронной, чтобы не блокировать интерфейс:

Процедура ОбменС1СБухгалтерией(Команда)
// Показываем прогресс-бар
Прогресс = Новый ПрогрессОперации();
Прогресс.Начать("Выполняется обмен...");

// Запускаем обмен в фоновом потоке
ФоновоеЗадание = ФоновыеЗадания.Выполнить(
"ОбщийМодуль.ВыполнитьОбменСБухгалтерией",
Прогресс,
Новый Структура("Документ", ЭтотОбъект.Объект)
);
КонецПроцедуры

В общем модуле:

Процедура ВыполнитьОбменСБухгалтерией(Прогресс, Параметры) Экспорт
Док = Параметры.Документ;
// Логика обмена
Прогресс.Закрыть();
КонецПроцедуры

💡

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

Типичные ошибки и их решение

При работе с командами формы в 1С разработчики часто сталкиваются с типичными проблемами. Разберём самые распространённые и способы их исправления.

Ошибка 1: Команда не отображается на форме

Если вы добавили команду, но она не появляется в интерфейсе, проверьте:

• 🔹 Привязана ли команда к элементу интерфейса (кнопке, меню). Без привязки команда существует, но не видна пользователю.
• 🔹 Правильно ли заполнено свойство Действие у кнопки. Оно должно совпадать с именем команды.
• 🔹 Сохранена ли конфигурация после добавления команды. Иногда изменения не применяются из-за забытого Ctrl+S.
• 🔹 Нет ли ошибок в модуле формы. Если в коде обработчика синтаксическая ошибка, команда может не отобразиться.

Чтобы диагностировать проблему, откройте форму в 1С:Предприятие в режиме отладки (Ctrl+Alt+F5) и проверьте журнал сообщений.

Ошибка 2: Обработчик команды не срабатывает

Если при нажатии на кнопку ничего не происходит:

• 🔹 Убедитесь, что имя процедуры-обработчика совпадает с именем команды. Например, если команда называется ПечатьАкта, то процедура должна быть:

Процедура ПечатьАкта(Команда)
// Ваш код
КонецПроцедуры

• 🔹 Проверьте, в каком модуле находится обработчик. Если команда создана в общих командах, а обработчик — в модуле формы, они не свяжутся.
• 🔹 Убедитесь, что нет исключений в коде. Добавьте в начало обработчика строку Сообщить("Начало работы");, чтобы проверить, доходит ли выполнение до неё.

Ошибка 3: Команда неактивна (заблокирована)

Если кнопка серого цвета и не нажимается, причины могут быть такие:

• 🔹 Свойство Доступность команды установлено в Ложь. Проверьте код, который управляет доступностью (например, в процедуре ПриОткрытии).
• 🔹 Отсутствуют права у пользователя. Если команда привязана к роли, а у текущего пользователя её нет, кнопка будет неактивна.
• 🔹 Команда отмечена как ТолькоПросмотр в свойствах.

Пример кода для отладки доступности:

Процедура ПриОткрытии(Отказ)
Сообщить("Доступность команды: " + ЭлементыФормы.МояКоманда.Доступность);
КонецПроцедуры

Ошибка 4: Команда дублируется или конфликтует

Если одна и та же команда появляется несколько раз или конфликтует с другими командами:

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

Ошибка 5: Горячие клавиши не работают

Если сочетание клавиш не срабатывает:

• 🔹 Убедитесь, что комбинация не конфликтует с системными клавишами (например, Ctrl+C уже занято копированием).
• 🔹 Проверьте, что свойство СочетаниеКлавиш заполнено правильно. Например, Ctrl+Shift+P должно быть записано именно так, а не как Ctrl+Shift+P.
• 🔹 Если команда в контекстном меню, убедитесь, что фокус находится на нужном элементе (например, на строке таблицы).
💡

Чтобы проверить конфликты горячих клавиш, откройте форму в пользовательском режиме и нажмите Shift+F1 — откроется окно со всеми закреплёнными сочетаниями.

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

В этом разделе — рекомендации, которые помогут сделать работу с командами формы более эффективной.

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

Если у вас много команд, объединяйте их в группы. Это упрощает управление и делает интерфейс чище. Например:

• 🔹 Группа "Печать" — команды "Печать", "Печать с подписью", "Экспорт в PDF".
• 🔹 Группа "Действия" — команды "Провести", "Отменить проведение", "Утвердить".

Чтобы создать группу:

1. В палитре свойств формы перейдите на вкладку Команды.
2. Нажмите Добавить → Группа команд.
3. Задайте имя и заголовок группы.
4. Перетащите команды в группу мышью.

Совет 2: Настраивайте видимость команд динамически

Команды можно показывать или скрывать в зависимости от условий. Например, кнопка "Утвердить" видна только для неутверждённых документов:

Процедура ПриОткрытии(Отказ)
Если ЭтотОбъект.Объект.ЭтоГруппа Тогда
ЭлементыФормы.Утвердить.Видимость = Ложь;
Иначе
ЭлементыФормы.Утвердить.Видимость = НЕ ЭтотОбъект.Объект.Утверждён;
КонецЕсли;
КонецПроцедуры

Совет 3: Используйте стандартные команды платформы

В 1С есть встроенные команды (например, Создать, Изменить, Удалить). Старайтесь использовать их вместо создания своих, чтобы интерфейс был знаком пользователям. Список стандартных команд можно найти в синтакс-помощнике по запросу "Стандартные команды".

Совет 4: Тестируйте команды в разных режимах

Перед выпуском обновления проверьте работу команд:

• 🔹 В режиме 1С:Предприятие (не только в конфигураторе!).
• 🔹 Под разными ролями (администратор, пользователь, гость).
• 🔹 На разных формах, если команда универсальная.
• 🔹 С разными данными (пустой документ, заполненный, с ошибками).

Совет 5: Документируйте команды

Если в вашем решении много команд, ведите документацию:

• 🔹 Имя команды — для чего она предназначена.
• 🔹 Обработчик — где находится код (модуль формы, общий модуль).
• 🔹 Права — какие роли имеют доступ.
• 🔹 Параметры — если команда принимает дополнительные данные.

Это поможет другим разработчикам (или вам через полгода) быстро разобраться в коде.

Расширенные возможности: команды с параметрами и асинхронные задачи

Для сложных сценариев стандартных команд может быть недостаточно. Рассмотрим продвинутые техники.

Команды с параметрами

Если команде нужно передавать данные (например, ID документа или флаги настроек), используйте параметр Параметр в обработчике:

Процедура МояКоманда(Команда)
Параметры = Команда.Параметр; // Получаем параметры
Если Параметры.СодержитКлюч("Документ") Тогда
Док = Параметры.Документ;
// Работаем с документом
КонецЕсли;
КонецПроцедуры

Чтобы передать параметры при вызове команды:

ПараметрыВызова = Новый Структура();
ПараметрыВызова.Вставить("Документ", ТекущийДокумент);
ЭлементыФормы.МояКоманда.Выполнить(ПараметрыВызова);

Асинхронные команды

Для длинных операций (обмен данными, формирование больших отчётов) используйте ФоновыеЗадания