Разработка и Конфигурация · 9 мин
Как открыть код обработки в 1С
Как открыть код внешней обработки в 1С через конфигуратор: пошаговая инструкция, работа с защищёнными файлами, просмотр модулей, типичные ошибки и ответы на вопросы.
Внешняя обработка в 1С — это файл с расширением .epf, который содержит формы, макеты и программный код на встроенном языке. Чтобы посмотреть или изменить этот код, недостаточно открыть файл в режиме «Предприятие»: там обработка только выполняется. Просмотр и редактирование кода выполняется в конфигураторе, и у этого процесса есть несколько важных нюансов — от прав доступа до защиты модулей паролем.
Ниже разобраны рабочие способы открыть код обработки: через конфигуратор, прямо из режима «Предприятие», а также варианты для ситуаций, когда файл защищён или поставляется без исходников. Отдельно описано, как устроена структура обработки и где именно искать нужный фрагмент кода.
Что нужно перед началом работы
Для открытия кода обработки потребуется конфигуратор 1С и пользователь с правами, допускающими его запуск. В файловых базах обычно достаточно зайти под пользователем с полными правами. В клиент-серверном варианте доступ к конфигуратору может быть ограничен администратором, и тогда понадобится отдельная учётная запись.
Также заранее уточните версию платформы, под которую написана обработка. Файл, созданный на более новой платформе, может не открыться или открыться с ошибками в старой версии. Обратная ситуация обычно безопасна: старые обработки в новых платформах открываются, хотя отдельные методы могут требовать доработки.
Перед любыми изменениями сделайте копию файла .epf. Внешняя обработка — самостоятельный файл, и испорченный оригинал без резервной копии восстановить бывает невозможно.
Открытие обработки через конфигуратор
Основной способ — открыть файл напрямую в конфигураторе. Запустите ярлык «1С:Предприятие», выберите нужную базу в списке и нажмите кнопку «Конфигуратор». Если база файловая и в ней никто не работает, конфигуратор откроется сразу.
Далее в меню выберите «Файл» → «Открыть» и укажите файл обработки с расширением .epf. Конфигуратор загрузит структуру обработки: в левой части появится дерево метаданных самой обработки — формы, макеты, реквизиты.
Важно понимать: при открытии .epf конфигуратор показывает не конфигурацию базы, а именно эту обработку. Редактирование идёт в самом файле, и после сохранения изменения сразу попадают в .epf.
- 1Запустите конфигуратор для нужной базы
- 2Откройте меню Файл → Открыть и выберите файл .epf
- 3Дождитесь загрузки структуры обработки в дереве объектов
- 4Откройте нужный модуль: объекта, формы или команды
- 5Внесите изменения и сохраните файл через Файл → Сохранить
- 6Проверьте работу обработки в режиме Предприятие
Где именно находится код внутри обработки
Код обработки распределён по нескольким модулям, и новички часто ищут текст не там. Основные места:
- Модуль объекта — процедуры и функции, доступные при программном вызове обработки: печать, заполнение, экспортные методы. Открывается из контекстного меню корня дерева обработки («Открыть модуль объекта»).
- Модули форм — обработчики событий элементов формы: нажатия кнопок, изменения полей, команды. Открываются двойным щелчком по форме и переходом на закладку «Модуль».
- Модуль менеджера — встречается реже, используется для программного создания объекта обработки.
- Макеты — не код, но часто нужны вместе с ним: табличные документы, схемы компоновки, двоичные данные.
Если обработка открывается пользователем через форму, почти вся прикладная логика обычно находится в модуле основной формы. Если обработка подключается как внешняя печатная форма или заполнение — ищите функции СведенияОВнешнейОбработке() и Печать() в модуле объекта.
Открытие кода из режима «Предприятие»
Быстрый путь без отдельного поиска файла на диске — открыть обработку в режиме «Предприятие» (Файл → Открыть), а затем перейти в конфигуратор и открыть тот же файл там. Удобнее всего, когда путь к файлу уже известен из окна запуска.
Если обработка подключена к базе через механизм «Дополнительные отчеты и обработки» (БСП), её файл хранится внутри информационной базы, а не на диске. В этом случае сначала выгрузите обработку: откройте справочник дополнительных отчетов и обработок, найдите нужный элемент и используйте команду «Выгрузить в файл». Полученный .epf открывайте в конфигураторе обычным способом.
После доработки обратная загрузка выполняется командой «Загрузить из файла» в том же элементе справочника. Помните, что замена действующей обработки сразу влияет на всех пользователей, которые её запускают.
Защищённые обработки и поставка без исходного кода
Не каждую обработку можно открыть для просмотра кода. Разработчик может поставить пароль на модуль — тогда при попытке открыть текст конфигуратор запросит пароль, и без него код недоступен. Это штатная защита, и обходить её не следует: это нарушает условия поставки и права автора.
Второй вариант — поставка без исходных текстов. В таком файле модули физически отсутствуют в читаемом виде, и конфигуратор покажет формы и макеты, но код открыть не получится. Единственный легальный путь — запросить исходники у разработчика или поставщика решения.
Признак защищённой обработки: файл открывается в конфигураторе, формы видны, но при обращении к модулю появляется окно ввода пароля либо модуль открывается пустым.
Как проверить результат
Дерево обработки с формами и макетами загружается без ошибок
Ошибка формата или требование более новой платформы
Текст кода отображается и доступен для редактирования
Запрос пароля или пустой модуль
Файл сохраняется, обработка запускается в режиме Предприятие
Ошибки компиляции модуля при сохранении
Типичные ошибки и их решение
Самая частая проблема — попытка открыть .epf двойным щелчком в проводнике. Файл запустится в режиме «Предприятие» и просто выполнится, а не откроется для редактирования. Код доступен только через конфигуратор.
Вторая распространённая ситуация — ошибка «Нарушена целостность структуры файла» или несовместимость версий. Это значит, что обработка создана на другой версии платформы. Решение — запустить конфигуратор той версии, под которую файл был собран, либо попросить автора пересохранить обработку под вашу платформу.
Третья ошибка — редактирование обработки, которую в этот момент кто-то запускает в файловой базе. Файл может быть заблокирован, и сохранение не пройдёт. Дождитесь завершения работы пользователей или скопируйте файл и работайте с копией.
Как выбрать подход в разных ситуациях
Если нужно просто посмотреть логику — открывайте файл в конфигураторе напрямую, это самый быстрый путь. Если обработка работает внутри базы как дополнительная — сначала выгрузите её из справочника. Если код закрыт паролем — свяжитесь с разработчиком, других корректных вариантов нет.
Как выбрать действие
Для регулярной доработки удобно хранить обработки в системе контроля версий или хотя бы в папке с датированными копиями. Это позволяет откатить изменения и сравнивать редакции без риска потерять рабочий вариант.
Что важно запомнить
Код обработки открывается только в конфигураторе через Файл → Открыть. Логика распределена между модулем объекта и модулями форм. Обработки из справочника дополнительных отчетов сначала выгружаются в файл. Защищённые паролем модули штатно не открываются. Перед правками всегда делайте копию файла.
Частые вопросы
Можно ли открыть код обработки без конфигуратора?
Штатными средствами — нет. Просмотр и редактирование модулей встроенного языка выполняется только в конфигураторе. Сторонние инструменты существуют, но для защищённых файлов их использование нарушает условия поставки и не гарантирует корректного результата.
Почему модуль формы открывается пустым?
Чаще всего это признак поставки без исходного кода: разработчик убрал тексты модулей при сборке файла. Формы и макеты при этом остаются видимыми. Получить код можно только от автора обработки.
Чем отличается .epf от .erf?
.epf — это готовая внешняя обработка, которую можно запускать и редактировать. .erf — промежуточный формат выгрузки обработки в XML-подобном виде, используемый некоторыми инструментами разработки для хранения в системах контроля версий. Для просмотра кода обычно работают именно с .epf.
Как найти нужную процедуру в большой обработке?
Используйте глобальный поиск (Ctrl+Shift+F) по всем модулям открытой обработки. Также помогает список процедур и функций модуля — выпадающий список над текстом кода в редакторе модуля.
Опасно ли открывать чужую обработку в конфигураторе?
Само открытие файла для просмотра безопасно — код не выполняется. Опасность представляет запуск обработки в режиме «Предприятие»: код может изменять данные базы. Незнакомые обработки запускайте только в тестовой копии базы.
Обработка не открывается с ошибкой о версии платформы. Что делать?
Установите или выберите в списке баз ту версию платформы, под которую создан файл, и откройте конфигуратор из неё. Если нужной версии нет, попросите автора пересохранить обработку под вашу платформу — обратная совместимость файлов не гарантируется.