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

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

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

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

Что нужно подготовить перед открытием обработки

Для открытия внешней обработки потребуется сам файл с расширением .epf (обработка) или .erf (внешний отчёт), а также установленная платформа 1С:Предприятие той версии, под которую создана обработка. Если обработка написана под платформу 8.3, а у вас установлена только 8.2, файл может не открыться или открыться с ошибками совместимости.

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

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

Открытие файла обработки через меню «Файл»

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

После загрузки конфигуратора перейдите в главное меню: Файл → Открыть (или нажмите Ctrl+O). В диалоге выбора файла найдите нужный EPF-файл. Если файл не отображается, проверьте фильтр типа файлов внизу диалога — там должно быть выбрано «Внешние обработки (*.epf)» или «Все файлы».

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

1. 1
   Запустите конфигуратор нужной информационной базы
2. 2
   Откройте меню «Файл» и выберите пункт «Открыть» (Ctrl+O)
3. 3
   В диалоге укажите тип файла «Внешние обработки (*.epf)» и выберите файл
4. 4
   Дождитесь открытия обработки в отдельном окне конфигуратора
5. 5
   Для просмотра кода откройте модуль формы или модуль объекта

Как посмотреть код обработки: модуль формы и модуль объекта

Код внешней обработки распределён по нескольким модулям, и это частый источник путаницы. Начинающие открывают обработку, видят только форму с кнопками и делают вывод, что «кода нет». На самом деле код находится в модулях, которые открываются отдельными командами.

Модуль формы содержит обработчики событий элементов формы: нажатия кнопок, изменения полей, команды. Чтобы открыть его, в окне редактора формы нажмите правой кнопкой мыши на форму и выберите «Модуль» либо воспользуйтесь командой контекстного меню элемента формы.

Модуль объекта содержит основную логику обработки, не привязанную к форме: экспортные процедуры и функции, обработчики событий самого объекта. Чтобы открыть его, закройте окно формы, выделите корень обработки в дереве метаданных окна обработки, нажмите правую кнопку и выберите «Модуль объекта». Именно здесь чаще всего находится основной алгоритм.

Кроме модулей, в обработке могут быть макеты (табличные документы, схемы компоновки данных, двоичные данные) и дополнительные формы. Всё это отображается в дереве структуры обработки в левой части её окна.

Открытие обработки в других сценариях

Открытие обработки, встроенной в конфигурацию

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

Открытие обработки из режима 1С:Предприятие

В режиме предприятия внешняя обработка запускается через Файл → Открыть, но это выполнение, а не редактирование. Если нужно быстро перейти к коду, проще открыть тот же файл в конфигураторе. Некоторые разработчики держат конфигуратор и предприятие открытыми одновременно, чтобы чередовать правку кода и проверку результата.

Открытие обработки без конфигуратора

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

Как добавить внешнюю обработку в конфигурацию

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

Более удобный путь — открыть внешнюю обработку через «Файл → Открыть», затем в меню конфигуратора выбрать команду сохранения копии в конфигурацию, если она доступна в вашей версии платформы, либо скопировать модули и формы в созданную встроенную обработку. После переноса проверьте, что все ссылки на объекты метаданных в коде разрешаются корректно.

Учтите ограничение: встраивание изменяет конфигурацию, поэтому потребуется монопольный доступ к базе и обновление конфигурации базы данных (F7). На типовых конфигурациях с поддержкой это может привести к снятию объектов с поддержки — оцените последствия перед обновлением типового релиза.

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

Открытие как внешней (Файл → Открыть)

Подходит для просмотра и правки кода; не затрагивает конфигурацию, не требует монопольного доступа

Встраивание в конфигурацию

Подходит для постоянного использования в составе решения; требует монопольного доступа и влияет на поддержку типовой конфигурации

Запуск в режиме предприятия

Подходит только для выполнения обработки; код недоступен для редактирования

Типичные ошибки и способы их устранения

Одна из самых частых ситуаций — ошибка «Нарушена целостность структуры файла» при открытии. Обычно это означает, что файл повреждён при скачивании или передаче, либо это вообще не EPF-файл (например, переименованный архив). Решение — получить файл заново из исходного источника.

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

Если меню «Файл → Открыть» работает, но обработка «не видна» в диалоге выбора, проверьте фильтр типа файлов и реальное расширение файла — в Windows расширения могут быть скрыты, и файл, который выглядит как Обработка.epf, на деле может оказаться Обработка.epf.zip.

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

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

Перед сохранением изменений сделайте резервную копию исходного EPF-файла — просто скопируйте его в отдельную папку. Сохранение выполняется через Файл → Сохранить (Ctrl+S) и перезаписывает файл без возможности отмены после закрытия. Для сохранения под новым именем используйте «Файл → Сохранить копию».

Контрольные точки

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

Окно обработки в конфигураторе

Норма

Видны дерево структуры, формы и модули

Тревожный признак

Пустое окно или ошибка открытия файла

Проверка модуля

Норма

Нет ошибок или только ссылки на отсутствующие объекты чужой конфигурации

Тревожный признак

Синтаксические ошибки в самом коде обработки

Сохранение файла

Норма

Файл сохраняется, размер не обнуляется, обработка повторно открывается

Тревожный признак

Ошибка записи или файл не открывается после сохранения

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

Чем отличается файл EPF от ERF?

EPF — это внешняя обработка, ERF — внешний отчёт. Оба открываются в конфигураторе одинаково, через «Файл → Открыть», различается только внутренняя структура: у отчёта по умолчанию есть схема компоновки данных и настройки вариантов.

Можно ли открыть обработку, не запуская конфигуратор конкретной базы?

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

Почему при открытии обработки появляется ошибка «Нарушена целостность структуры файла»?

Файл повреждён при передаче или скачивании, либо это не EPF-файл. Запросите файл заново, проверьте его размер и расширение. Если файл получен архивом, сначала распакуйте его.

Как открыть обработку, если у меня только файловая база без сервера?

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

Безопасно ли открывать обработку, скачанную из интернета?

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

Как из внешней обработки сделать встроенную в конфигурацию?

Создайте новую обработку в ветке «Обработки» дерева конфигурации и перенесите в неё формы, модули и макеты из внешней обработки, открытой через «Файл → Открыть». После переноса потребуется обновление конфигурации базы данных с монопольным доступом.