Как открыть модуль внешней обработки 1С

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

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

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

Что такое модуль внешней обработки и какие модули бывают

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

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

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

Запустите конфигуратор 1С:Предприятия той же версии платформы, под которой работает ваша база. Открывать саму информационную базу при этом не обязательно — внешняя обработка открывается как автономный файл. Перейдите в меню «Файл — Открыть» (сочетание Ctrl+O), выберите файл с расширением .epf или .erf и подтвердите открытие.

Если файл не открывается и появляется ошибка формата, проверьте три вещи: не повреждён ли файл (попробуйте открыть его копию), не создан ли он в более новой версии платформы, чем ваша, и не является ли это на самом деле файлом отчёта (.erf-отчёт или .epf перепутаны местами). Обработка, сохранённая в платформе 8.3.22, может не открыться в 8.3.10 — это ограничение обратной совместимости форматов.

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

Как открыть модуль объекта

После открытия файла появится окно структуры обработки с деревом: формы, макеты, реквизиты. Чтобы попасть в модуль объекта, щёлкните правой кнопкой по корню дерева (по имени обработки) и выберите пункт «Открыть модуль объекта», либо используйте меню «Действия — Модуль объекта». Откроется редактор кода с серверными процедурами и функциями.

Именно здесь обычно находится функция СведенияОВнешнейОбработке для обработок, подключаемых через механизм БСП «Дополнительные отчеты и обработки», а также процедуры Печать и обработчики заполнения. Если модуль открылся пустым — значит, серверного кода в обработке действительно нет, и вся логика сосредоточена в формах. Это нормальная ситуация для простых обработок с одной кнопкой «Сформировать».

Как открыть модуль формы

В дереве структуры обработки разверните ветку «Формы» и дважды щёлкните по нужной форме — откроется визуальный редактор. Для перехода в код нажмите кнопку «Модуль» на панели инструментов редактора формы или используйте контекстное меню формы. В управляемых формах модуль содержит директивы компиляции (&НаКлиенте, &НаСервере), которые определяют, где выполняется каждая процедура.

Быстрый способ попасть в обработчик конкретного элемента: в редакторе формы выделите кнопку или поле, откройте палитру свойств и в разделе «События» дважды щёлкните по событию (например, «Нажатие»). Конфигуратор сам перенесёт курсор в нужное место модуля формы. Это удобнее, чем искать процедуру прокруткой в длинном модуле.

Особенности обычных форм и файлов .erf

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

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

Открытие обработки, подключенной к базе

Если обработка подключена через справочник «Дополнительные отчеты и обработки», её файл хранится внутри базы, а не на диске. Чтобы получить файл для редактирования, откройте элемент справочника в режиме предприятия и сохраните обработку на диск командой «Сохранить как» (в типовых конфигурациях на БСП такая команда есть в карточке элемента или через «Ещё»). Затем откройте сохранённый файл в конфигураторе обычным способом.

Альтернативный путь — отладка без извлечения файла: в конфигураторе включите «Отладка — Подключение», найдите сеанс пользователя и ставьте точки останова, если обработка запускается из открытого файла. Но для подключённых через БСП обработок код выполняется из временного хранилища, поэтому править его надо именно в извлечённом файле, а затем загружать обратно новой версией.

Способы добраться до кода

Файл — Открыть в конфигураторе

Подходит для файлов .epf/.erf на диске. Самый прямой способ, но требует доступа к файлу

Сохранить из справочника доп. обработок

Подходит, если обработка хранится внутри базы. Сначала извлеките файл, затем откройте в конфигураторе

Отладка через подключение

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

Частые ошибки и их решение

Самая распространённая жалоба — «открыл обработку, а кода нет». Причины: открыт модуль объекта вместо модуля формы; обработка действительно не содержит серверного кода; либо файл открыт в режиме просмотра структуры без перехода в редактор модуля. Проверьте оба места: и модуль объекта, и модули всех форм.

Вторая типичная ситуация — ошибка «Нарушена целостность структуры файла» при открытии. Файл повреждён при копировании или скачивании. Решение: запросите исходник заново, восстановите из резервной копии или из хранилища. Третья ошибка — попытка открыть внешний отчёт (.erf-отчёт) как обработку или наоборот: расширения похожи, но внутренняя структура разная, и открывать файл нужно тем типом объекта, для которого он создан.

Проверка результата после внесения изменений

После редактирования модуля сохраните файл и проверьте синтаксис: в конфигураторе при открытой обработке доступна проверка модуля через меню «Текст — Проверка синтаксиса» (Ctrl+F7 в редакторе модуля). Это отловит опечатки и несбалансированные конструкции до запуска в базе.

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

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

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

Синтаксис модуля

Норма

Проверка завершается без сообщений об ошибках

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

Ошибки компиляции, обработка не запустится в базе

Запуск в тестовой базе

Норма

Обработка открывается, кнопки выполняют ожидаемые действия

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

Ошибки времени выполнения, пустой результат, зависание

Версия в справочнике доп. обработок

Норма

В карточке указана новая версия, пользователи видят обновлённое поведение

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

База использует старую версию, изменения не видны

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

Можно ли открыть модуль внешней обработки без конфигуратора?

Нет. Файл .epf имеет закрытый внутренний формат платформы, и его код доступен только через конфигуратор 1С. Текстовые редакторы и сторонние просмотрщики покажут бинарное содержимое, а не программный код.

Почему модуль формы открывается пустым?

Либо у формы действительно нет программного кода (вся логика в модуле объекта), либо вы открыли форму в режиме просмотра. Проверьте модуль объекта и убедитесь, что нажали именно кнопку «Модуль» в редакторе формы.

Чем отличается файл .epf от .erf?

Оба — внешние объекты 1С. Расширение .epf чаще соответствует обработкам с управляемыми формами, .erf исторически связывают с обычными формами и внешними отчётами. Открываются оба через «Файл — Открыть» в конфигураторе, различие проявляется в режиме запуска.

Обработка не открывается с ошибкой формата файла. Что делать?

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

Как открыть модуль обработки, подключенной к типовой конфигурации?

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

Можно ли посмотреть код обработки через отладчик без открытия файла?

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