Как добавить кнопку в форму документа или списка с помощью внешней обработки?

Часто в процессе автоматизации в 1С:Комплексная автоматизация возникает необходимость добавить свою функциональную кнопку прямо в форму документа или форму списка. Разберем, как сделать это правильно, используя механизмы Библиотеки стандартных подсистем (БСП), не прибегая к прямому изменению конфигурации.

Понимание механизма регистрации

Для того чтобы система 1С «увидела» вашу обработку и добавила кнопку в интерфейс, необходимо реализовать в модуле объекта внешней обработки функцию СведенияОВнешнейОбработке. Именно эта функция сообщает БСП, как именно должна выглядеть команда, как она называется и где должна располагаться.

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

Реализация функции СведенияОВнешнейОбработке

Рассмотрим пример реализации функции, которая позволяет зарегистрировать дополнительную команду:

Функция СведенияОВнешнейОбработке Экспорт
    ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке("2.2.2.1");
    ПараметрыРегистрации.Вид = ДополнительныеОтчетыИОбработкиКлиентСервер.ВидОбработкиДополнительнаяОбработка;
    ПараметрыРегистрации.Наименование = "Моя функциональная обработка";
    ПараметрыРегистрации.БезопасныйРежим = Истина;
    
    НоваяКоманда = ПараметрыРегистрации.Команды.Добавить();
    НоваяКоманда.Представление = "Выполнить действие";
    НоваяКоманда.Идентификатор = "Действие1";
    НоваяКоманда.Использование = ДополнительныеОтчетыИОбработкиКлиентСервер.ТипКомандыОткрытиеФормы;
    
    Возврат ПараметрыРегистрации;
КонецФункции

Разберем основные параметры команды:

• Представление — это то, что увидит пользователь на кнопке или в меню.
• Идентификатор — уникальное имя команды, которое вы будете использовать для обработки события нажатия.
• Использование — определяет тип вызова: ОткрытиеФормы (откроет форму обработки), ВызовСерверногоМетода (код отработает на сервере) или ЗаполнениеФормы (для кнопок в меню «Заполнить»).

Регистрация и размещение в интерфейсе

После того как вы написали код и сохранили файл внешней обработки (.epf), выполним следующие шаги:

1. Откройте 1С в режиме «Предприятие».
2. Перейдите в раздел НСИ и администрирование (или Администрирование) — Печатные формы, отчеты и обработки.
3. Откройте справочник Дополнительные отчеты и обработки.
4. Создайте новый элемент и выберите файл вашей внешней обработки.
5. После записи элемента нажмите кнопку Разместить в разделах.
6. В открывшемся окне установите флажки напротив тех разделов или конкретных объектов (например, Заявка на расходование ДС), где вы хотите видеть свою кнопку.

После этих действий БСП автоматически добавит вашу команду в меню Дополнительно (или Заполнить, в зависимости от выбранного вида команды) в соответствующих формах.

Важные нюансы работы

Важно понимать разницу между видами обработок:

• Если вы выберете вид ЗаполнениеОбъекта, ваша команда автоматически попадет в меню Заполнить внутри документа. Это удобно, если вам нужно считать данные из текущего документа, обработать их и вернуть результат обратно.
• Если вам нужно просто открыть форму для ввода данных, используйте вид ДополнительнаяОбработка.
• Если ваша задача требует размещения кнопки непосредственно на командной панели (а не в выпадающем меню), помните, что стандартные средства БСП для внешних обработок этого не делают. В таком случае необходимо использовать Расширение конфигурации.

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