Правим внешнюю обработку .epf в конфигураторе: от открытия до проверки

Файл с расширением .epf — это внешняя обработка 1С, и правят её не в режиме 1С:Предприятие, а в конфигураторе: Файл → Открыть, выбрать файл — откроется отдельное окно с модулем, формами и макетами. Запустить ту же обработку на выполнение можно и из предприятия, но изменить код или форму там нельзя.

Второй момент, на котором спотыкаются чаще всего: если обработка поставлена на поддержку с защитой или код закрыт поставщиком, кнопки правки будут неактивны, а модуль покажет пустое окно. Это не сбой — так работает защита, и обойти её штатными средствами нельзя. Ниже — как открыть обработку, что в ней можно менять, как отладить результат и как хранить разные версии файла, не превращая папку в свалку из обработка_новая_финал2.epf.

Что лежит внутри файла .epf и когда его трогают

Внешняя обработка — это самостоятельный объект: у неё есть модуль объекта, одна или несколько форм, макеты (печатные формы, схемы компоновки данных), реквизиты и табличные части. Всё это упаковано в один файл .epf. Внешний отчёт хранится в похожем файле с расширением .erf и правится точно так же.

Обработку правят, когда нужно:

• 🔧 изменить алгоритм — например, добавить колонку в выгрузку или новое условие отбора;
• 🖼 поправить форму — переставить поля, добавить кнопку, сменить заголовок;
• 📄 переделать макет печатной формы под свои реквизиты;
• 🐞 найти причину ошибки, которую обработка выдаёт при запуске.

Что сделать до правки: копия файла и настройки конфигуратора

Сначала сделайте копию исходного файла .epf — простым копированием в проводнике. Любая ошибка в коде, и рабочая обработка перестанет запускаться; откатиться к оригиналу проще всего из копии, а не восстанавливая всё по памяти.

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

1. Режим редактирования форм. В Сервис → Параметры → Форма можно переключить, что открывается по умолчанию — конструктор формы или её модуль. Для правки логики удобнее сразу видеть модуль.
2. Проверка синтаксиса и контекстная подсказка. В Сервис → Параметры → Модули → Редактирование включите автоматическую проверку и подсказку по Alt + . — это ловит опечатки в именах методов на лету.

Отдельно учтите версию платформы. Обработку, сохранённую в более новой платформе 8.3, старая не откроет: при открытии появится сообщение о несовместимости версий. Ориентир простой — платформа, в которой вы открываете файл, должна быть с номером не ниже той, где обработку сохранили. Узнать текущий номер можно в конфигураторе через Справка → О программе.

Как открыть и изменить обработку в конфигураторе

Порядок действий — одинаковый и для доработки чужой обработки, и для правки своей.

Открыть файл

Запустите 1С в режиме Конфигуратор (в окне запуска кнопка Конфигуратор, а не 1С:Предприятие). Затем Файл → Открыть, в диалоге выберите .epf. Откроется окно редактирования обработки — отдельное от дерева конфигурации базы. Саму базу обновлять при этом не нужно: внешняя обработка живёт своим файлом.

Если вместо дерева объектов окно пустое или ветки модуля недоступны — обработка защищена. Проверьте это так: в дереве обработки откройте корневой узел, посмотрите свойство, отвечающее за состав модуля. Закрытый код правке не поддаётся.

Поправить модуль

Двойным кликом по узлу откройте нужный модуль — модуль объекта или модуль формы. Редактор кода работает как в основной конфигурации:

• Ctrl + Пробел — контекстная подсказка по типам и методам;
• F12 — переход к определению процедуры;
• синтаксический контроль запускается из меню Текст → Проверить модуль.

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

Изменить форму

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

Переделать макет

Макет печатной формы открывается двойным кликом по узлу макетов. Табличный документ правится как таблица: ячейки, их оформление, именованные области для вывода строк. Если макет — это схема компоновки данных, откроется конструктор СКД с вкладками наборов данных, ресурсов и настроек.

Сохранить результат

Сохранение — Файл → Сохранить или Ctrl + S, пока активно окно обработки. Файл перезапишется на месте. Чтобы сохранить правку отдельным файлом и не трогать оригинал, используйте Файл → Сохранить как… и задайте новое имя. Проверьте, что сохраняете именно обработку, а не конфигурацию базы — при активном дереве конфигурации Ctrl + S сохранит совсем не то.

Отладка обработки после правки

Проверять изменённую обработку на глаз — ненадёжно. Подключите отладчик и пройдите по коду шаг за шагом.

1. В конфигураторе откройте Сервис → Параметры → Запуск 1С:Предприятия → Отладка и убедитесь, что отладка разрешена.
2. В окне обработки поставьте точку останова в модуле — клик на левом поле строки или F9.
3. Запустите 1С:Предприятие кнопкой Начать отладку (F5) из конфигуратора — сеанс стартует с подключённым отладчиком.
4. В предприятии откройте обработку (Файл → Открыть, выбрать .epf) и выполните действие, которое вызывает нужный код. Выполнение остановится на точке.
5. Смотрите значения переменных в окне Табло, шагайте по строкам клавишами F11 (с заходом в процедуры) и F10 (без захода).

Когда код выполняется в цикле и остановка нужна не на каждой итерации, задайте условие точки останова: правый клик по точке, затем задать выражение — отладчик остановится только когда оно истинно. Это экономит десятки нажатий F11 на длинных выборках. А если потеряли нить, откуда вызвана процедура, посмотрите окно стека вызовов — оно показывает всю цепочку от текущей строки до точки входа.

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

Хранение версий: выгрузка, загрузка и работа с несколькими файлами

Внешняя обработка уже сама по себе отдельный файл, поэтому «версия» — это копия .epf с понятным именем. Договоритесь о схеме имён заранее, например ВыгрузкаОстатков_v3_2026-02.epf, и держите архив копий в отдельной папке.

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

Сравнить две версии обработки целиком помогает штатное средство: Конфигурация → Сравнить, объединить обработку…. Оно показывает различия между открытой обработкой и выбранным файлом .epf и позволяет перенести отдельные изменения из одной версии в другую.

Права доступа и безопасный режим при запуске

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

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

Варианты, как это решается:

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

Внешняя обработка или расширение конфигурации: что выбрать

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

Разница по сути:

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

Типичные ошибки при правке и как их читать

Самые частые ситуации и что они означают:

Отдельно про сохранение: если Ctrl + S не перезаписывает файл, а предлагает сохранить конфигурацию — активно окно дерева конфигурации, а не обработки. Кликните по окну обработки и повторите.

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