Создание кнопки на форме документа в 1С: полное руководство для разработчиков

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

Особенность работы с формами в 1С 8.3 заключается в том, что интерфейсные элементы могут добавляться как в управляемом приложении, так и в обычном. Алгоритмы создания кнопок для этих режимов имеют ключевые различия, которые мы подробно рассмотрим. Кроме того, вы узнаете, как сделать кнопку видимой только для определенных ролей, как динамически менять её свойства в зависимости от данных документа, и какие инструменты конфигуратора ускорят процесс разработки.

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

Подготовка к работе: инструменты и настройки

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

• 🖥️ Конфигуратор 1С с правами администратора (версия не ниже 8.3.10 — для полной поддержки управляемых форм)
• 📄 Конфигурация, в которой разрешено редактирование (лучше использовать копию рабочей базы)
• 🔧 Отладочные инструменты: встроенный отладчик, журнал регистрации, тестирование и исправление
• 📚 Документация по синтаксису встроенного языка (особенно раздел про работу с формами)

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

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

Способы добавления кнопки на форму документа

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

1. Через редактор форм — визуальный способ, подходит для простых кнопок без сложной логики. Доступен в обоих типах приложений.
2. Программное создание — кнопка добавляется через код в модуле формы. Гибкий метод, позволяет динамически управлять элементом.
3. Использование расширений — кнопка добавляется через механизм расширений конфигурации (актуально для типовой базы, где нельзя изменять оригинальные объекты).

Рассмотрим каждый способ подробнее, начиная с самого простого.

Метод 1: Визуальное добавление через редактор форм

Это базовый способ, который подходит для большинства стандартных задач. Инструкция актуальна для управляемых форм (8.3) и обычных форм (8.2):

1. Откройте конфигуратор и найдите нужный документ в дереве объектов (например, Документы → ЗаказПокупателя).
2. Дважды кликните на форму документа (или выберите Формы → ФормаДокумента в контекстном меню).
3. В редакторе форм перейдите на вкладку Элементы (для управляемых форм) или Реквизиты (для обычных).
4. Нажмите кнопку Добавить элемент (или перетащите элемент Кнопка из палитры инструментов).
5. Настройте свойства кнопки в панели справа: Имя, Заголовок, Тип (обычно Кнопка), Действие.

Для управляемых форм после добавления кнопки автоматически создается обработчик события Нажатие. В обычных формах обработчик нужно создавать вручную в модуле формы.

Открыт конфигуратор с правами администратора

Создана резервная копия конфигурации

Выбран правильный документ в дереве объектов

Определено место размещения кнопки на форме-->

Метод 2: Программное создание кнопки

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

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
// Создаем кнопку программно
Кнопка = ЭлементыФормы.Добавить("МояДинамическаяКнопка", Тип("Кнопка"));
Кнопка.Заголовок = "Рассчитать скидку";
Кнопка.Видимость = Ложь; // Скрыта по умолчанию

// Показываем кнопку только для менеджеров
Если ТекущийПользователь().Имя = "ИвановИИ" Тогда
Кнопка.Видимость = Истина;
КонецЕсли;
КонецПроцедуры

Для обычных форм код будет отличаться:

Процедура ПриОткрытии()
Кнопка = ЭлементыФормы.ДобавитьКнопку("МояКнопка", Тип("Кнопка"));
Кнопка.Заголовок = "Экспорт в Excel";
Кнопка.Нажатие = "МояКнопкаНажатие"; // Имя обработчика
КонецПроцедуры

Процедура МояКнопкаНажатие()
// Логика обработки нажатия
Сообщить("Кнопка нажата!");
КонецПроцедуры

Программный метод дает больше возможностей для управления кнопкой, но требует знания синтаксиса 1С и понимания контекста выполнения кода (клиент/сервер).

Настройка свойств кнопки: от заголовка до видимости

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

Особое внимание уделите свойству Действие — оно определяет, что будет происходить при нажатии. Варианты:

