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

Другое · 7 мин

Создание кнопки в управляемой форме 1С

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

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

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

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

Создать команду на управляемой форме

Откройте форму объекта в конфигураторе и перейдите к её командам. Создайте новую команду, укажите ей понятное имя, заголовок, который будет виден пользователю, и выберите тип команды. Обычно для обычной кнопки подходит команда типа «Действие» или «Обработка», в зависимости от того, должна ли команда выполняться на клиенте или на сервере.

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

Порядок действий
  1. 1
    Открыть форму объекта в конфигураторе
  2. 2
    Создать команду формы и задать заголовок
  3. 3
    Сохранить форму и проверить список команд

Разместить кнопку на командной панели или в действиях

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

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

Написать обработчик нажатия кнопки

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

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

Управлять видимостью и доступностью кнопки

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

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

Проверить результат и частые ошибки

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

Частые ошибки: команда создана, но не добавлена на панель; заголовок команды пустой; обработчик содержит опечатку в имени процедуры; кнопка недоступна из-за условия доступности; изменения не сохранены в конфигураторе. Также кнопка может не отображаться в веб-клиенте, если форма не адаптирована для этого клиента.

Типичные ошибки
01
Команда создана, но не размещена на командной панели
02
Обработчик не сработал из-за несоответствия имени процедуры
03
Кнопка недоступна из-за условия доступности или прав

Когда обращаться к разработчику и ограничения самостоятельной работы

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

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

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

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

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

Кнопка отображается в нужном месте

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

Кнопка отсутствует или неактивна

Нажатие отрабатывает
Норма

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

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

Появляется ошибка или ничего не происходит

Альтернативы и ограничения командных кнопок

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

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

Итог

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

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

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

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

Можно ли изменить типовую форму напрямую?

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

Почему кнопка не отображается после создания?

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

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

Используйте свойство доступности команды или программное управление в модуле формы в зависимости от ролей и состояния данных. Проверяйте поведение под разными правами доступа перед вводом в эксплуатацию.