Создание кнопок в 1С: от базового интерфейса до программной реализации

Работа с интерфейсами в 1С:Предприятие часто требует добавления новых элементов управления — и кнопки здесь занимают одно из центральных мест. Без них невозможно организовать удобное взаимодействие пользователя с системой: запуск обработок, открытие форм, выполнение команд. Но как правильно создать кнопку, чтобы она не только работала, но и соответствовала корпоративным стандартам платформы?

Эта статья охватывает все аспекты — от добавления кнопки через конструктор форм до написания обработчиков на встроенном языке 1С. Мы разберём типовые сценарии (например, кнопки в документах или справочниках), нюансы работы с управляемыми и обычными формами, а также распространённые ошибки, которые мешают кнопкам функционировать. Особое внимание уделено совместимости с последними версиями платформы 8.3.20+, где изменились некоторые подходы к формированию интерфейса.

Способы добавления кнопок в 1С: обзор вариантов

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

Рассмотрим основные подходы:

• 🔧 Через конструктор форм — самый простой способ для новичков. Подходит для управляемых форм и не требует знания программирования.
• 💻 Программное создание — гибкий метод с использованием языка 1С. Позволяет динамически добавлять кнопки в зависимости от условий.
• 📄 Редактирование макета формы — ручная правка XML-кода формы (для опытных разработчиков).
• 🔄 Наследование и переопределение — изменение стандартных форм без нарушения обновляемости.

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

Создание кнопки через конструктор форм (пошагово)

Это базовый метод, который подойдёт даже тем, кто никогда не работал с конфигуратором 1С. Рассмотрим процесс на примере добавления кнопки в управляемую форму справочника "Номенклатура".

1. Откройте конфигуратор и найдите нужный объект (например, справочник "Номенклатура").
2. Перейдите в раздел Формы → Форма элемента (или форма списка, если кнопка нужна там).
3. В верхней панели конструктора выберите вкладку Элементы и нажмите "Добавить команду".
4. В появившемся окне укажите:
   • 📌 Имя команды — например, ПечатьЭтикетки.
   • 📝 Заголовок — "Печать этикеток" (это текст, который увидит пользователь).
   • 🖼️ Картинка — выберите иконку из стандартной библиотеки (например, Печать).

Теперь при открытии формы справочника пользователь увидит новую кнопку. Но она пока ничего не делает — нужно написать обработчик.

Программное создание кнопки: когда без кода не обойтись

Конструктор форм ограничен в возможностях. Если требуется:

• 🔄 Динамически показывать/скрывать кнопку в зависимости от данных;
• 🛠️ Менять её свойства (цвет, доступность) во время работы;
• 📊 Добавлять кнопку в табличную часть или нестандартные элементы;

— придётся писать код на встроенном языке 1С.

Пример: добавление кнопки "Рассчитать скидку" в форму документа "Заказ клиента", если сумма документа превышает 10 000 рублей:

&Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Если Объект.СуммаДокумента > 10000 Тогда
Команды.Добавить("РассчитатьСкидку", Новый Команда("РассчитатьСкидку"));
Команды.РассчитатьСкидку.Действие = Новый Действие("РассчитатьСкидкуСервер");
Команды.РассчитатьСкидку.Заголовок = "Рассчитать скидку 5%";
Команды.РассчитатьСкидку.Видимость = Истина;
КонецЕсли;
КонецПроцедуры

&Процедура РассчитатьСкидкуСервер() Экспорт
Объект.Скидка = 5;
Объект.Записать();
КонецПроцедуры

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

Типовые ошибки при работе с кнопками и как их избежать

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

Частая проблема — кнопка видна, но не реагирует на нажатие. Это обычно связано с тем, что:

• 🔌 Не указан обработчик события (например, ПриНажатии);
• 🔒 Ошибка в коде обработчика (исключение прерывает выполнение);
• 📵 Команда не добавлена в коллекцию Команды формы.

Размещение кнопок: лучшие практики UX в 1С

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

Группировка по смыслу:

• 📑 Кнопки работы с документом ("Провести", "Отменить проведение") — в группу "Действия";
• 🖨️ Кнопки печати ("Печать", "Экспорт в Excel") — в группу "Печать";
• 🔄 Кнопки обновления данных ("Обновить", "Синхронизировать") — в группу "Сервис".

Приоритетность: Часто используемые кнопки (например, "Сохранить") должны быть на видном месте — в верхней панели или в начале группы. Редко используемые (например, "Архивировать") можно спрятать в выпадающее меню.

Пример хорошего размещения для формы документа:

┌───────────────────────┐
│ Заказ клиента №123    │
├───────┬───────────────┤
│Сохранить│Отменить│⋮   │  ← Основные действия слева
├───────┴───────────────┤
│       Табличная часть │
│                       │
├───────────────────────┤
│📄 Печать │ 📊 Отчёт   │  ← Вторичные действия внизу
└───────────────────────┘

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

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

• 🟢 Стать зелёной, если документ готов к одобрению;
• 🔴 Исчезать, если у пользователя нет прав;
• 🟡 Менять текст на "Одобрено", если документ уже обработан.

Реализуется это через обработчики событий. Пример для управляемой формы:

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

Для смены цвета кнопки используйте свойство ЦветФона (доступно в управляемых формах начиная с версии 8.3.15). Например:

Команды.Одобрить.ЦветФона = Новый Цвет(0, 200, 0); // Зелёный

Кнопки в табличных частях и списках: особенности реализации

Добавление кнопок в строки таблиц (например, "Удалить строку" или "Копировать") имеет свои нюансы. Здесь нельзя использовать стандартный конструктор — потребуется программный код.

Пример добавления кнопки "Посмотреть историю" в каждую строку табличной части документа:

&Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
ТабличнаяЧасть = ЭлементыФормы.Товары;
ТабличнаяЧасть.Колонки.Добавить("КнопкаИстории", Новый КолонкаТаблицы(" ", "КнопкаИстории", , 30));
ТабличнаяЧасть.Колонки.КнопкаИстории.ТипЗначения = Новый ОписаниеТипов("Строка");
ТабличнаяЧасть.КнопкаИстории.Заголовок = "История";
ТабличнаяЧасть.КнопкаИстории.Картинка = Новый Картинка(БиблиотекаКартинок.История);
КонецПроцедуры

&Процедура ТоварыПриАктивизацииСтроки(Элемент, Строка)
Если Элемент.ТекущаяКолонка = "КнопкаИстории" Тогда
ОткрытьФорму("Документ.ИсторияИзменений", Новый Структура("Ссылка", Строка.Ссылка));
КонецЕсли;
КонецПроцедуры

Для списков (например, в формах справочников) логика аналогична, но вместо ТабличнаяЧасть используется объект Список.

⚠️ Внимание: Кнопки в табличных частях не поддерживаются в мобильном клиенте 1С до версии 8.3.19. Для кросс-платформенных решений используйте альтернативные подходы (например, контекстное меню).

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

&Процедура ПечатьЭтикеткиПриОпределенииВидимости(Элемент, Видимость)
Видимость = Роли.НаходитсяВРоли("МенеджерСклада") Или Роли.НаходитсяВРоли("Администратор");
КонецПроцедуры

ЭлементыФормы.Добавить("МенюЭкспорта", Тип("КнопкаСМеню"));
ЭлементыФормы.МенюЭкспорта.Заголовок = "Экспорт";
ЭлементыФормы.МенюЭкспорта.Действия.Добавить("ЭкспортВExcel", Новый Действие("ЭкспортВExcel"));

Команды.Сохранить.Порядок = 1;
Команды.Провести.Порядок = 2;