Подключаем файл epf к базе 1С 8.3: разовый запуск, регистрация в программе, права и автозапуск

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

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

Что проверить в файле epf до загрузки в базу

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

• 🔍 Откуда файл. Берите обработки у разработчика, с которым у вас договор, или из проверенного каталога. Файл из чата «скачал на форуме» может менять и удалять данные .
• 🧩 Для какой конфигурации. Обработку пишут под конкретную конфигурацию и её структуру: БП 3.0, ЗУП 3.1, УТ 11. Обработка для УТ в Бухгалтерии чаще всего упадёт на первом обращении к несуществующему справочнику.
• 🖥️ Тип форм. В интерфейсе «Такси» и в тонком клиенте работают только управляемые формы. Старая обработка с обычной формой (времён 8.2) в тонком клиенте и веб-клиенте не откроется.
• 📦 Поддержка регистрации. В разделе дополнительных обработок регистрируется только файл, в модуле объекта которого есть экспортная функция СведенияОВнешнейОбработке(). Без неё файл можно открыть через Файл → Открыть, но нельзя добавить в справочник.
• 🔢 Версия платформы. Файл, сохранённый в более новой платформе, может не открыться в старой. Номер вашей платформы смотрите в меню → Справка → О программе.

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

Сравнение двух способов подключения

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

Разовое открытие файла

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

Постоянная регистрация в программе

В типовых конфигурациях на БСП (БП 3.0, ЗУП 3.1, УТ 11, КА 2, ERP) путь одинаковый.

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

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

Права пользователей на открытие и запуск epf

Права на внешние обработки работают по-разному для двух способов подключения. Путаница здесь — главная причина звонков «у меня не открывается, а у бухгалтера открывается».

Право на открытие файла через меню

Чтобы пользователь мог открывать любые .epf с диска, ему нужно право интерактивного открытия внешних обработок. В типовых конфигурациях на БСП оно выдаётся через профиль групп доступа:

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

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

Для обработки, которая уже лежит в справочнике, право открывать любые файлы не нужно. Достаточно двух вещей:

• 👥 в карточке обработки указать, кому она доступна — вкладка или ссылка с быстрым доступом и пользователями;
• 🔑 пользователь должен иметь доступ к разделу, в котором размещена команда, и к данным, с которыми работает обработка.

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

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

С платформы 8.3.9 и новее при открытии внешнего файла программа выводит предупреждение безопасности. Это поведение задаётся флажком Защита от опасных действий в карточке пользователя информационной базы (конфигуратор → Администрирование → Пользователи).

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

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

После регистрации обработку надо вывести туда, где её будут искать. Как это сделать, зависит от вида обработки.

Шаги для обработки и отчёта

1. В карточке обработки нажмите Размещение (или ссылку с перечнем разделов).
2. Отметьте флажками разделы: например, Банк и касса или Зарплата и кадры.
3. Запишите карточку.
4. Откройте выбранный раздел. В нём появится ссылка Дополнительные обработки (или Дополнительные отчеты) — по ней откроется список с вашей обработкой.

Быстрый доступ к команде

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

Печатные формы и заполнение

Для этих видов объекты назначения программа берёт из функции регистрации. Например, печатная форма для документа Реализация (акты, накладные, УПД) сама появится в меню Печать этого документа. Если не появилась — откройте документ заново: открытые формы не перечитывают список команд.

Почему не подключается внешняя обработка: ошибки и решения

Ещё три причины, которые проверяют реже

• 📁 Ограничение на сервере. В клиент-серверной базе код серверных процедур выполняется на сервере 1С. Если администратор назначил кластеру профиль безопасности, запрещающий внешние обработки, они не запустятся ни у кого. Это настраивается в консоли администрирования серверов, а не в базе.
• 🛡️ Безопасный режим. Зарегистрированная обработка в типовых конфигурациях может выполняться в безопасном режиме. Тогда ей недоступны файлы на диске, внешние компоненты и COM-объекты. Если обработка выгружает файлы и падает с ошибкой о безопасном режиме, разработчик должен указать нужные разрешения в функции регистрации — после этого программа запросит их у администратора.
• 🧹 Кэш клиента. После обновления обработки в справочнике иногда видна старая форма. Помогает перезапуск 1С; если нет — запуск с параметром /ClearCache.

Подключение epf из командной строки и программного кода

Запуск обработки при старте 1С

Платформа умеет открыть внешнюю обработку сразу при запуске сеанса. Для этого есть параметр командной строки /Execute. Пример для файловой базы:

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

Для клиент-серверной базы вместо /F укажите /S "сервер\имя_базы". Номер платформы в пути замените на свой.

Передать параметр в обработку можно ключом /C "строка". Внутри обработки строку читают через глобальную переменную ПараметрЗапуска. Так делают ночные задания: планировщик Windows запускает 1С, обработка читает параметр, выполняет загрузку и завершает работу через ЗавершитьРаботуСистемы(Ложь).

Подключение из кода конфигурации или расширения

Если обработку нужно открыть из своей кнопки, файл сначала передают на сервер через временное хранилище, а затем подключают:

&НаКлиенте
Процедура ОткрытьВнешнююОбработку(ПутьКФайлу)
	Адрес = ПоместитьВоВременноеХранилище(Новый ДвоичныеДанные(ПутьКФайлу), УникальныйИдентификатор);
	ИмяОбработки = ПодключитьНаСервере(Адрес);
	ОткрытьФорму("ВнешняяОбработка." + ИмяОбработки + ".Форма");
КонецПроцедуры

&НаСервере
Функция ПодключитьНаСервере(Адрес)
	Возврат ВнешниеОбработки.Подключить(Адрес, , Ложь);
КонецФункции

Третий параметр Ложь отключает безопасный режим. Так можно делать только с файлом, которому вы доверяете. Новый ДвоичныеДанные(ПутьКФайлу) работает в тонком клиенте, но не в веб-клиенте: там файл передают через диалог выбора и НачатьПомещениеФайла.

Массовое обновление обработок

Типового механизма «загрузить пачку epf одной командой» в БСП нет. Если обработок десятки и их обновляют часто, используют один из вариантов:

1. Обновлять файлы в карточках вручную — при пяти-десяти обработках это быстрее любого скрипта.
2. Перенести код из обработок в расширение конфигурации . Расширение обновляется одним файлом .cfe, а права на него не зависят от права открывать внешние файлы.
3. Заказать у разработчика служебную обработку, которая через /Execute обходит папку и обновляет записи справочника. Это доработка под вашу базу, а не типовая функция.

Когда лучше не подключать внешнюю обработку

Внешняя обработка удобна, но не всегда уместна. Задумайтесь о другом пути, если:

• 🔁 Нужно изменить поведение документа — проверку при проведении, новое поле, движение по регистру. Внешняя обработка этого не умеет, нужно расширение конфигурации.
• 👥 Обработку запускают все сотрудники каждый день. Расширение не теряется при переезде базы и не требует раздавать права на внешние файлы.
• 🗑️ Обработка массово удаляет или перепроводит документы. Сначала прогоните её на копии базы и сравните итоги отчётом «Оборотно-сальдовая ведомость» до и после.
• ☁️ База работает в облачном сервисе. У многих провайдеров загрузка своих обработок проходит проверку или запрещена в определённых тарифах — уточните правила у поставщика сервиса.

Частые вопросы о подключении epf