Как добавить кнопки в 1С: 5 проверенных способов с примерами

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

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

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

1. Добавление кнопки через конструктор форм (без программирования)

Самый простой способ — использовать встроенный конструктор форм. Он подходит для большинства типовых конфигураций (1С:Бухгалтерия, 1С:Зарплата и Управление Персоналом, 1С:Управление Торговлей) и не требует знания кода. Рассмотрим пошаговую инструкцию на примере добавления кнопки в форму документа "Заказ клиента".

Первым делом откройте конфигуратор в режиме 1С:Предприятие (с правами администратора). Перейдите в ветку Объекты → Документы → ЗаказКлиента, затем откройте форму документа двойным кликом. Если формы нет, её можно создать через меню Действия → Создать форму. В конструкторе выберите вкладку "Элементы" и найдите панель "Командная панель" — именно сюда мы будем добавлять новую кнопку.

• 🔧 Шаг 1. В дереве элементов формы найдите раздел КоманднаяПанель (обычно располагается вверху или внизу формы). Кликните по нему правой кнопкой и выберите "Добавить команду".
• 📝 Шаг 2. В открывшемся окне укажите "Имя команды" (например, "ПечатьСчета") и "Заголовок" (то, что будет видно пользователю, например "Печать счёта для клиента").
• 🎨 Шаг 3. Настройте внешний вид: выберите "Картинку" из стандартного набора или загрузите свою (формат .png, размер 16×16 или 32×32 пикселей).
• 🔗 Шаг 4. Перейдите на вкладку "Действие" и выберите тип действия (например, "Выполнить процедуру на сервере" или "Открыть форму"). Для простоты выберите "Выполнить процедуру" и укажите имя процедуры (её мы напишем позже).

После добавления кнопки не забудьте сохранить форму (Файл → Сохранить) и обновить конфигурацию (Конфигурация → Обновить конфигурацию базы данных). Если кнопка не появилась в пользовательском режиме, проверьте права доступа к форме и команде (раздел "Администрирование → Пользователи").

2. Настройка действия кнопки: простые макросы vs. программный код

Теперь, когда кнопка добавлена визуально, нужно определить, что она будет делать. Здесь есть два основных подхода: макросы (для простых действий) и программный код (для сложной логики). Разберём оба варианта.

Способ 1: Макросы (для типовых действий).

Макросы подходят, если кнопка должна выполнять стандартное действие, например, открыть отчёт или распечатать документ. В свойствах команды (там, где вы указывали имя) найдите поле "Макрос" и выберите одно из предопределённых значений:

• 📄 "ОткрытьФорму" — для открытия другой формы (например, формы печатного документа).
• 🖨️ "Печать" — для вызова стандартной печатной формы.
• 🔄 "Обновить" — для обновления данных в форме.

Пример макроса для печати счёта: "Печать(Документ.ЗаказКлиента.ФормаПечатнойФормыСчет)".

Способ 2: Программный код (для кастомной логики).

Если макросы не покрывают вашу задачу, напишите процедуру на встроенном языке. Для этого:

1. В свойствах команды укажите "Действие" = "Выполнить процедуру".
2. В поле "Процедура" введите имя, например "ПечатьСчетаНаСервере".
3. Перейдите в модуль формы (Форма → Модуль формы) и добавьте процедуру:

&НаСервере
Процедура ПечатьСчетаНаСервере(Команда)
// Получаем текущий документ
ДокументОбъект = ЭтотОбъект.ТекущийДокумент();

// Формируем печатную форму счёта
ПечатнаяФорма = ДокументОбъект.ПолучитьПечатнуюФорму("СчетНаОплату");

// Открываем предварительный просмотр
ПечатнаяФорма.Показать();
КонецПроцедуры

Обратите внимание на директиву &НаСервере — она обязательна для управляемых форм. Если кнопка должна работать на клиенте (например, для изменения интерфейса), используйте &НаКлиенте. Для отладки кода используйте Сообщить() или точки останова в конфигураторе.

3. Добавление кнопки программно (для опытных разработчиков)

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

Откройте модуль формы справочника и найдите процедуру "ПриСозданииНаСервере" (или создайте её, если отсутствует). Добавьте следующий код:

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

// Добавляем команду в панель инструментов
ЭтотОбъект.ЭлементыФормы.КоманднаяПанель.Команды.Добавить(НоваяКоманда);
КонецЕсли;
КонецПроцедуры

