Разработка и Конфигурация · 10 мин
Как открыть внешнюю обработку в конфигураторе 1С
Пошаговая инструкция: как открыть внешнюю обработку (epf) в конфигураторе 1С, просмотреть и изменить код, сохранить файл и устранить типичные ошибки при открытии.
Внешняя обработка в 1С — это файл с расширением .epf (для управляемого приложения) или .ert (для старых версий платформы 7.7), который содержит программный код, формы и макеты, но не входит в состав конфигурации. Такие файлы используют для доработок без изменения типовой конфигурации: печатных форм, загрузки данных, групповых операций, тестовых инструментов.
Открыть внешнюю обработку можно двумя способами: в режиме «Предприятие» — чтобы просто запустить её и воспользоваться функционалом, и в конфигураторе — чтобы посмотреть или изменить код, формы и макеты. Ниже разобран именно второй сценарий: работа с файлом обработки в конфигураторе, его структура, редактирование и сохранение.
Важно понимать: изменения, внесённые во внешнюю обработку, никак не затрагивают основную конфигурацию базы. Это безопасный способ экспериментировать с кодом, но сам файл обработки при этом можно испортить, поэтому перед правками стоит сделать копию.
Что такое внешняя обработка и когда её открывают в конфигураторе
Внешняя обработка хранится отдельным файлом на диске и подключается к системе в момент запуска. В отличие от обработок, встроенных в конфигурацию, её можно передавать между базами, хранить вне информационной базы и дорабатывать без обновления конфигурации.
В конфигураторе обработку открывают, когда нужно: изучить чужой код, исправить ошибку, адаптировать обработку под свою конфигурацию, добавить новую кнопку на форму или изменить макет печатной формы. Если задача — только запустить обработку и получить результат, достаточно режима «Предприятие».
Различают внешние обработки (.epf) и внешние отчёты (.erf). Технология открытия в конфигураторе у них одинаковая — оба типа файлов открываются через меню «Файл» → «Открыть».
Как открыть файл обработки через меню «Файл»
Основной способ — стандартное открытие файла. Запустите конфигуратор той информационной базы, в контексте которой планируете работать с обработкой. Это важно, если код обработки обращается к объектам конфигурации: проверка синтаксиса и подсказки по метаданным будут работать корректно только при открытой нужной базе.
Далее выполните последовательность действий:
- 1Запустите конфигуратор нужной информационной базы
- 2Откройте меню «Файл» и выберите пункт «Открыть» (или нажмите Ctrl+O)
- 3В диалоге выбора файла укажите тип файла «Внешняя обработка (*.epf)» или «Все файлы»
- 4Найдите нужный файл на диске и нажмите «Открыть»
- 5Дождитесь появления окна обработки с деревом её структуры
После открытия появится окно внешней обработки с её структурой: формы, макеты, модуль объекта. Двойной щелчок по форме открывает визуальный редактор формы, по макету — редактор табличного документа, а модуль объекта доступен через контекстное меню «Открыть модуль объекта».
Если конфигуратор запущен без открытия конфигурации базы, файл обработки всё равно откроется, но часть функций (например, контекстная подсказка по объектам метаданных) будет недоступна.
Как просмотреть и изменить код обработки
Основная логика внешней обработки находится в двух местах: модуле объекта и модулях форм. Модуль объекта содержит процедуры и функции, доступные при работе с обработкой как с объектом, в том числе экспортные методы. Модули форм содержат обработчики событий элементов формы — кнопок, полей, таблиц.
Чтобы открыть модуль формы, выделите форму в дереве структуры, нажмите правую кнопку мыши и выберите действие открытия модуля, либо в редакторе формы перейдите на закладку «Модуль». Редактор кода в конфигураторе поддерживает подсветку синтаксиса, проверку ошибок и переход к описанию процедур.
Для поиска нужного фрагмента используйте стандартный поиск по модулю (Ctrl+F) или глобальный поиск по всем модулям обработки через меню «Правка» → «Глобальный поиск». Это удобно, когда обработка большая и нужно найти, где формируется конкретное сообщение или запрос к данным.
Как сохранить изменения в файле обработки
После правок сохраните обработку через меню «Файл» → «Сохранить» (Ctrl+S) — изменения запишутся в тот же файл. Чтобы не перезаписать исходник, используйте «Файл» → «Сохранить как» и укажите новое имя или другую папку.
Рекомендуемый порядок безопасной работы: сначала скопируйте исходный файл обработки в отдельную папку, затем открывайте и правьте рабочую копию. Если после правок обработка перестанет запускаться, исходную версию можно будет вернуть из копии.
Обратите внимание: закрытие окна обработки с несохранёнными изменениями приведёт к их потере — конфигуратор выдаст предупреждение, но если подтвердить закрытие без сохранения, правки не восстановить.
Как проверить результат после редактирования
Минимальная проверка — синтаксический контроль модуля: в редакторе модуля нажмите кнопку проверки синтаксиса или выберите соответствующий пункт в меню «Конфигурация». Все найденные ошибки отобразятся в окне сообщений с указанием строки.
Полная проверка выполняется запуском обработки в режиме «Предприятие». Откройте базу в режиме «Предприятие», затем через «Файл» → «Открыть» выберите изменённый файл обработки и убедитесь, что она запускается, форма отображается корректно, а основные операции выполняются без ошибок.
Если обработка подключается к базе через механизм «Дополнительные отчеты и обработки», после изменения файла его нужно повторно загрузить в соответствующий справочник — старая версия останется в базе до замены.
Как проверить результат
Появилось окно с деревом структуры обработки
Ошибка «Неверный формат файла» или файл не виден в диалоге
Окно сообщений пустое или только предупреждения
Список ошибок с указанием строк модуля
Обработка открывается и выполняет свои функции
Ошибка при запуске или во время выполнения операции
Типичные ошибки и их устранение
Самая частая проблема — файл не открывается с сообщением о неверном формате. Причины: файл повреждён при передаче (например, скачан не полностью), это файл другого типа (например, .erf-отчёт, переименованный вручную), либо обработка создана в более новой версии платформы, чем установлена у вас. Проверьте версию платформы и целостность файла, при необходимости запросите файл заново.
Вторая ситуация — обработка открывается, но при запуске в режиме «Предприятие» появляется ошибка «Обнаружено нарушение безопасности» или запрос на разрешение. Это связано с механизмом безопасности при открытии внешних файлов: подтвердите открытие, если источнику файла вы доверяете. Обработки из неизвестных источников запускать не стоит — код внутри файла выполняется с правами текущего пользователя.
Третья типичная ошибка — после правок обработка не сохраняется с сообщением о занятости файла. Это происходит, если тот же файл открыт в другом сеансе конфигуратора или в режиме «Предприятие». Закройте файл в других сеансах и повторите сохранение.
Альтернативные способы работы с обработкой
Если нужно только посмотреть код без привязки к конкретной базе, можно запустить конфигуратор без открытия конфигурации и открыть файл — структура и модули будут доступны. Однако отладка в таком режиме невозможна.
Для отладки внешней обработки откройте её в конфигураторе, установите точки останова в модуле и запустите отладку (кнопка «Начать отладку» или F5). В открывшемся сеансе «Предприятия» откройте тот же файл обработки — выполнение остановится на точке останова, и можно будет пошагово пройти код и посмотреть значения переменных.
Ещё один вариант — конвертация внешней обработки во встроенную: в дереве конфигурации в ветке «Обработки» через контекстное меню можно вставить внешнюю обработку в состав конфигурации. Это требует права на изменение конфигурации и применяется, когда доработка становится постоянной частью системы.
Сравнение вариантов
Просмотр и редактирование кода, форм и макетов; нужен для доработки. Не запускает обработку
Запуск и использование функционала; код недоступен для правки
Пошаговое выполнение кода с просмотром переменных; требует открытия файла в обоих режимах
Что важно запомнить
Внешняя обработка открывается в конфигураторе через «Файл» → «Открыть» по файлу .epf. Перед правками сделайте копию файла, после правок выполните синтаксический контроль и тестовый запуск в режиме «Предприятие», а в продуктивную базу переносите только проверенную версию.
Частые вопросы
Чем отличается открытие обработки в конфигураторе и в режиме «Предприятие»?
В конфигураторе открывается структура файла для просмотра и редактирования: модули, формы, макеты. В режиме «Предприятие» обработка запускается на выполнение — пользователь работает с её функционалом, но не видит код. Для доработки нужен конфигуратор, для использования — «Предприятие».
Почему файл .epf не виден в диалоге открытия?
В диалоге выбора файла внизу установлен фильтр по типу. Переключите его на «Внешние обработки (.epf)» или «Все файлы (.*)», и нужный файл появится в списке. Также проверьте, что вы смотрите правильную папку.
Можно ли открыть внешнюю обработку, не запуская конфигуратор базы?
Да. Запустите конфигуратор, не открывая конфигурацию, и через «Файл» → «Открыть» выберите файл. Структура и код будут доступны, но проверка обращений к объектам метаданных и отладка работать не будут.
Что делать, если при открытии появляется ошибка формата файла?
Проверьте, что файл скачан или скопирован полностью (сравните размер с исходником), что расширение соответствует типу (обработка — .epf, отчёт — .erf), и что версия платформы не старше той, в которой файл был создан. При несовпадении версий обновите платформу или запросите файл, сохранённый под вашу версию.
Как открыть внешнюю обработку в 1С:Предприятие 7.7?
В версии 7.7 используются файлы .ert. В конфигураторе они открываются аналогично — через «Файл» → «Открыть» с выбором типа «Внешние отчёты и обработки». Файлы .epf от платформы 8.x в 7.7 не открываются, форматы несовместимы.
Безопасно ли открывать обработку, полученную из интернета?
Просмотр кода в конфигураторе относительно безопасен, но запуск в режиме «Предприятие» выполняет код с правами текущего пользователя, включая доступ к данным базы. Перед запуском изучите модуль обработки на предмет подозрительных операций (запись данных, обращения к внешним ресурсам) и проверяйте такие файлы только в тестовой базе.