К статье
Практический материал

Другое · 6 мин

Программное добавление команды в контекстное меню 1С

Разберём, как программно добавить команду в контекстное меню формы 1С:Enterprise, где разместить код, как проверить результат и каких ошибок избежать.

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

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

Когда команда появляется в контекстном меню

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

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

Порядок добавления команды
  1. 1
    Откройте модуль формы в конфигураторе
  2. 2
    Добавьте команду в процедуру ПриОткрытии через Элементы.Команды.Добавить
  3. 3
    Укажите Отображение = ОтображениеКоманды.КонтекстноеМеню
  4. 4
    Создайте обработчик нажатия команды
  5. 5
    Сохраните конфигурацию и обновите информационную базу
  6. 6
    Откройте форму и проверьте контекстное меню

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

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

Процедура ПриОткрытии()
Команда = Элементы.Команды.Добавить("МояКоманда", ВидКоманды.Команда);
Команда.Заголовок = "Выполнить действие";
Команда.Подсказка = "Запускает дополнительную обработку выделенной строки";
Команда.Отображение = ОтображениеКоманды.КонтекстноеМеню;
Команда.ПоказыватьВКонтекстномМеню = Истина;
КонецПроцедуры

Обработчик нажатия команды

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

Контрольные точки

Как проверить результат

Команда в контекстном меню
Норма

Отображается с правильным заголовком

Тревожный признак

Отсутствует или неактивна

Обработчик нажатия
Норма

Выполняется без ошибок

Тревожный признак

Ошибка компиляции или отсутствует процедура

Действие над выделением
Норма

Обрабатывает текущую строку

Тревожный признак

Действует не на тот объект

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

Форма документа и отчёта: особенности

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

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

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

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

Права доступа, клиент-сервер и веб-клиент

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

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

Типичные ошибки и как их исправить

Типичные ошибки
01
Команда не отображается: не задан Отображение = ОтображениеКоманды.КонтекстноеМеню
02
Ошибка при клике: обработчик назван неправильно или отсутствует в модуле формы
03
Команда недоступна пользователю: недостаточно прав на объект или форму

Альтернативы: расширение конфигурации и стандартные средства

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

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

Итог

Что важно запомнить

Команду добавляют через Элементы.Команды.Добавить, задают отображение контекстного меню и пишут обработчик нажатия. Проверяйте на копии базы и в целевом клиенте.

Нужно ли программировать добавление каждой команды?

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

Где разместить код добавления команды?

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

Почему команда может не появиться в контекстном меню?

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

Безопасно ли править конфигурацию поставщика напрямую?

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

Работает ли команда одинаково в веб-клиенте?

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