• 📝 Выполнить команду — связывает кнопку с командой формы (например, Печать или Провести)
• 🖱️ Открыть форму — открывает другую форму (справочника, документа, отчета)
• 📊 Выполнить обработчик — вызывает процедуру в модуле формы
• 🔗 Перейти по ссылке — открывает веб-страницу или файл

Для динамического изменения свойств кнопки используйте события формы. Например, чтобы скрыть кнопку "Провести" для непроводённых документов:

Процедура ПриИзмененииДанных(Элемент)
Если Объект.Проводен Тогда
ЭлементыФормы.Провести.Видимость = Ложь;
Иначе
ЭлементыФормы.Провести.Видимость = Истина;
КонецЕсли;
КонецПроцедуры

Если Объект.Статус = Перечисление.СтатусыДокументов.Утвержден Тогда
ЭлементыФормы.МояКнопка.ЦветФона = ВебЦвета.Зеленый;
ИначеЕсли Объект.Статус = Перечисление.СтатусыДокументов.Отклонен Тогда
ЭлементыФормы.МояКнопка.ЦветФона = ВебЦвета.Красный;
КонецЕсли;

Программирование обработчика нажатия кнопки

Самая важная часть работы с кнопкой — это логика, которая выполняется при её нажатии. Обработчик можно создать:

• 🛠️ Автоматически — при добавлении кнопки через редактор форм (для управляемых форм)
• 📜 Вручную — через модуль формы (для обычных форм или сложной логики)

Пример обработчика для кнопки, которая печатает документ в PDF:

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

// Формируем печатную форму
ПечатнаяФорма = Новый ПечатнаяФормаДокумента(Объект);
ПечатнаяФорма.Печать();

// Альтернативно: сохранение в файл
// ПечатнаяФорма.СохранитьКак("C:\Temp\Документ.pdf");
КонецПроцедуры

Для сложных операций (например, обмен данными с внешними системами) обработчик лучше разделить на клиентскую и серверную части:

// Клиентская часть
Процедура МояКнопкаНажатие(Кнопка)
ОткрытьФормуМодально("Документ.МояФормаОбработки", Новый Структура("Документ, Параметр1, Параметр2", Объект, Значение1, Значение2));
КонецПроцедуры

// Серверная часть (в модуле формы обработки)
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
// Получаем параметры из клиентской части
Документ = Параметры.Документ;
// ... логика обработки ...
КонецПроцедуры

При работе с обработчиками помните о контексте выполнения:

• 🖥️ Клиентский контекст — подходит для взаимодействия с пользователем (сообщения, диалоги)
• 🗃️ Серверный контекст — для работы с данными (запросы, записи в базу)

Типичные ошибки и их решение

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

⚠️ Внимание: Если кнопка не отображается на форме, проверьте свойство Видимость в коде и настройках формы. Часто проблема кроется в конфликте динамического и статического управления видимостью.

Ещё одна распространённая проблема — конфликт имен. Если имя кнопки совпадает с именем реквизита или другого элемента формы, платформа может вести себя непредсказуемо. Всегда используйте уникальные имена с префиксами (например, Кнопка_ПечатьАкта).

Для отладки кода обработчика используйте точки останова и вывод в журнал:

Процедура МояКнопкаНажатие(Кнопка)
ЗаписьЖурналаРегистрации("Начало обработки кнопки", УровеньЖурналаРегистрации.Информация);

Попытка
// Ваш код
Исключение
ЗаписьЖурналаРегистрации("Ошибка: " + ОписаниеОшибки(), УровеньЖурналаРегистрации.Ошибка);
ПоказатьОшибку(ОписаниеОшибки());
КонецПопытки;
КонецПроцедуры

Расширенные возможности: динамические кнопки и права доступа

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

