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

Другое · 6 мин

Как в 1С назначить кнопку на форму

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

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

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

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

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

Где может быть кнопка в 1С

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

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

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

Как создать команду конфигурации

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

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

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

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

Как разместить кнопку на форме

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Элемент отображается в нужном месте

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

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

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

Открывается форма или записываются данные

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

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

Доступ у целевого пользователя
Норма

Пользователь видит и использует кнопку

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

Кнопка скрыта из-за прав доступа

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

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

Итог

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

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

Часто задаваемые вопросы

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

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

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

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

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

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

Чем команда конфигурации отличается от кнопки формы?

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