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

Другое · 8 мин

Добавление кнопки в подменю командной панели 1С

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

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

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

Если задача заключается в динамическом подменю, состав которого меняется в зависимости от данных, стандартная командная панель может быть недостаточна. В таких случаях целесообразно рассматривать альтернативы: открытие формы, контекстное меню или отдельную форму-всплывающее окно, а не попытку втиснуть динамические пункты в статическое подменю панели.

Где настраиваются команды и командная панель

Команды бывают формы и общими. Формальные команды принадлежат конкретной форме и видны в её командной панели, общие команды могут использоваться в нескольких объектах конфигурации. Для каждой команды задаются представление, синоним, картинка, режим использования и область видимости. Эти свойства определяют, будет ли команда отображаться на панели и в каком контексте.

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

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

Как добавить команду и поместить её в подменю

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

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

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

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

Когда можно управлять кнопкой программно

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

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

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

Проверка результата и ограничения

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

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

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

Частые ошибки и альтернативы

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

Типичные ошибки
01
Создание обработчика без добавления команды в командный интерфейс
02
Ожидание мгновенного появления кнопки без обновления конфигурации
03
Игнорирование прав доступа и ролей при проверке видимости

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

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

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

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

Кнопка видна в подменю
Норма

Пункт отображается в заданной группе панели

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

Кнопка отсутствует или находится в другой панели

Обработчик срабатывает
Норма

Выполняется ожидаемое действие без ошибок

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

Нажатие не вызывает действие или вызывает исключение

Права и доступность
Норма

Кнопка доступна только в допустимых условиях

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

Кнопка доступна везде или недоступна для всех

Как проверить, что кнопка работает корректно

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

Если команда работает некорректно, первым делом проверьте команду в дереве конфигурации, её обработчик и включение в командный интерфейс. Сравните настройки с аналогичной работающей кнопкой, если такая есть в конфигурации. Это помогает быстро найти пропущенное свойство или неверный порядок пунктов.

Итог

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

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

Можно ли создать кнопку командной панели только кодом без конфигуратора?

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

В чем разница между командой формы и общей командой?

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

Что делать, если кнопка не появляется после добавления команды?

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

Какая альтернатива подходит для динамического списка пунктов?

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