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