&НаСервере
Процедура ЭкспортВExcelНаСервере(Команда)
// Логика экспорта данных в Excel
ТаблицаДанных = ЭтотОбъект.ТекущиеДанные.Выгрузить();
ExcelДокумент = Новый ТабличныйДокумент;
ExcelДокумент.Вывести(ТаблицаДанных);
ExcelДокумент.Записать("C:\Temp\Номенклатура.xlsx");
КонецПроцедуры

В этом примере кнопка "Экспорт в Excel" появится только в режиме редактирования справочника. Обратите внимание на использование БиблиотекаКартинок — это стандартный механизм 1С для доступа к иконкам. Если нужной картинки нет, можно загрузить свою через ДвоичныеДанные.

Когда использовать программное добавление?

• 🔄 Когда кнопки должны появляться/исчезать динамически (например, только для администраторов).
• 📊 Когда нужно изменять свойства кнопки в runtime (цвет, доступность, текст).
• 🔗 Когда кнопка должна взаимодействовать с внешними системами (API, файловая система).

ЭтотОбъект.ЭлементыФормы.КоманднаяПанель.Команды.Удалить(ЭтотОбъект.Команды.Найти("ЭкспортВExcel"));

4. Добавление кнопок через расширения конфигурации (без изменения типового решения)

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

Алгоритм действий:

1. Откройте конфигуратор и перейдите в Конфигурация → Расширения. Создайте новое расширение (например, "ДополнительныеКнопки").
2. В дереве расширения найдите ветку "Объекты → [ВашОбъект] → Формы" (например, Документ.ЗаказКлиента.ФормаДокумента).
3. Щёлкните правой кнопкой и выберите "Добавить форму". В открывшемся окне укажите, что вы хотите "Расширить форму" (не заменять!).
4. В конструкторе формы добавьте кнопку так же, как в первом разделе статьи. Все изменения будут применены поверх типовой формы.

Преимущества расширений:

• 🔄 Безопасность обновлений. При обновлении типовой конфигурации ваши изменения не затрутся.
• 📦 Модульность. Расширения можно отключать/включать без перезапуска 1С.
• 🔧 Гибкость. Можно добавлять не только кнопки, но и новые реквизиты, отчёты, обработки.

Пример кода для расширения (добавление кнопки "Отправить на почту" в форму документа "Счёт на оплату"):

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

// Формируем письмо
ПочтовоеСообщение = Новый ПочтовоеСообщение;
ПочтовоеСообщение.Адресат = АдресПочты;
ПочтовоеСообщение.Тема = "Счёт №" + ДокументОбъект.Номер + " от " + Формат(ДокументОбъект.Дата, "ДФ=dd.MM.yyyy");

// Прикрепляем печатную форму счёта
ПечатнаяФорма = ДокументОбъект.ПолучитьПечатнуюФорму("СчетНаОплату");
Вложение = Новый ПочтовоеВложение("Счёт.pdf", ПечатнаяФорма.ПолучитьДвоичныеДанные(), "application/pdf");
ПочтовоеСообщение.Вложения.Добавить(Вложение);

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

5. Динамическое управление кнопками: права доступа и условия отображения

Часто требуется показывать кнопки только определённым пользователям или при выполнении условий. Например, кнопка "Утвердить" должна быть видна только руководителям, а кнопка "Экспорт" — только когда документ проведён. Разберём, как это реализовать.

Способ 1: Управление видимостью через права.

В 1С права на команды настраиваются через роли. Откройте конфигуратор, перейдите в Администрирование → Роли и выберите нужную роль (например, "Руководитель"). В списке прав найдите ветку "Команды" и отметьте галочкой вашу команду (например, "Документ.ЗаказКлиента.Утвердить"). Теперь кнопка будет видна только пользователям с этой ролью.

Способ 2: Программное управление доступностью.

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

&НаСервере
Процедура ПриОткрытии(Отказ)
// Получаем текущий документ
ДокументОбъект = ЭтотОбъект.ТекущийДокумент();

// Находим команду в коллекции
КомандаОтменить = ЭтотОбъект.Команды.Найти("ОтменитьПроведение");

// Делаем кнопку доступной только для проведённых документов
КомандаОтменить.Доступность = ДокументОбъект.Проведен;
КонецПроцедуры

