Как отредактировать обработку EPF в 1С

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

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

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

Что такое EPF-файл и когда его нужно редактировать

EPF (External Processing File) — это скомпилированный контейнер, внутри которого хранятся формы, макеты, табличные документы и модули с программным кодом на встроенном языке 1С. В отличие от расширений конфигурации (CFE), внешняя обработка не меняет структуру базы: она запускается как отдельная программа поверх существующих данных.

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

Подготовка: права, копия файла и тестовая база

Для редактирования потребуется доступ к конфигуратору. Учётная запись должна иметь право запуска толстого клиента и конфигуратора — в типовых конфигурациях это роли «Администратор системы» и «Полные права». Если конфигуратор не запускается или пункт «Конфигуратор» недоступен, обратитесь к администратору базы.

Сделайте копию EPF-файла до внесения любых изменений. Самый надёжный способ — скопировать файл в отдельную папку и добавить к имени дату или номер версии, например ЗагрузкаДанных_v2.epf. Если правка окажется неудачной, вы сможете вернуться к рабочей версии без потерь.

Для проверки изменений используйте копию информационной базы, а не рабочую. Обработка с ошибкой в коде может массово изменить или удалить данные: например, перезаписать цены в справочнике или пометить на удаление документы. В файловом режиме копию базы делают простым копированием файла 1Cv8.1CD, в клиент-серверном — через выгрузку DT или средства СУБД.

Как открыть EPF-файл в конфигураторе

Запустите конфигуратор нужной информационной базы. Важный момент: обработка открывается в контексте конкретной конфигурации, поэтому код, обращающийся к объектам базы (документам, справочникам, регистрам), будет проверяться и выполняться именно в ней. Открывать обработку можно и в пустой базе, но тогда часть проверок синтаксиса будет недоступна.

В меню выберите «Файл → Открыть» и укажите EPF-файл. Конфигуратор покажет структуру обработки: формы, макеты, модуль объекта. Если файл не открывается и появляется ошибка формата, вероятнее всего, он повреждён или создан в несовместимой версии платформы.

Для быстрой навигации по коду используйте комбинацию Ctrl+Shift+F — поиск по всем модулям обработки. Это удобно, когда нужно найти, где формируется конкретное сообщение или вызывается определённая функция.

1. 1
   Сделайте резервную копию EPF-файла и базы
2. 2
   Запустите конфигуратор нужной информационной базы
3. 3
   Откройте файл через меню «Файл → Открыть»
4. 4
   Изучите структуру: формы, макеты, модуль объекта
5. 5
   Найдите нужный участок кода через поиск Ctrl+Shift+F

Редактирование модуля и форм обработки

Основная логика обычно находится в модуле объекта: откройте его через контекстное меню «Открыть модуль объекта». Здесь находятся процедуры и функции, которые выполняются при запуске обработки и обработке данных. Код пишется на встроенном языке 1С — его синтаксис тот же, что и в модулях конфигурации.

Типовая правка выглядит так: находите процедуру, отвечающую за нужное действие (например, ЗагрузитьДанные()), изменяете условия отбора, добавляете новые поля в запрос или меняете алгоритм обработки строк. После правки кода проверяйте синтаксис через «Конфигурация → Проверка конфигурации» с включённой проверкой модулей внешних обработок или просто попыткой сохранения.

Изменение формы обработки

Формы редактируются в визуальном редакторе: двойной щелчок по форме в структуре обработки открывает её макет. Можно добавлять поля ввода, кнопки, табличные части, менять надписи и расположение элементов. Для новой кнопки потребуется создать обработчик в модуле формы — платформа предложит сделать это при привязке действия.

Работа с макетами

Макеты используются для печатных форм и шаблонов. Откройте макет, измените ячейки, параметры (они выделяются квадратными скобками, например [НомерДокумента]) и форматирование. Помните: если вы переименуете параметр в макете, нужно синхронно поправить код, который этот макет заполняет, иначе значение не будет выведено.

Сохранение и подключение изменённой обработки

После внесения правок сохраните файл через «Файл → Сохранить» (перезапишет текущий файл) или «Файл → Сохранить как» (создаст новую версию). Рекомендуется сохранять под новым именем, пока изменения не проверены.

Запуск в режиме «Предприятие» выполняется двумя способами. Первый — через «Файл → Открыть» прямо в пользовательском режиме: подходит для разового запуска. Второй — регистрация в справочнике «Дополнительные отчеты и обработки» (в типовых конфигурациях на БСП): обработка появится в интерфейсе у пользователей, можно настроить права доступа и расписание.

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

// Пример простой правки в модуле объекта:
// добавляем отбор по организации при загрузке
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| Док.Ссылка КАК Документ
|ИЗ
| Документ.РеализацияТоваровУслуг КАК Док
|ГДЕ
| Док.Дата МЕЖДУ &НачалоПериода И &КонецПериода
| И Док.Организация = &Организация"; // добавленное условие
Запрос.УстановитьПараметр("Организация", Организация);

Отладка и проверка результата

Отладка внешней обработки работает так же, как отладка конфигурации. В конфигураторе включите «Отладка → Подключение», убедитесь, что предмет отладки — режим «Предприятие», поставьте точку останова в нужной строке модуля и запустите обработку. Выполнение остановится на точке, и вы сможете смотреть значения переменных через табло (Shift+F9).

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

Типичные ошибки и ограничения

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

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

Ограничения самостоятельного редактирования: если обработка поставляется без исходного кода (закрытый модуль), изменить её логику нельзя — доступны только формы и макеты. Также сложные обработки с обменами и фоновыми заданиями лучше доверить специалисту, если вы не уверены в последствиях правок.

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