Динамическое создание кнопок в зависимости от данных

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

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Для Каждого Строка Из Объект.Товары Цикл
ИмяКнопки = "КнопкаУдалить_" + Строка.НомерСтроки;
Кнопка = ЭлементыФормы.Добавить(ИмяКнопки, Тип("Кнопка"));
Кнопка.Заголовок = "Удалить строку " + Строка.НомерСтроки;
Кнопка.Верх = 10 + (Строка.НомерСтроки - 1) * 30;
КонецЦикла;
КонецПроцедуры

Управление видимостью по ролям

Чтобы кнопка была видна только пользователям с определенной ролью:

Процедура ПриОткрытии()
Если НЕ РолиПользователя().Найти("Администратор") Тогда
ЭлементыФормы.АдминскаяКнопка.Видимость = Ложь;
КонецЕсли;
КонецПроцедуры

Кнопки с подтверждением действия

Для критичных операций (например, удаление) добавьте диалог подтверждения:

Процедура УдалитьДокументНажатие(Кнопка)
Если Вопрос("Вы уверены, что хотите удалить документ?", РежимДиалогаВопрос.ДаНет) = КодВозвратаДиалога.Да Тогда
Объект.Удалить();
Закрыть();
КонецЕсли;
КонецПроцедуры

Для сложных сценариев можно комбинировать эти подходы. Например, кнопка "Экспорт в Excel" будет видна только менеджерам и только для проведенных документов:

Процедура ПриИзмененииДанных(Элемент)
Видимость = (Объект.Проводен) И (ТекущийПользователь().Роль = "Менеджер");
ЭлементыФормы.ЭкспортВExcel.Видимость = Видимость;
КонецПроцедуры

Кнопка = ЭлементыФормы.Добавить("МояКнопкаСМеню", Тип("КнопкаСМеню"));
Кнопка.Меню = Команды.МояКомандаСМеню;

Оптимизация и тестирование

После добавления кнопки на форму необходимо:

1. Протестировать её работу в пользовательском режиме (не только в конфигураторе).
2. Проверить производительность — динамические кнопки могут замедлять открытие формы.
3. Убедиться, что кнопка корректно отображается на всех устройствах (если используется веб-клиент или мобильное приложение).
4. Документировать изменения в описании конфигурации для других разработчиков.

Для тестирования используйте:

• 🔍 Режим отладки — пошаговое выполнение кода обработчика
• 📊 Журнал регистрации — для отслеживания ошибок
• 👥 Тестирование под разными ролями — проверка прав доступа

Если кнопка добавляется в типовую конфигурацию, учитывайте правила поддержки обновлений:

• 🔄 Используйте расширения конфигурации, а не прямые изменения
• 📌 Фиксируйте версии платформы и конфигурации, для которых тестировалось решение
• 📂 Сохраняйте резервные копии перед обновлением типовой конфигурации

Для оптимизации производительности:

• 🚀 Избегайте создания большого количества динамических кнопок (более 20 на форму)
• 🔄 Кэшируйте часто используемые данные в обработчиках
• 📉 Минимизируйте обращения к серверу в клиентских обработчиках

FAQ: Частые вопросы по работе с кнопками на формах 1С

Процедура ОткрытьСвязанныйДокументНажатие(Кнопка)
ПараметрыФормы = Новый Структура("Ключ, Значение", Объект.СвязанныйДокумент);
ОткрытьФорму("Документ.ЗаказПоставщику.ФормаДокумента", ПараметрыФормы);
КонецПроцедуры

Процедура ДобавитьКнопкуНаФорму(Форма)
Кнопка = Форма.ЭлементыФормы.Добавить("ВнешняяКнопка", Тип("Кнопка"));
Кнопка.Заголовок = "Внешняя команда";
Кнопка.Действие = "ВнешняяОбработка.МояКоманда";
КонецПроцедуры

ЭлементыФормы.МояКнопка.Порядок = 1; // Самая левая кнопка
ЭлементыФормы.ДругаяКнопка.Порядок = 2;

ЭлементыФормы.МояКнопка.Картинка = Новый Картинка("Загрузка.Печать");