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

Другое · 6 мин

Как добавить кнопку в 1С 8.3

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

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

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

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

Кнопка размещается на форме документа, справочника, отчёта или обработки. Её вид и поведение зависят от типа приложения: в управляемом элемент добавляется через палитру элементов формы, в обычном — через свойства формы в конфигураторе.

Главное условие рабочей кнопки — корректный обработчик события «Нажатие». Без него элемент будет отображаться, но при клике не произойдёт ничего.

Где кнопка может появиться в 1С 8.3

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

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

Подготовка конфигурации к правке

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

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

Создание кнопки на форме документа или справочника

Для управляемого приложения

В дереве конфигурации найдите нужную форму и откройте её редактор. Перетащите элемент типа «Кнопка» с панели элементов на нужное место формы или командную панель.

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

После размещения задайте уникальное имя кнопки, понятное представление и подсказку. Имя используется в коде, представление видит пользователь.

Для обычного приложения

Откройте форму в конфигураторе, перейдите на вкладку элементов и создайте кнопку. Установите свойства «Представление» и «Имя», а затем привяжите процедуру обработчика.

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

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

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

Проверка и публикация изменений

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

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

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

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

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

Открытие формы с кнопкой
Норма

Кнопка видна и доступна для нажатия

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

Кнопка отсутствует, серая или форма открывается с ошибкой

Нажатие кнопки
Норма

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

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

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

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

Зафиксируйте внесённые правки в описании конфигурации, чтобы последующие правки не конфликтовали с добавленной кнопкой.

Ограничения и частые ошибки

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

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

Не добавляйте на одну форму слишком много кнопок без группировки: это усложняет интерфейс и увеличивает вероятность ошибочного нажатия.

Итог

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

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

Нужны ли права администратора для добавления кнопки?

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

Работает ли кнопка сразу после сохранения в конфигураторе?

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

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

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

Что делать, если кнопка серая и недоступна?

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

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

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