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