Как создать кнопку на форме документа в 1С

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

Материал ориентирован на управляемые формы — они используются в большинстве современных конфигураций (Управление торговлей, Бухгалтерия предприятия, ERP и другие на платформе 8.3). Для обычных форм логика похожа, но редактор формы устроен иначе, и отдельные шаги будут отличаться.

Определите, где и как вы будете добавлять кнопку

Первое решение — изменять саму конфигурацию или создавать расширение. Если это собственная (самописная) конфигурация или типовая, снятая с поддержки, можно редактировать форму документа напрямую. Если конфигурация типовая и обновляется автоматически, прямое изменение приведёт к сложностям при обновлении: доработки придётся сравнивать и объединять вручную.

Второе решение — где именно разместить кнопку. Варианты: командная панель формы (верхняя полоса с кнопками «Провести», «Записать»), командная панель табличной части (для действий со строками), отдельная группа на форме или контекстное меню. От места зависит, как пользователь будет находить кнопку и какие данные будут доступны в обработчике.

Создайте команду формы

Откройте конфигуратор, найдите нужный документ в дереве конфигурации (ветка «Документы»), раскройте его и дважды щёлкните по форме документа — обычно она называется «ФормаДокумента». Если формы нет, её нужно сначала создать через конструктор форм.

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

После создания команды платформа предложит создать обработчик — согласитесь, выбрав тип «На клиенте». В модуль формы добавится заготовка процедуры &НаКлиенте Процедура ЗаполнитьПоОстаткам(Команда) ... КонецПроцедуры. Код обработчика рассмотрим ниже.

Разместите кнопку на форме

Команда сама по себе невидима — чтобы появилась кнопка, команду нужно перетащить мышью из списка команд в дерево элементов формы (левая часть редактора). Платформа автоматически создаст элемент «Кнопка формы», связанный с этой командой.

Куда перетаскивать: чтобы кнопка оказалась в верхней командной панели — перетащите на элемент «КоманднаяПанель» формы. Чтобы в панель табличной части — на командную панель соответствующей таблицы. Чтобы кнопка стояла отдельно в теле формы — создайте группу и перетащите команду в неё.

У созданной кнопки можно настроить свойства: «Важность» (выделение цветом для основного действия), «Отображение» (картинка, надпись или оба варианта), «ТолькоВоВсехДействиях» (скрыть кнопку в меню «Ещё», если она второстепенная). Для редко используемых действий разумно сразу убирать кнопку в «Ещё», чтобы не перегружать панель.

1. 1
   Откройте форму документа в конфигураторе
2. 2
   На вкладке «Команды» создайте команду формы с понятным именем и заголовком
3. 3
   Согласитесь на создание обработчика и выберите контекст «На клиенте»
4. 4
   Перетащите команду в дерево элементов — в командную панель или группу
5. 5
   Напишите код обработчика в модуле формы
6. 6
   Обновите конфигурацию базы данных (F7) и проверьте кнопку в режиме предприятия

Напишите обработчик команды

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

Типовой шаблон: клиентская процедура запускается кнопкой, при необходимости задаёт вопрос пользователю, затем вызывает серверную процедуру, которая делает основную работу с данными объекта.

&НаКлиенте
Процедура ЗаполнитьПоОстаткам(Команда)
ЗаполнитьПоОстаткамНаСервере();
ЭтотОбъект.Модифицированность = Истина;
КонецПроцедуры

&НаСервере
Процедура ЗаполнитьПоОстаткамНаСервере()
// Работа с данными объекта через реквизит "Объект"
Для Каждого СтрокаТовара Из Объект.Товары Цикл
// логика заполнения строки
КонецЦикла;
КонецПроцедуры

Данные текущего документа в модуле формы доступны через реквизит Объект (типа «ДанныеФормыСтруктура»). Изменения, сделанные на сервере через Объект, автоматически отобразятся на форме. Помните: серверная процедура без контекста серверного вызова должна быть помечена директивой &НаСервере, а вызываться из клиентской — просто по имени.

&НаКлиенте
Процедура ПечатьСчета(Команда)
	Если Объект.Ссылка.Пустая() Тогда
		ПоказатьПредупреждение(, "Сначала запишите документ");
		Возврат;
	КонецЕсли;
КонецПроцедуры

Добавление кнопки через расширение конфигурации

Если типовую конфигурацию менять нельзя, создайте расширение: в конфигураторе откройте «Конфигурация» → «Расширения конфигурации» → «Создать». Задайте имя и префикс (он добавится к именам заимствованных объектов, например «Расш1_»).

В дереве расширения найдите нужный документ, раскройте его формы, вызовите контекстное меню у формы документа и выберите «Добавить в расширение». Форма скопируется в расширение. Дальше действия те же: на вкладке «Команды» добавьте свою команду (она будет с префиксом расширения), перетащите её в дерево элементов и напишите обработчик в модуле формы расширения.

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

Проверка результата и типичные ошибки

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

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

Часто задаваемые вопросы