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

Другое · 6 мин

Как сделать кнопку в конфигураторе 1С

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

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

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

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

Что такое кнопка в конфигураторе 1С

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

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

Выбор формы и типа кнопки

Управляемая форма

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

Обычная форма

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

Создание команды и размещение кнопки на форме

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

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

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

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

Обработчик нажатия и серверный вызов

Напишите процедуру обработки нажатия в модуле формы. Для клиентских действий используйте директиву НаКлиенте, для работы с базой и записями данных — НаСервере с вызовом из клиентской процедуры. Имя процедуры должно совпадать с именем, указанным в команде или свойстве кнопки.

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

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

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

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

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

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

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

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

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

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

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

Видимость кнопки
Норма

Кнопка видна там, где должна быть

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

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

Результат нажатия
Норма

Данные изменились ожидаемым образом

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

Ошибка выполнения или отсутствие реакции

Права пользователя
Норма

Доступ есть у целевых ролей

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

Кнопка недоступна обычному пользователю

Как проверить, что кнопка работает корректно

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

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

Итог

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

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

Нужно ли программировать кнопку в 1С?

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

В чем разница между кнопкой на командной панели и кнопкой на форме?

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

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

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

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

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

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

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