Внешняя обработка .epf в 1С 8.3: разовый запуск, регистрация в базе и права
Содержание
Подгрузить внешнюю обработку
в 1С 8.3 можно двумя способами. Для разового запуска откройте файл .epf через главное меню: ≡ → Файл → Открыть (или Ctrl+O). Чтобы обработка постоянно жила в базе и была у всех пользователей, добавьте её через Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки → Добавить из файла.
Порядок действий общий для платформы 8.3 и типовых конфигураций на БСП: Бухгалтерии 3.0, ЗУП 3.1, УТ 11, КА и ERP. Различается только раздел верхнего уровня, где лежат настройки. Внешние отчёты (.erf) загружаются так же, как обработки.
Что проверить до загрузки файла .epf
Внешняя обработка — это программный код, который выполняется с правами пользователя. Она может менять документы, удалять данные и отправлять их наружу. Поэтому сначала проверка, потом загрузка.
- 📄 Расширение файла. Обработка —
.epf, отчёт —.erf. Если пришёл архив.zip, распакуйте его. Расширение.cfe— это расширение конфигурации , оно подключается иначе. - 🔐 Источник. Берите обработки у разработчика, с которым есть договор, или из проверенного каталога. Файл «с форума» без исходного кода лучше сначала открыть в тестовой копии базы.
- 🧩 Под какую конфигурацию написана. Обработка, сделанная под УТ 11, в Бухгалтерии 3.0 часто падает: в ней другие справочники и реквизиты. Разработчик обычно указывает конфигурацию и минимальную редакцию.
- ⚙️ Версия платформы. Файл, сохранённый в более новой платформе, может не открыться в старой. Номер вашей платформы виден в
≡ → Справка → О программе. - 🗂 Тип обработки. От него зависит способ подключения: обычная внешняя обработка открывается сразу, а печатная форма или обработка заполнения работают только после регистрации в справочнике.
Если обработка что-то массово меняет (перепроводит документы, чистит регистры, загружает данные), запускайте её первый раз на копии базы. Перед запуском в рабочей базе сделайте резервную копию.
Способ 1. Разовый запуск через меню «Файл — Открыть»
Подходит, когда обработку нужно запустить один-два раза: свернуть остатки, выгрузить данные, исправить реквизиты у группы документов.
- Запустите 1С в режиме
1С:Предприятиепод пользователем с правами администратора. - Откройте главное меню (кнопка
≡в левом верхнем углу) и выберитеФайл → Открыть. Быстрее — клавишамиCtrl+O. - Укажите файл
.epfна диске. - Появится предупреждение безопасности: файл может содержать код, опасный для базы. Если источник проверен, подтвердите открытие.
- Откроется форма обработки. Дальше работайте по инструкции её разработчика.
Предупреждение показывает механизм «Защита от опасных действий». Он включён у пользователя по умолчанию. Отключать его ради удобства не стоит: это последний барьер против случайного запуска чужого кода.
У способа есть ограничения:
- 🔁 После закрытия формы обработка «исчезает»: в следующий раз файл придётся выбирать снова.
- 🖨 Печатная форма, открытая так, не появится в меню
Печатьдокумента. Её нужно регистрировать (способ 2). - 👤 Пользователь без права открывать внешние обработки получит отказ (подробно — в разделе о правах).
Способ 2. Как подгрузить обработку в справочник дополнительных обработок
Это основной способ для типовых конфигураций. Обработка сохраняется прямо в базе, её видят все нужные пользователи, а печатные формы встают в меню документа.
Включите использование дополнительных обработок
В новой базе эта возможность может быть выключена. Откройте раздел администрирования и включите флажок Дополнительные отчеты и обработки. После этого рядом появится одноимённая ссылка.
| Конфигурация | Где включить и открыть список |
|---|---|
| Бухгалтерия 3.0 | Администрирование → Печатные формы, отчеты и обработки |
| ЗУП 3.1 | Администрирование → Печатные формы, отчеты и обработки |
| УТ 11, КА 2, ERP | НСИ и администрирование → Печатные формы, отчеты и обработки |
Добавьте файл
- Перейдите по ссылке
Дополнительные отчеты и обработки. - Нажмите
Добавить из файла.... - Подтвердите предупреждение безопасности и выберите файл
.epfили.erf. - Откроется карточка. Программа сама прочитает из файла наименование, вид, версию и список команд.
Если вместо карточки появилась ошибка о том, что обработка не поддерживает такое подключение, файл написан как обычная внешняя обработка. Его можно запускать только способом 1.
Настройте размещение и доступ
Что заполнить в карточке, зависит от вида обработки:
| Вид в карточке | Где появится после загрузки | Что настроить |
|---|---|---|
| Дополнительная обработка | В выбранных разделах, в группе дополнительных обработок | Размещение — разделы программы |
| Дополнительный отчёт | В выбранных разделах, среди дополнительных отчётов | Размещение — разделы программы |
| Печатная форма | В меню Печать документа или справочника | Объекты, к которым она привязана (обычно задаёт сам файл) |
| Заполнение объекта | В командах заполнения формы документа | Привязку к объектам |
| Создание связанных объектов | В команде «Создать на основании» | Привязку к объектам |
Дальше на вкладке команд укажите, кому команда доступна. Ссылка в колонке быстрого доступа открывает список пользователей: отметьте тех, кому обработка нужна под рукой.
Поле Публикация должно стоять в значении Используется. Значение Отключена прячет обработку, не удаляя её. Режим отладки делает её видимой только администраторам — удобно для проверки новой версии.
Нажмите Записать и закрыть. Обработка доступна сразу, перезапуск программы не нужен.
Где найти загруженную обработку
- 📂 Обработки и отчёты — в том разделе, который выбран в размещении. Ищите группу дополнительных обработок или отчётов в панели раздела.
- 🖨 Печатные формы — откройте документ нужного вида, нажмите
Печать: новая форма будет в списке. - 🧾 Заполнение — в форме документа, рядом с типовыми командами заполнения.
Обработка в Конфигураторе: открыть, исправить, встроить
Конфигуратор нужен не для обычной загрузки, а для работы с кодом обработки. Пользователю он не нужен.
Открыть и отредактировать
- Запустите базу в режиме
Конфигуратор. - Выберите
Файл → Открытьи укажите файл.epf. - Обработка откроется отдельным деревом: реквизиты, табличные части, формы, макеты, модуль объекта.
- После правок сохраните файл:
Файл → Сохранить.
Так же удобно смотреть, что делает чужая обработка, до запуска в рабочей базе. Откройте модуль объекта и модули форм: если там есть удаление объектов, запись в регистры или обращения к внешним адресам, вы увидите это заранее.
Отладка
Внешнюю обработку можно отлаживать, не встраивая её в конфигурацию. Запустите из Конфигуратора 1С:Предприятие в режиме отладки, откройте в нём файл через Файл → Открыть, а в Конфигураторе поставьте точки останова в том же открытом файле. Выполнение остановится на них.
Встроить в конфигурацию
Если обработку надо сделать частью базы без справочника дополнительных обработок, её можно вставить в дерево конфигурации. Щёлкните правой кнопкой по ветке Обработки и выберите вставку внешней обработки или отчёта.
Встраивание меняет основную конфигурацию. Для типовой конфигурации на поддержке это осложнит каждое следующее обновление. Если доработка постоянная, правильнее перенести обработку в расширение конфигурации (.cfe) или зарегистрировать её через справочник дополнительных обработок.
Права пользователей на загрузку внешних обработок
Самая частая жалоба: администратор всё загрузил, а бухгалтер пишет «нет прав». Права разделены на две части.
| Действие | Что нужно пользователю |
|---|---|
Открыть .epf через Файл → Открыть | Право интерактивного открытия внешних обработок и отчётов |
| Добавить или заменить файл в справочнике | Право на добавление и изменение дополнительных отчётов и обработок |
| Запускать уже зарегистрированную обработку | Отметка в быстром доступе или доступ к разделу, где она размещена |
В БСП-конфигурациях права выдают через профили групп доступа: Администрирование → Настройки пользователей и прав → Группы доступа. Найдите в профиле роли, в названии которых есть «внешних отчетов и обработок» и «дополнительных отчетов и обработок», и включите нужные. Изменять поставляемый профиль нельзя — скопируйте его и правьте копию.
Рядовым пользователям обычно хватает доступа к уже зарегистрированным обработкам. Право открывать любой .epf с диска лучше оставить администраторам: так случайный файл из почты не запустится в рабочей базе.
Отдельно проверьте флажок Защита от опасных действий в карточке пользователя. Если администратор снял его ради скорости, предупреждения при открытии файлов перестают появляться.
Обновление и автоматический запуск внешних обработок
Заменить версию без перенастройки
Когда разработчик прислал новую версию файла, не удаляйте старую карточку. Откройте её в списке дополнительных обработок и загрузите новый файл через команду загрузки из файла в форме карточки. Размещение, пользователи и расписание останутся прежними, обновятся только код и номер версии.
Перед заменой выгрузите текущую версию в файл командой выгрузки в той же карточке. Если новая сломается, вернёте старую за минуту.
Запуск по расписанию
Для дополнительной обработки с серверными командами в таблице команд карточки есть колонка расписания. Задайте периодичность — и команда будет выполняться регламентным заданием без участия человека: например, каждую ночь загружать курсы или сверять остатки.
- 🖥 В клиент-серверной базе регламентные задания выполняет сервер 1С.
- 💻 В файловой базе они идут, только пока открыт хотя бы один сеанс программы.
- 🔍 Проверить запуск можно в журнале регистрации, отбор по событиям регламентных заданий.
Запуск при входе в программу
Обработку можно открыть сразу при старте 1С ключом командной строки /Execute:
"C:\Program Files\1cv8\common\1cestart.exe" ENTERPRISE /F"D:\Bases\Buh" /N"Администратор" /Execute "D:\Tools\obrabotka.epf"
Путь к базе, имя пользователя и файл замените своими. Пароль в ярлыке хранить не стоит. Такой ярлык удобен для служебных обработок, которые запускает один администратор.
Ошибки при подключении обработки и что с ними делать
Частые вопросы
Можно ли подгрузить обработку в 1С Фреш или другой облачный сервис?
.epf через меню там обычно нельзя.Чем внешняя обработка отличается от расширения конфигурации?
.cfe) меняет поведение самой конфигурации: добавляет реквизиты, правит формы и модули. Подключаются они разными механизмами.