Внешняя обработка .epf: разовое открытие, подключение в список и права пользователей

· 10 мин

Содержание

Быстрее всего загрузить 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. Запустите 1С:Предприятие в нужной базе (не Конфигуратор).
  2. Нажмите кнопку главного меню в левом верхнем углу окна. В разных версиях интерфейса это три полоски или стрелка.
  3. Выберите Файл → Открыть. То же самое делает сочетание Ctrl+O.
  4. В окне выбора смените фильтр, если файл не виден: по умолчанию могут показываться не все типы. Выберите файл .epf.
  5. Платформа покажет предупреждение безопасности: файл может содержать небезопасный код. Нажмите Да, если доверяете источнику.
  6. Откроется форма обработки. Работайте с ней как с обычным окном программы.

Сохраните обработку в постоянную папку, например D:\1C\Обработки\, а не в «Загрузки». Если запускать файл повторно, путь искать не придётся: 1С запоминает последние открытые файлы в меню Файл.

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

Способ 2. Подключить EPF как дополнительную обработку

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

Способ работает в типовых конфигурациях на БСП: Бухгалтерия предприятия 3.0, ЗУП 3.1, Управление торговлей 11, Комплексная автоматизация 2, ERP, УНФ.

Шаг 1. Включите дополнительные отчёты и обработки

  1. Откройте Администрирование → Печатные формы, отчеты и обработки.
  2. Установите флажок Дополнительные отчеты и обработки.
  3. Рядом станет активной ссылка на одноимённый справочник.

Флажок доступен только пользователю с полными правами.

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

  1. Перейдите по ссылке Дополнительные отчеты и обработки.
  2. Нажмите Создать (в некоторых релизах — Добавить из файла).
  3. Подтвердите предупреждение безопасности и выберите файл .epf.
  4. Программа прочитает из файла его вид, название и команды. Вид определяется самой обработкой: глобальная обработка, заполнение объекта, печатная форма, создание связанных объектов и т. п.

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

Шаг 3. Настройте размещение и доступ

То, где появится команда, зависит от вида обработки.

Вид обработкиГде появится командаЧто настроить
Глобальная обработкаРаздел программы, пункт «Дополнительные обработки»Поле «Размещение»: выбрать разделы, например «Продажи»
Печатная формаКнопка «Печать» в указанных документахСписок объектов назначения задаётся в самой обработке
Заполнение объектаКнопка «Заполнить» в форме документаОбъекты назначения — из обработки
ОтчётРаздел, пункт «Дополнительные отчеты»Размещение по разделам

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

После этого нажмите Записать и закрыть. Команда появится у пользователей после перезапуска 1С или переоткрытия раздела.

Шаг 4. Обновление обработки

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

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

Сравнение способов: какой выбрать

КритерийФайл → ОткрытьДополнительные обработки
Где хранитсяФайл на диске пользователяВнутри базы
Кто видитТолько тот, кто открылОтмеченные пользователи
Нужен файл каждый разДаНет
ПраваПраво интерактивного открытия внешних обработокПрава на использование дополнительных обработок
Подходит для печатных формНет, кнопка в документе не появитсяДа
Работа в облаке (1С:Фреш)Обычно запрещеноДа, после проверки сервисом

Правило простое: один раз — через меню, регулярно или для нескольких людей — через справочник.

Права пользователя на открытие внешних обработок

Пользователь с полными правами открывает .epf без ограничений. У обычного бухгалтера или менеджера права на это по умолчанию нет. Это сделано намеренно: внешняя обработка может изменить и удалить любые данные, к которым у неё есть доступ.

Как выдать право в конфигурациях на БСП

В БП 3.0, ЗУП 3.1, УТ 11 права выдаются через группы доступа:

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

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

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

С версии платформы 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Объект, ЗапуститьПриложение, УдалитьФайлы, Выполнить или обращения к интернет-адресам без понятной причины.
  • 🔑 Закрытый паролем модуль — повод уточнить у автора, что делает обработка. Сам по себе пароль не означает вред, но проверить код вы уже не сможете.
  • 💾 Перед групповыми изменениями данных сделайте резервную копию. Отменить массовое перепроведение или удаление средствами обработки обычно нельзя.

Не скачивайте обработки с форумов и файлообменников ради «лечения» лицензий или обхода ограничений программы. Это незаконно и чаще всего именно так в базу попадает вредоносный код.

Можно ли запускать внешнюю обработку на обычных формах в «Такси»?
Только в толстом клиенте. В тонком и веб-клиенте формы обычного приложения не открываются, нужна версия обработки на управляемых формах.
Куда 1С сохраняет обработку, открытую через Файл → Открыть?
Никуда. Она читается из файла на диске и живёт до закрытия окна. В базу попадают только данные, которые обработка изменила.
Нужно ли выгонять пользователей из базы, чтобы подключить дополнительную обработку?
Нет. Подключение — обычная запись в справочник, монопольный режим не нужен. Пользователи увидят команду после переоткрытия раздела или перезапуска программы.
Как узнать, в какой версии платформы сделана обработка?
Откройте файл в Конфигураторе. Если версия новее вашей, Конфигуратор откажется его открывать — значит нужно обновить платформу или попросить автора пересохранить файл.
Можно ли удалить подключённую обработку, не трогая конфигурацию?
Да. Пометьте карточку в справочнике дополнительных обработок на удаление или переключите её публикацию в отключённое состояние. Конфигурация при этом не меняется.