Другое · 6 мин
Программное добавление команды в контекстное меню 1С
Разберём, как программно добавить команду в контекстное меню формы 1С:Enterprise, где разместить код, как проверить результат и каких ошибок избежать.
В управляемых формах 1С:Предприятия контекстное меню формируется из команд формы. Если стандартного набора действий недостаточно, команду можно добавить программно, не оформляя её вручную через редактор команд. Это актуально для списков справочников, документов, регистров и отчётов, где пользователь ожидает быстрое действие по правой кнопке мыши над выделенной строкой.
Команда добавляется в модуле формы, обычно в процедуре ПриОткрытии, через коллекцию Команды. Для появления в контекстном меню у команды нужно задать отображение и реализовать обработчик нажатия. Разберём порядок действий, условия отображения, проверку и границы безопасной самостоятельной работы.
Когда команда появляется в контекстном меню
Контекстное меню отображает только те команды формы, у которых свойство отображения включает контекстное меню. Если команда предназначена только для командной панели, она не появится при правом клике по списку. Также команда должна быть видимой и доступной в текущем режиме работы формы.
Важно различать обычные и управляемые формы. В управляемом приложении команды настраиваются в модуле формы на клиенте, а в обычном приложении порядок может отличаться. Перед правкой уточните тип приложения и клиент, который будут использовать сотрудники.
- 1Откройте модуль формы в конфигураторе
- 2Добавьте команду в процедуру ПриОткрытии через Элементы.Команды.Добавить
- 3Укажите Отображение = ОтображениеКоманды.КонтекстноеМеню
- 4Создайте обработчик нажатия команды
- 5Сохраните конфигурацию и обновите информационную базу
- 6Откройте форму и проверьте контекстное меню
Добавление команды в модуле управляемой формы
В модуле управляемой формы команда создаётся процедурой ПриОткрытии. Пример минимального набора свойств: имя команды, заголовок, подсказка, отображение контекстного меню и ссылка на обработчик. Имя команды используется для генерации имени процедуры-обработчика.
Процедура ПриОткрытии()
Команда = Элементы.Команды.Добавить("МояКоманда", ВидКоманды.Команда);
Команда.Заголовок = "Выполнить действие";
Команда.Подсказка = "Запускает дополнительную обработку выделенной строки";
Команда.Отображение = ОтображениеКоманды.КонтекстноеМеню;
Команда.ПоказыватьВКонтекстномМеню = Истина;
КонецПроцедуры
Обработчик нажатия команды
Обработчик называется по соглашению: имя команды плюс Нажатие, например МояКомандаНажатие. В параметрах передаётся элемент, через который можно получить текущую строку или выделенный объект. Если обработчик не найден, при клике по команде возникнет ошибка выполнения.
Как проверить результат
Отображается с правильным заголовком
Отсутствует или неактивна
Выполняется без ошибок
Ошибка компиляции или отсутствует процедура
Обрабатывает текущую строку
Действует не на тот объект
Внутри обработчика можно обращаться к объекту формы, текущим данным и вызывать общие модули. Действия, меняющие данные, лучше выполнять на сервере через вызов серверной процедуры, чтобы избежать лишних передач данных между клиентом и сервером.
Форма документа и отчёта: особенности
В форме документа контекстное меню часто связано с табличной частью или основными реквизитами. Команда добавляется аналогично, но обработчик должен учитывать, какая часть формы активна в момент вызова. Для отчётов команда может быть лишней, если отчёт не содержит интерактивного списка.
Если форма открывается в модальном окне, контекстное меню работает в рамках этого окна. При вложенных формах или командах панели навигации проверяйте, к какому именно элементу относится выделение, иначе команда может действовать не на ту строку.
Проверка результата и признаки корректной работы
После обновления конфигурации откройте соответствующий список, выделите строку и нажмите правую кнопку мыши. Команда должна отображаться с указанным заголовком, а при выборе вызывать обработчик без ошибок. Если команда отсутствует, проверьте свойство отображения и права доступа пользователя.
Права доступа, клиент-сервер и веб-клиент
Команда может быть скрыта для пользователей без необходимых прав. Проверьте роли и права на объекты, которые затрагивает обработчик. На сервере команда не отображается напрямую, поэтому логику изменения данных выносите в серверные процедуры, а клиентская часть только инициирует вызов.
В веб-клиенте и мобильном клиенте поведение контекстного меню может отличаться от толстого клиента. Некоторые свойства отображения или сочетания клавиш работают иначе. Перед внедрением проверьте команду именно в том клиенте, который используется в компании.
Типичные ошибки и как их исправить
Альтернативы: расширение конфигурации и стандартные средства
Если конфигурация поддерживает обновления, правку модулей форм поставщика лучше заменять на расширение конфигурации. Это упрощает поддержку и снижает риск потери изменений. Для простых действий иногда достаточно стандартных команд формы или внешней обработки без программирования.
Самостоятельная разработка допустима на копии базы и при понимании последствий. Если команда затрагивает закрытые периоды, проводки или регистры бухгалтерии, изменения следует согласовать с ответственным за учёт и проверить на тестовых данных.
Что важно запомнить
Команду добавляют через Элементы.Команды.Добавить, задают отображение контекстного меню и пишут обработчик нажатия. Проверяйте на копии базы и в целевом клиенте.
Нужно ли программировать добавление каждой команды?
Не всегда. Если действие уже реализовано стандартной командой формы или внешней обработкой, программное добавление избыточно. Программирование оправдано, когда нужна специфическая логика, связанная с выделенной строкой или текущим документом.
Где разместить код добавления команды?
Обычно в процедуре ПриОткрытии модуля управляемой формы. Код размещается на клиенте, так как команды формы относятся к клиентскому интерфейсу. Серверная логика вызова выносится в отдельные серверные процедуры.
Почему команда может не появиться в контекстном меню?
Возможные причины: свойство отображения не включает контекстное меню, команда скрыта или недоступна по правам, обработчик отсутствует, либо используется обычная форма с иным порядком настройки. Проверьте все эти условия по очереди.
Безопасно ли править конфигурацию поставщика напрямую?
Прямая правка небезопасна: при обновлении конфигурации изменения могут пропасть или вызвать конфликты. Предпочитайте расширение конфигурации, тестируйте на копии информационной базы и делайте резервную копию перед внесением правок.
Работает ли команда одинаково в веб-клиенте?
Не всегда. Поведение контекстного меню в веб-клиенте и мобильном приложении может отличаться от толстого клиента. Проверяйте команду именно в том клиенте, где она будет использоваться сотрудниками.