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

Другое · 9 мин

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

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

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

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

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

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

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

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

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

Форма документаУправляемая или обычная

Определяет порядок размещения элементов и доступные свойства кнопки

Место кнопкиКомандная панель или форма

Влияет на способ добавления и видимость для пользователя

Режим конфигурацииДоступна ли правка

Показывает, можно ли вносить изменения напрямую или нужно использовать расширение

При создании кнопки задают её имя, представление, подсказку и картинку. Имя используется в коде, представление видит пользователь, а подсказка появляется при наведении. Корректное именование упрощает поиск ошибки, если кнопка не срабатывает.

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

Добавление кнопки на форму документа

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

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

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

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

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

Назначение действия кнопке

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

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

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

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

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

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

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

Ограничения и безопасные изменения

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

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

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

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

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

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

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

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

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

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

Отображение кнопки на форме документа
Норма

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

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

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

Выполнение команды при нажатии
Норма

Обработчик отрабатывает и дает ожидаемый результат

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

Нажатие не вызывает действия или возникает ошибка

Доступ для разных ролей
Норма

Кнопка доступна только разрешенным пользователям

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

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

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

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

Итог

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

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

Нужно ли быть программистом, чтобы добавить кнопку?

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

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

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

Почему кнопка есть в конфигураторе, но не видна пользователям?

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

Что делать, если кнопка вызывает ошибку при нажатии?

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

Нужно ли создавать резервную копию перед правкой?

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