Как добавить кнопку вызова внешней обработки на панель в обычных формах 1С?

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

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

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

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

Шаг 1. Создание процедуры открытия в общем модуле

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

Процедура ОткрытьВнешнююОбработку() Экспорт
    ПутьКФайлу = "C:\PathToProcessing\Обработка.epf";
    ВнешниеОбработки.Открыть(ПутьКФайлу);
КонецПроцедуры

Шаг 2. Добавление кнопки в пользовательский интерфейс

1. В Конфигураторе откроем ветку Общие -> Интерфейсы и выберем нужный интерфейс (например, главный интерфейс системы).
2. В редакторе интерфейса перейдем на нужную панель инструментов и добавим новую кнопку.
3. В свойствах кнопки настроим заголовок, представление и установим иконку (свойство Картинка).
4. В свойстве Действие выберем созданную процедуру из общего модуля (например, МойОбщийМодуль.ОткрытьВнешнююОбработку).

Шаг 3. Проверка прав доступа

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

Альтернативные варианты без изменения конфигурации

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

1. Использование встроенного справочника дополнительных обработок

В большинстве типовых конфигураций на обычных формах (например, УПП 1.3, УТ 10.3, БП 2.0) предусмотрен штатный механизм для подключения внешних обработок:

1. Перейдем в меню Сервис -> Дополнительные отчеты и обработки -> Дополнительные внешние обработки.
2. Создадим новый элемент и укажем файл внешней обработки .epf.
3. Настроим список пользователей, которым доступен данный инструмент. Запуск обработки будет производиться из этого меню без правки структуры интерфейсов.

2. Запуск обработки через параметры командной строки

Если обработку необходимо открывать сразу при запуске программы, настроим специальный ярлык с параметром ключа запуска /Execute:

1cv8.exe enterprise /F "C:\Bases\MyBase" /Execute "C:\PathToProcessing\Обработка.epf"

Ограничения платформы в обычных формах

Посмотрим на важные особенности и ограничения платформы в режиме обычных форм:

1. Отсутствие программного управления главной панелью: Динамически добавить кнопку с иконкой непосредственно на главную панель инструментов во время работы программы в обычных формах нельзя — структура панелей формируется строго из метаданных интерфейсов.
2. Пользовательская настройка: Пользователь не может штатными средствами перетащить произвольный файл .epf на главную панель.
3. Невозможность применения расширений: Механизм расширений конфигурации доступен только в режим управляемого приложения и не поддерживается в обычных формах.