Разработка и Конфигурация · 10 мин
Как редактировать ERF-файл (внешнюю обработку) в 1С
Как открыть и отредактировать ERF-файл внешней обработки в 1С через конфигуратор: загрузка, изменение модуля и форм, сохранение, типичные ошибки и проверка результата.
Файл с расширением ERF — это внешняя обработка платформы 1С:Предприятие. Такие файлы содержат программный код, формы и макеты и запускаются прямо из пользовательского режима через «Файл → Открыть» или подключаются к справочнику дополнительных отчетов и обработок. Редактировать ERF можно только в конфигураторе — в обычном режиме предприятия внутреннее устройство файла недоступно.
Типовые ситуации, когда требуется правка ERF: нужно изменить текст сообщения или логику заполнения, поправить запрос, добавить реквизит на форму, адаптировать обработку под новый релиз конфигурации после обновления. Во всех случаях порядок действий одинаков: открыть файл в конфигураторе, внести изменения, сохранить и проверить работу на копии базы.
Перед началом работы убедитесь, что у вас есть исходный ERF-файл (а не только подключенная в базу копия), права на запуск конфигуратора и резервная копия исходного файла. Если обработка получена от стороннего разработчика без исходников, ее модуль может быть защищен паролем — тогда редактирование невозможно без пароля.
Что такое ERF-файл и чем он отличается от EPF
В платформе 1С существуют два похожих формата внешних объектов: ERF — внешняя обработка, EPF — внешний отчет. Структурно они почти идентичны: внутри находятся модуль объекта, формы, макеты и, при необходимости, модуль менеджера. Разница в назначении: обработка (ERF) предназначена для выполнения действий над данными — загрузки, группового изменения, проверки, а отчет (EPF) — для формирования и вывода информации, обычно на базе СКД.
При открытии ERF в конфигураторе вы увидите дерево объекта: реквизиты, табличные части, формы, макеты, модуль объекта. Именно здесь выполняется вся правка. Понимание структуры важно, потому что код обработки может быть распределен между модулем объекта (серверная логика) и модулями форм (интерактивная часть).
Подготовка: права, копии и тестовая база
Для редактирования ERF нужен запуск конфигуратора с пользователем, у которого есть право «Администрирование» или хотя бы возможность открытия внешних файлов. Само по себе редактирование внешней обработки не требует монопольного доступа к базе и не затрагивает конфигурацию — это одно из главных удобств работы с ERF.
Обязательно сделайте копию исходного ERF-файла до внесения правок. Скопируйте файл в отдельную папку с понятным именем, например с датой. Если обработка подключена к базе через механизм дополнительных отчетов и обработок, помните: в базе хранится собственная копия файла, и правка внешнего файла на диске не изменит подключенную версию — ее нужно будет заменить отдельно.
Как открыть ERF-файл в конфигураторе
Запустите конфигуратор нужной базы — версия платформы должна совпадать с той, под которую написана обработка, иначе возможны ошибки совместимости при открытии или сохранении. Далее выберите в меню «Файл → Открыть» и укажите ERF-файл. Конфигуратор загрузит структуру обработки и покажет ее дерево.
Если файл не открывается и появляется ошибка формата, вероятные причины: файл поврежден, это на самом деле не ERF (например, переименованный EPF или XML-выгрузка), либо файл создан в более новой версии платформы. В последнем случае откройте его в конфигураторе той же или более новой версии платформы.
- 1Сделайте резервную копию ERF-файла
- 2Запустите конфигуратор той же версии платформы, что и рабочая база
- 3Выберите Файл → Открыть и укажите файл с расширением .erf
- 4Дождитесь загрузки дерева обработки: реквизиты, формы, макеты, модули
- 5Откройте нужный модуль двойным щелчком для правки
Редактирование модуля, форм и макетов
Правка модуля объекта и модуля формы
Модуль объекта открывается из контекстного меню корня дерева обработки — пункт «Открыть модуль объекта». Здесь обычно находятся экспортные процедуры, обработчики заполнения и серверная логика. Модуль формы открывается из дерева форм и содержит обработчики событий элементов: кнопок, полей, таблиц. В управляемых формах обращайте внимание на директивы компиляции &НаСервере и &НаКлиенте — перенос процедуры между контекстами без необходимости ломает работу обработки.
При правке запросов используйте консоль запросов или конструктор запроса внутри модуля, чтобы сразу проверить синтаксис. После изменений полезно выполнить синтаксическую проверку модуля: в конфигураторе это делается через меню «Текст → Синтаксический контроль» или при сохранении файла.
Правка форм и макетов
Формы редактируются в визуальном редакторе: можно добавлять реквизиты, элементы управления, менять порядок и видимость. Если добавляете новый реквизит формы, не забудьте разместить связанный элемент на форме — иначе пользователь его не увидит. Макеты (табличные документы, схемы компоновки) открываются из ветки «Макеты» и правятся как обычные макеты конфигурации.
Сохранение и подключение измененной обработки
После правок сохраните файл: «Файл → Сохранить» перезапишет текущий ERF, «Сохранить как» позволит создать новую версию рядом. Рекомендуется сохранять измененную обработку под новым именем или в отдельную папку версий, чтобы всегда можно было вернуться к рабочему варианту.
Если обработка используется как файл с диска, достаточно открыть новую версию в режиме предприятия и проверить работу. Если она подключена к справочнику дополнительных отчетов и обработок (в типовых конфигурациях на БСП), откройте карточку обработки в разделе «Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки» и загрузите обновленный файл вместо старого. После замены проверьте, что команды обработки появились в назначенных разделах.
Как проверить результат
Дерево обработки загружается без ошибок формата
Ошибка формата потока или требование пароля на модуль
Синтаксический контроль проходит без ошибок
Ошибки компиляции модуля, неопределенные переменные
Обработка открывается, команды выполняются, данные корректны
Ошибка при открытии формы или падение при выполнении
Новая версия загружена, команды видны пользователям
В базе осталась старая версия, изменения не проявляются
Типичные ошибки и ограничения
Самая частая проблема — модуль обработки защищен паролем. Поставщики обработок нередко закрывают код, и без пароля отредактировать такой ERF нельзя: конфигуратор покажет только структуру форм, но не откроет модуль. В этом случае единственный легальный путь — запросить исходники или пароль у разработчика.
Вторая группа ошибок связана с контекстом исполнения. Код, который в файловой базе работает на клиенте, в клиент-серверном варианте может требовать серверного вызова; обращения к файловой системе с клиента на веб-клиенте запрещены. Если обработка после правки «работает у разработчика и не работает у пользователя», почти всегда дело в разнице контекстов или прав доступа.
Альтернативы прямой правке ERF
Если обработка защищена паролем или ее логика сильно устарела, иногда проще создать новую внешнюю обработку с нуля: в конфигураторе «Файл → Новый → Внешняя обработка», затем перенести нужные формы и фрагменты кода. Это особенно оправдано, когда требуется существенное расширение функциональности — сопровождать собственный код проще, чем чужой закрытый.
Для небольших разовых задач (изменить реквизиты у группы документов, проверить данные) вместо правки ERF можно использовать встроенную обработку «Групповое изменение реквизитов» или консоль кода, если она есть в вашей конфигурации. Это исключает риск испортить рабочую обработку, которой пользуются другие сотрудники.
Как выбрать действие
Частые вопросы
Чем открыть ERF-файл без 1С?
Никак осмысленно: ERF — бинарный формат платформы 1С. Блокнот или сторонние редакторы покажут только служебные данные, но не позволят читать и править код. Для работы нужен конфигуратор 1С:Предприятия подходящей версии.
Почему при открытии ERF просит пароль?
Разработчик обработки установил пароль на модуль объекта или формы. Без пароля код недоступен для просмотра и редактирования. Обратитесь к поставщику обработки за исходной версией или паролем.
Изменения в ERF не видны пользователям. Что не так?
Скорее всего, обработка подключена через справочник дополнительных отчетов и обработок, и в базе хранится старая копия файла. Откройте карточку обработки в базе и загрузите обновленный ERF-файл.
Можно ли редактировать ERF без остановки работы пользователей?
Да. Внешняя обработка — отдельный файл, ее правка в конфигураторе не требует монопольного доступа и не затрагивает конфигурацию базы. Ограничение нужно только на момент замены подключенной версии в справочнике дополнительных обработок.
ERF сохранили в новой платформе, а на старой он не открывается. Что делать?
Форматы внешних обработок не всегда обратно совместимы. Вернитесь к резервной копии файла и редактируйте его в конфигураторе той версии платформы, на которой работает база. Поэтому копия перед правкой обязательна.
Чем ERF отличается от расширения конфигурации (CFE)?
ERF — самостоятельный файл, запускаемый вручную или через механизм дополнительных обработок, он не меняет конфигурацию. Расширение CFE подключается к базе и изменяет поведение типовых объектов. Для правки форм и модулей самой конфигурации используют расширения, для отдельных инструментов — ERF.
Что важно запомнить
ERF редактируется только в конфигураторе: открыть файл, изменить модуль, формы или макеты, сохранить. Перед правкой делайте копию файла, тестируйте изменения на копии базы, а при подключении через БСП не забывайте обновлять версию в справочнике дополнительных обработок. Закрытый паролем модуль без пароля отредактировать нельзя.