Подключаем файл .epf или .erf к рабочей базе: регистрация, права, автозапуск и ошибки

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

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

Инструкция общая для конфигураций на Библиотеке стандартных подсистем: Бухгалтерия 3.0, ЗУП 3.1, Управление торговлей 11, Комплексная автоматизация 2, ERP. Платформа — 8.3 с интерфейсом «Такси».

Что проверить в файле внешней обработки до подключения

📁 Расширение файла. .epf — внешняя обработка (в том числе печатная форма и заполнение табличной части), .erf — внешний отчёт. Архив .zip сначала распакуйте: 1С не читает обработку из архива.

🧩 Для какой конфигурации написан файл. Печатная форма к «Реализации товаров и услуг» из Бухгалтерии не заработает в УТ 11: у объектов разные реквизиты. Спросите у автора, под какую конфигурацию и какой релиз делалась обработка.

🖥️ Тип форм. В интерфейсе «Такси» тонкий клиент работает с управляемыми формами. Старая обработка с одной только обычной формой в нём не откроется или откроется пустой.

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

🛡️ Источник. Внешняя обработка — это программный код, который выполняется с правами того, кто её запустил. Код может изменить или удалить данные. Берите файлы только у своего программиста или известного поставщика.

Как проверить наличие СведенияОВнешнейОбработке(), если автор не сказал? Откройте файл в Конфигураторе через Файл → Открыть, затем модуль объекта обработки и найдите функцию поиском по тексту. Выглядит её заголовок так:

Функция СведенияОВнешнейОбработке() Экспорт
	ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке();
	// дальше автор заполняет вид, версию, команды и назначение
	Возврат ПараметрыРегистрации;
КонецФункции

Как добавить внешнюю обработку через «Дополнительные отчеты и обработки»

Это основной способ. Файл сохраняется внутри информационной базы, поэтому исходный .epf после загрузки можно хоть удалить: обработка останется у всех пользователей.

Шаг 1. Включите функциональность

Путь зависит от конфигурации:

Поставьте флажок «Дополнительные отчеты и обработки». Рядом станет активной ссылка с тем же названием.

Шаг 2. Загрузите файл

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

После этого откроется карточка обработки. Наименование, версию, вид и список команд программа заполнит сама из СведенияОВнешнейОбработке().

Шаг 3. Проверьте вид и публикацию

Вид задаёт автор, менять его не нужно. От вида зависит, где обработка появится:

Поле «Публикация» оставьте в значении «Используется». Значение «Режим отладки» нужно для проверки: обработку видят только администраторы. «Отключена» — обработка хранится в базе, но нигде не показывается.

Шаг 4. Задайте размещение

• Для глобальных обработок и отчётов нажмите на ссылку в поле «Размещение» и отметьте разделы, где должна быть команда. Например, «Банк и касса» или «Склад».
• Для печатных форм и прочих привязанных видов в размещении указаны документы и справочники, к которым обработка подключается. Список заполняет автор; лишние объекты можно убрать.

Нажмите Записать и закрыть. Обработка подключена.

Шаг 5. Найдите и запустите

Глобальная обработка появится в разделе, указанном в размещении, по команде «Дополнительные обработки» (для отчётов — «Дополнительные отчеты»). В открывшемся списке выберите строку и нажмите Выполнить.

Печатную форму ищите в самом документе: откройте его и раскройте кнопку Печать. Новая форма будет в общем списке.

Разовый запуск через меню «Файл»

Когда обработку нужно выполнить один раз (например, исправить данные по письму программиста), регистрировать её необязательно.

1. Откройте главное меню программы (кнопка с тремя полосками в левом верхнем углу).
2. Выберите Файл → Открыть или нажмите Ctrl+O.
3. Укажите файл .epf или .erf.
4. Подтвердите предупреждение безопасности, если платформа его покажет.

Различия двух способов:

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

Права доступа: кто может добавить и кто увидит обработку

Здесь две разные задачи, и права для них разные.

Кто может добавлять обработки

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

Права на добавление обработок фактически равны правам на выполнение любого кода в базе. Не выдавайте их без необходимости.

Кто может открыть файл через «Файл → Открыть»

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

Кто увидит зарегистрированную обработку

• В типовых профилях БП и ЗУП право на использование дополнительных обработок уже есть. Если у пользователя пусто — проверьте его профиль групп доступа.
• Команды быстрого доступа видят только пользователи, перечисленные в колонке «Быстрый доступ».
• При публикации «Режим отладки» обработка скрыта от всех, кроме администраторов.