Способ 3: Изменение внешнего вида в зависимости от статуса.

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

&НаКлиенте
Процедура ОбновитьИнтерфейс()
Если ЭтотОбъект.ТекущийДокумент().Оплачен Тогда
ЭтотОбъект.ЭлементыФормы.КоманднаяПанель.Команды.Оплатить.ЦветФона = ВебЦвет.Зеленый;
ЭтотОбъект.ЭлементыФормы.КоманднаяПанель.Команды.Оплатить.Заголовок = "Оплачено ✓";
Иначе
ЭтотОбъект.ЭлементыФормы.КоманднаяПанель.Команды.Оплатить.ЦветФона = ВебЦвет.Серый;
ЭтотОбъект.ЭлементыФормы.КоманднаяПанель.Команды.Оплатить.Заголовок = "Оплатить";
КонецЕсли;
КонецПроцедуры

Для динамического обновления интерфейса вызывайте процедуру ОбновитьИнтерфейс() в событиях ПриИзменении или ПриАктивизацииСтроки.

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

6. Распространённые ошибки и их решение

При добавлении кнопок в 1С разработчики часто сталкиваются с типичными проблемами. Мы собрали самые частые ошибки и способы их исправления.

Дополнительные нюансы:

• 🔄 Кэширование форм. Если изменения не применяются, очистите кэш 1С (Сервис → Очистить кэш).
• 📋 Конфликты расширений. Если кнопка пропала после обновления, проверьте приоритет расширений в Конфигурация → Расширения.
• 🔧 Отладочный режим. Включите отладку (Сервис → Параметры → Отладка), чтобы увидеть ошибки выполнения.

7. Оптимизация интерфейса: групповые кнопки и меню

Если в форме слишком много кнопок, интерфейс становится перегруженным. Решение — использовать групповые кнопки (выпадающие меню) или вкладки. Разберём, как это сделать.

Способ 1: Создание выпадающего меню.

В конструкторе формы добавьте элемент "Кнопка с меню" (в палитре элементов). Затем в свойствах кнопки укажите "Тип" = "Кнопка с меню" и добавьте подкоманды:

• 📌 Основная команда — действие по умолчанию (например, "Печать").
• 📄 Подкоманды — дополнительные действия (например, "Печать с подписью", "Экспорт в PDF").

Пример кода для динамического заполнения меню:

&НаСервере
Процедура ЗаполнитьМенюПечати(Элемент)
Меню = Элемент.Меню;
Меню.Очистить();

// Добавляем основную команду
Команда1 = Меню.Добавить("Печать", "ПечатьДокумента");
Команда1.Картинка = БиблиотекаКартинок.Печать;

// Добавляем подменю "Экспорт"
ПодменюЭкспорт = Меню.Добавить("Экспорт", ТипМеню.Подменю);
ПодменюЭкспорт.Добавить("В Excel", "ЭкспортВExcel");
ПодменюЭкспорт.Добавить("В PDF", "ЭкспортВPDF");
КонецПроцедуры

Способ 2: Разделение кнопок по вкладкам.

Если кнопок много, разбейте их по тематическим вкладкам. Для этого:

1. Добавьте на форму элемент "Группа" с типом "Страницы".
2. На каждой странице разместите свою командную панель с релевантными кнопками.
3. Настройте видимость страниц в зависимости от ролей или статуса документа.

Способ 3: Использование панелей инструментов.

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

• 🔧 Основные действия — панель вверху (сохранение, проведение).
• 📊 Отчёты и аналитика — панель справа.
• 📤 Экспорт/импорт — панель внизу.

FAQ: Ответы на частые вопросы

&НаСервере
Процедура ЭкспортОтчетаВExcel(Команда)
Отчет = ЭтотОбъект.ТекущийОтчет;
ТаблицаДанных = Отчет.Результат.Выгрузить();
ExcelДокумент = Новый ТабличныйДокумент;
ExcelДокумент.Вывести(ТаблицаДанных);
ExcelДокумент.Записать("C:\Temp\Отчет.xlsx");
КонецПроцедуры

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

&НаКлиенте
Процедура Экспорт(Элемент)
ТабличныйДокумент = ЭтотОбъект.ТекущийТабличныйДокумент;
ТабличныйДокумент.Записать("C:\Temp\Счет.xlsx", ТипФайлаТабличногоДокумента.Excel);
КонецПроцедуры