Внешняя обработка .epf: разовое открытие, подключение в список и права пользователей
Содержание
Быстрее всего загрузить EPF в 1С так: откройте главное меню (кнопка с тремя полосками в левом верхнем углу окна), выберите Файл → Открыть (или нажмите Ctrl+O), укажите файл .epf и подтвердите предупреждение безопасности. Обработка откроется сразу, но только на этот сеанс. Чтобы она появилась в разделе и была у всех пользователей, её добавляют в справочник дополнительных обработок через Администрирование → Печатные формы, отчеты и обработки.
Типичная ситуация: программист прислал файл «Загрузка из Excel .epf», бухгалтер дважды кликает по нему в проводнике, и ничего не происходит. Или 1С пишет «Нарушение прав доступа». Оба случая решаются за несколько минут, если понимать, каким способом добавить файл EPF в 1С и какие права для этого нужны.
Что за файл EPF и чем он отличается от ERF и CFE
EPF (External Processing File) — внешняя обработка. Это кусок программы на встроенном языке 1С с формой и модулем, который живёт вне конфигурации. Его не нужно встраивать в базу через Конфигуратор: файл открывается поверх любой совместимой базы.
Зачем такие файлы обычно присылают:
- 📥 загрузка данных из Excel , CSV, выписок, файлов поставщиков;
- 🛠 групповая обработка документов и справочников (перепровести, заменить реквизит, перенумеровать);
- 🖨 нестандартная печатная форма, например счёт с логотипом или акт в формате заказчика;
- 🔍 разовая проверка или исправление данных после ошибки обмена;
- 📊 выгрузки во внешние системы.
Рядом с EPF встречаются похожие форматы. Их часто путают:
| Расширение | Что это | Как подключать |
|---|---|---|
.epf | Внешняя обработка | Файл → Открыть или справочник дополнительных обработок |
.erf | Внешний отчёт | Так же, как .epf, только в списке дополнительных отчётов |
.cfe | Расширение конфигурации | Администрирование → Печатные формы, отчеты и обработки → Расширения или Конфигуратор |
.cf / .cfu | Конфигурация / обновление | Только через Конфигуратор |
Если вам прислали .cfe, то это не обработка, и способы ниже к нему не подходят.
Двойной клик по .epf в проводнике обычно не работает : файл не связан с программой или запускает 1С с окном выбора базы. Надёжнее открывать его изнутри нужной базы.
Способ 1. Открыть файл EPF через меню «Файл»
Подходит для разовых задач: загрузить данные один раз, проверить базу, запустить исправление. Ничего не записывается в базу, после закрытия обработки её нет в интерфейсе.
- Запустите 1С:Предприятие в нужной базе (не Конфигуратор).
- Нажмите кнопку главного меню в левом верхнем углу окна. В разных версиях интерфейса это три полоски или стрелка.
- Выберите
Файл → Открыть. То же самое делает сочетаниеCtrl+O. - В окне выбора смените фильтр, если файл не виден: по умолчанию могут показываться не все типы. Выберите файл
.epf. - Платформа покажет предупреждение безопасности: файл может содержать небезопасный код. Нажмите
Да, если доверяете источнику. - Откроется форма обработки. Работайте с ней как с обычным окном программы.
Сохраните обработку в постоянную папку, например D:\1C\Обработки\, а не в «Загрузки». Если запускать файл повторно, путь искать не придётся: 1С запоминает последние открытые файлы в меню Файл.
Если вместо формы появилась ошибка, переходите к разделу про ошибки ниже. Самые частые причины — нет права на открытие внешних обработок или файл сделан под другую конфигурацию.
Способ 2. Подключить EPF как дополнительную обработку
Этот способ нужен, когда обработкой пользуются регулярно: печатная форма, ежемесячная загрузка, заполнение табличной части. После подключения она появляется в разделе программы или в карточке документа, и пользователю не нужен сам файл.
Способ работает в типовых конфигурациях на БСП: Бухгалтерия предприятия 3.0, ЗУП 3.1, Управление торговлей 11, Комплексная автоматизация 2, ERP, УНФ.
Шаг 1. Включите дополнительные отчёты и обработки
- Откройте
Администрирование → Печатные формы, отчеты и обработки. - Установите флажок
Дополнительные отчеты и обработки. - Рядом станет активной ссылка на одноимённый справочник.
Флажок доступен только пользователю с полными правами.
Шаг 2. Загрузите файл
- Перейдите по ссылке
Дополнительные отчеты и обработки. - Нажмите
Создать(в некоторых релизах —Добавить из файла). - Подтвердите предупреждение безопасности и выберите файл .epf.
- Программа прочитает из файла его вид, название и команды. Вид определяется самой обработкой: глобальная обработка, заполнение объекта, печатная форма, создание связанных объектов и т. п.
Если 1С сообщает, что файл нельзя подключить как дополнительную обработку, значит в нём нет нужного программного описания. Такую обработку можно открыть только способом 1, либо попросить разработчика доработать её под БСП. В модуле объекта должна быть экспортная функция СведенияОВнешнейОбработке().
Шаг 3. Настройте размещение и доступ
То, где появится команда, зависит от вида обработки.
| Вид обработки | Где появится команда | Что настроить |
|---|---|---|
| Глобальная обработка | Раздел программы, пункт «Дополнительные обработки» | Поле «Размещение»: выбрать разделы, например «Продажи» |
| Печатная форма | Кнопка «Печать» в указанных документах | Список объектов назначения задаётся в самой обработке |
| Заполнение объекта | Кнопка «Заполнить» в форме документа | Объекты назначения — из обработки |
| Отчёт | Раздел, пункт «Дополнительные отчеты» | Размещение по разделам |
Дальше на закладке команд укажите, кому давать быстрый доступ. Для этого в табличной части с командами есть колонка быстрого доступа: по клику открывается список пользователей. Отметьте нужных.
После этого нажмите Записать и закрыть. Команда появится у пользователей после перезапуска 1С или переоткрытия раздела.
Шаг 4. Обновление обработки
Новую версию файла не нужно добавлять заново. Откройте карточку в справочнике, нажмите Загрузить из файла и выберите новый .epf. Настройки размещения и быстрого доступа сохранятся.
Не создавайте вторую карточку для той же обработки. В разделах появятся две одинаковые команды, а пользователи будут запускать то старую, то новую версию.
Сравнение способов: какой выбрать
| Критерий | Файл → Открыть | Дополнительные обработки |
|---|---|---|
| Где хранится | Файл на диске пользователя | Внутри базы |
| Кто видит | Только тот, кто открыл | Отмеченные пользователи |
| Нужен файл каждый раз | Да | Нет |
| Права | Право интерактивного открытия внешних обработок | Права на использование дополнительных обработок |
| Подходит для печатных форм | Нет, кнопка в документе не появится | Да |
| Работа в облаке (1С:Фреш) | Обычно запрещено | Да, после проверки сервисом |
Правило простое: один раз — через меню, регулярно или для нескольких людей — через справочник.
Права пользователя на открытие внешних обработок
Пользователь с полными правами открывает .epf без ограничений. У обычного бухгалтера или менеджера права на это по умолчанию нет. Это сделано намеренно: внешняя обработка может изменить и удалить любые данные, к которым у неё есть доступ.
Как выдать право в конфигурациях на БСП
В БП 3.0, ЗУП 3.1, УТ 11 права выдаются через группы доступа:
- Откройте
Администрирование → Настройки пользователей и прав. - Перейдите в
Группы доступа(илиПрофили групп доступа, если нужно поменять сам профиль). - Найдите профиль, который назначен пользователю, и посмотрите его роли. За открытие файлов с диска отвечает роль со словами «Интерактивное открытие внешних отчетов и обработок». Быстро найти её можно поиском по списку ролей.
- Удобнее не менять типовой профиль, а создать отдельную группу доступа с профилем, в котором есть только эта роль, и добавить в неё нужных людей.
Для запуска уже подключённых дополнительных обработок отдельное право на открытие файлов не нужно. Достаточно, чтобы пользователю был дан быстрый доступ к команде и чтобы его профиль позволял пользоваться дополнительными отчётами и обработками.
Защита от опасных действий
С версии платформы 8.3.9 при открытии внешнего файла 1С показывает предупреждение безопасности. Это поведение включает флажок Защита от опасных действий в свойствах пользователя.
- В Конфигураторе:
Администрирование → Пользователи, карточка пользователя, закладка «Основные». - В пользовательском режиме флажок есть в карточке пользователя не во всех конфигурациях.
Не снимайте этот флажок у рядовых пользователей. Предупреждение — последний шанс заметить, что запускается подозрительный файл. Снимать его имеет смысл разве что у служебного пользователя, под которым регламентные задачи открывают обработки автоматически.
Ошибки при загрузке EPF и что с ними делать
Помимо ошибок из схемы выше, на практике регулярно встречаются такие ситуации.
Обработка открылась, но кнопка ничего не делает. Чаще всего код упал на сервере, а сообщение ушло в окно сообщений внизу формы. Разверните его и прочитайте текст. Если там «Недостаточно прав для…», обработке не хватает прав пользователя на сами данные: на документ, регистр или справочник.
Обработка работает у администратора, но не у бухгалтера. Внешняя обработка выполняется с правами того, кто её запустил. Ей не хватает тех же прав, что и самому пользователю. Решение — выдать права на нужные объекты, а не включать всем «Полные права».
Дополнительная обработка запрашивает разрешения. В новых релизах БСП подключённые обработки по умолчанию работают в безопасном режиме. Если обработке нужен доступ к файлам, COM-объектам или интернет-адресам, при подключении появится запрос разрешений. Его подтверждает администратор. Не одобряйте разрешения вслепую: прочитайте, к каким ресурсам обработка просит доступ.
Ошибка в веб-клиенте при выборе файла. В браузере файл сначала загружается на сервер. Блокировщики и настройки браузера могут мешать окну выбора файла. Проверьте, разрешены ли всплывающие окна для адреса базы.
Печатная форма не появилась в меню «Печать». Проверьте три вещи: обработка записана в справочник, у пользователя отмечен быстрый доступ или обработка видна всем, документ указан среди объектов назначения в карточке.
Если ошибка возникает только на одном компьютере, а у коллег всё работает, начните с очистки кэша клиента: запустите 1С с параметром /ClearCache. Делайте это при закрытой программе на этом компьютере — на других пользователей очистка не влияет.
Особенности для разных версий платформы и интерфейсов
Порядок действий зависит не столько от конкретной конфигурации, сколько от типа приложения и клиента.
| Ситуация | Как открыть .epf | Нюансы |
|---|---|---|
| 8.3, управляемое приложение, тонкий клиент (БП 3.0, ЗУП 3.1, УТ 11) | Главное меню → Файл → Открыть | Открываются только обработки на управляемых формах |
| 8.3, обычное приложение, толстый клиент (УПП 1.3, БП 2.0) | Меню Файл → Открыть в верхней строке окна | Работают обработки на обычных формах; в новых БСП-механизмах подключение отличается |
| 8.3, веб-клиент | Главное меню → Файл → Открыть, файл загружается через браузер | Обработки на обычных формах не работают |
| 1С:Фреш и другие облачные сервисы | Через дополнительные обработки | Файл проходит проверку сервиса, произвольное открытие с диска обычно запрещено |
| 8.2 | Меню Файл → Открыть | Файлы, сохранённые в 8.3, в 8.2 не откроются |
Обработку, которую сделали для 8.2, в 8.3 обычно можно открыть. Обратное не работает. Если обработка старая и рассчитана на обычные формы, в тонком клиенте 8.3 она не откроется — понадобится толстый клиент или переписанная версия.
Безопасность: как не запустить в базе опасный код
Внешняя обработка — это программа с доступом к вашим данным. Она может провести тысячу документов, удалить справочник, отправить данные по сети или запустить файл на компьютере. Поэтому несколько правил:
- 🔒 Берите обработки только у известного разработчика, своего программиста или из проверенного каталога.
- 🧪 Сначала запустите обработку на копии базы. Для файловой базы это копия папки или выгрузка
.dt, для серверной — отдельная тестовая база. - 👀 Если есть программист, пусть откроет файл в Конфигураторе через
Файл → Открытьи просмотрит модуль. Подозрительно, если там естьCOMОбъект,ЗапуститьПриложение,УдалитьФайлы,Выполнитьили обращения к интернет-адресам без понятной причины. - 🔑 Закрытый паролем модуль — повод уточнить у автора, что делает обработка. Сам по себе пароль не означает вред, но проверить код вы уже не сможете.
- 💾 Перед групповыми изменениями данных сделайте резервную копию. Отменить массовое перепроведение или удаление средствами обработки обычно нельзя.
Не скачивайте обработки с форумов и файлообменников ради «лечения» лицензий или обхода ограничений программы. Это незаконно и чаще всего именно так в базу попадает вредоносный код.