Как добавить внешнюю обработку в интерфейс 1С

Внешняя обработка в 1С — это файл с расширением .epf, который выполняет прикладную задачу без изменения конфигурации: печатная форма, загрузка данных, групповое изменение реквизитов, сервисная операция. Чтобы пользователи могли запускать её не из меню «Файл → Открыть», а прямо из привычного интерфейса, обработку подключают через механизм «Дополнительные отчеты и обработки» (библиотека стандартных подсистем, БСП).

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

Ниже разобран полный цикл: проверка условий, регистрация обработки, вывод в нужный раздел интерфейса, настройка прав, проверка результата и типичные ошибки. Инструкция актуальна для типовых конфигураций на управляемых формах: «1С:Бухгалтерия», «1С:Управление торговлей», «1С:ERP», «1С:Зарплата и управление персоналом» и других решений, где встроена подсистема дополнительных отчетов и обработок.

Проверяем условия перед подключением

Прежде чем загружать файл, убедитесь, что в конфигурации включена подсистема дополнительных отчетов и обработок. Откройте «Администрирование → Печатные формы, отчеты и обработки» и проверьте, установлен ли флаг «Дополнительные отчеты и обработки». Если флага нет — подсистема в конфигурацию не встроена, и стандартный способ не сработает.

Второе условие — права. Загружать и публиковать обработки может пользователь с ролью «Добавление и изменение дополнительных отчетов и обработок» (обычно она есть у администратора). Обычный пользователь может только запускать уже опубликованные обработки, если администратор разрешил ему доступ.

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

Включаем механизм дополнительных отчетов и обработок

Если подсистема есть в конфигурации, но отключена, включите её под правами администратора. Перейдите в раздел «Администрирование», откройте «Печатные формы, отчеты и обработки» и установите флаг «Дополнительные отчеты и обработки». После этого в том же окне появится гиперссылка «Дополнительные отчеты и обработки» — это справочник, в котором регистрируются все подключаемые файлы.

В некоторых конфигурациях путь отличается: например, в «1С:Управление торговлей» настройка может находиться в разделе «НСИ и администрирование». Ориентируйтесь на поиск по слову «обработки» в панели функций или воспользуйтесь строкой поиска по меню (Ctrl+F в панели навигации или поле поиска в правом верхнем углу).

Регистрируем обработку в справочнике

Откройте справочник «Дополнительные отчеты и обработки» и нажмите «Создать». Форма предложит выбрать файл — укажите ваш .epf-файл. Программа загрузит его в базу и попытается прочитать сведения из функции СведенияОВнешнейОбработке(): наименование, вид обработки, версию, список команд.

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

На вкладке «Команды» отображаются команды, которые обработка объявила в своих сведениях. Для каждой команды виден способ вызова: открытие формы, вызов клиентского или серверного метода. Если вкладка пустая — обработка не объявила команд, и запускать её из интерфейса будет нечего.

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

Выводим обработку в нужный раздел интерфейса

За видимость обработки в интерфейсе отвечает вкладка «Разделы» в карточке элемента справочника. Отметьте разделы, в которых обработка должна появляться: например, «Продажи», «Склад», «Банк и касса». Список разделов соответствует панели разделов вашей конфигурации.

После записи откройте выбранный раздел. В его панели навигации появится пункт «Дополнительные обработки» (обычно внутри группы «Сервис»). Внутри этого пункта пользователь увидит команды всех опубликованных обработок, размещённых в данном разделе. Запуск выполняется одним щелчком — файл из базы открывается автоматически.

Если обработка имеет вид «Заполнение объекта» или «Печатная форма», разделы не настраиваются. Вместо этого указывается «Назначение» — список типов документов и справочников, для которых обработка доступна. Команда появится в форме объекта: в подменю «Заполнить» или в списке печатных форм соответственно.

Настраиваем права доступа

По умолчанию после регистрации обработка может быть доступна всем пользователям или только администратору — поведение зависит от настроек конфигурации. Явно управлять доступом можно на вкладке «Быстрый доступ» в карточке обработки: там перечисляются пользователи или группы, которым разрешён запуск команд.

Если вкладка «Быстрый доступ» пуста, доступ определяется общими ролями. Роль «Использование дополнительных отчетов и обработок» даёт право запускать опубликованные обработки, роль «Добавление и изменение…» — загружать новые. Раздавайте вторую роль только администраторам: пользователь с этой ролью может загрузить любой файл, включая вредоносный.

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

Проверяем результат и обновляем обработку

После публикации проверьте результат под учётной записью обычного пользователя, а не администратора. Откройте целевой раздел, найдите «Дополнительные обработки», запустите команду и убедитесь, что форма обработки открывается и выполняет свою функцию. Так администратор увидит именно ту картину, которая будет у пользователей.

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

Контрольные точки

Как проверить результат

Наличие команды в разделе

Норма

Пункт «Дополнительные обработки» виден, внутри — нужная команда

Тревожный признак

Пункт отсутствует: проверьте разделы размещения и права пользователя

Запуск обработки

Норма

Форма открывается без ошибок, операция выполняется

Тревожный признак

Ошибка при открытии: смотрите журнал регистрации и версию файла

Доступность для других

Норма

Под обычным пользователем команда видна и работает

Тревожный признак

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

Альтернативные способы запуска

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

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

Способы подключения обработки

Через БСП (Дополнительные отчеты и обработки)

Штатный способ: размещение в разделах, права, расписание. Требует встроенной подсистемы БСП и функции СведенияОВнешнейОбработке в файле

Файл → Открыть

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

Встраивание в конфигурацию

Обработка становится частью конфигурации через конфигуратор. Надёжно, но требует снятия с поддержки и усложняет обновления

Часто задаваемые вопросы

Обработка загружена, но в разделе её не видно. Что проверить?

Три вещи: выбраны ли разделы на вкладке «Разделы» в карточке обработки; опубликована ли она (в списке справочника у опубликованных элементов нет признака пометки на удаление); есть ли у вашего пользователя право на использование дополнительных обработок. Чаще всего причина — пустой список разделов.

При загрузке файла появляется ошибка регистрации. В чём причина?

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

Можно ли вывести обработку кнопкой прямо в форму документа?

Да, если у обработки вид «Заполнение объекта», «Печатная форма» или «Создание связанных объектов». Тогда вместо разделов настраивается назначение — типы документов, и команда появляется в форме объекта: в подменю «Заполнить», «Печать» или «Создать на основании».

Как обновить обработку, не потеряв настройки?

Откройте существующую карточку в справочнике «Дополнительные отчеты и обработки» и загрузите новый файл в неё же. Разделы размещения, быстрый доступ и расписание сохранятся. Создавать новый элемент справочника для новой версии не нужно.

Безопасно ли давать обработки обычным пользователям?

Безопасность зависит от кода конкретной обработки. Перед публикацией протестируйте файл на копии базы, а для операций, изменяющих данные, ограничьте доступ через вкладку «Быстрый доступ». Не загружайте файлы из источников, которым не доверяете: обработка выполняется с правами запустившего её пользователя.

Что делать, если в конфигурации нет пункта «Дополнительные отчеты и обработки»?

Значит, подсистема БСП не встроена или отключена. Сначала проверьте флаг в «Администрирование → Печатные формы, отчеты и обработки». Если настройки нет вообще, варианты такие: встроить подсистему через конфигуратор, встроить саму обработку в конфигурацию или запускать файл вручную через «Файл → Открыть».