Защита от опасных действий

Начиная с платформы 8.3.9 при открытии внешнего файла платформа может показывать предупреждение о потенциально опасных действиях. Флажок «Защита от опасных действий» задаётся в свойствах пользователя: в Конфигураторе это Администрирование → Пользователи, карточка пользователя. Снимайте его только тем, кто сам отвечает за проверку файлов.

Файловая и клиент-серверная база: что меняется

Порядок действий в интерфейсе одинаковый. Разница в том, где выполняется код и что ему позволено.

Файловая база. Клиент и «сервер» работают на одном компьютере. Обработка из справочника, как и открытая через Файл → Открыть, выполняется с правами учётной записи Windows, под которой запущена 1С. Профилей безопасности нет.

Клиент-серверная база . Серверный код обработки выполняется на сервере 1С от имени пользователя службы (обычно USR1CV8). Отсюда практические следствия:

• 📂 Пути к файлам, которые обработка читает или пишет на сервере, должны быть доступны серверу. C:\Загрузка\ на компьютере бухгалтера сервер не увидит, нужен сетевой ресурс с правами для пользователя службы.
• 🛡️ Если в кластере включены профили безопасности, зарегистрированная обработка работает в безопасном режиме. Для доступа к файлам, интернету или COM-объектам ей нужны разрешения. Автор указывает их в СведенияОВнешнейОбработке(), а при загрузке программа предлагает администратору их подтвердить.
• 🔁 При Файл → Открыть платформа сама передаёт файл с клиента на сервер. Регистрировать обработку для этого не требуется.

Веб-клиент. Через Файл → Открыть файл загружается через браузер. Обработки, которые используют COM-объекты или работу с локальными файлами без диалогов, в веб-клиенте не заработают — это ограничение веб-клиента, а не настройки.

Автоматический запуск обработки: /Execute и регламентное задание

Штатной папки, куда достаточно положить файл и 1С откроет его сама, в платформе 8.3 нет. Если в инструкциях встречается «автооткрытие», на практике имеется в виду один из двух способов.

Запуск при входе через параметр командной строки

Параметр /Execute открывает внешнюю обработку сразу после запуска сеанса. Удобно для служебных ярлыков: выгрузка, загрузка, проверка остатков по утрам.

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" ENTERPRISE /F"D:\Bases\Buh" /N"Администратор" /P"пароль" /Execute "D:\Obrabotki\Vygruzka.epf"

• /F — каталог файловой базы. Для серверной вместо него /S"сервер\имя_базы".
• /N и /P — пользователь и пароль. Пароль в ярлыке хранится открытым текстом, лучше использовать аутентификацию Windows (/WA+) там, где она настроена.
• Номер версии в пути подставьте свой.
• Строку с параметрами для обработки можно передать через /C"текст", обработка прочитает её из ПараметрЗапуска.

Запуск по расписанию из справочника

Для зарегистрированной глобальной обработки автор может предусмотреть команду, которая вызывает серверный метод. У такой команды на вкладке «Команды» карточки можно задать расписание. Программа создаст регламентное задание и будет выполнять обработку без участия пользователя.

Для серверной базы регламентные задания выполняет сервер 1С. В файловой базе они идут, только пока открыт хотя бы один сеанс, либо при настроенном запуске через веб-сервер. Если расписание задано, а ничего не происходит — проверьте именно это.

Как обновить или отключить подключённую обработку

Новая версия файла от программиста — частая ситуация. Не добавляйте её второй строкой: появятся две одинаковые команды, а настройки размещения и быстрого доступа останутся у старой.

1. Откройте список «Дополнительные отчеты и обработки».
2. Откройте карточку нужной обработки.
3. Найдите команду загрузки из файла (в карточке она называется Загрузить из файла...) и выберите новый .epf.
4. Проверьте номер версии в карточке и нажмите Записать и закрыть.

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

Временно убрать обработку — поставьте «Публикация: Отключена». Удалять строку лучше только когда обработка точно больше не нужна: вместе с ней пропадут её настройки и расписание.

Ошибки при добавлении внешней обработки и что с ними делать

Если не помогло

Вызовите обработку под администратором с полными правами. Если под ним она работает, а под пользователем нет — дело в правах, а не в файле: сравните профили групп доступа.

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

Частые вопросы