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