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