К статье
Практический материал

Разработка и Конфигурация · 11 мин

Как посмотреть текст обработки 1С

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

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

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

Важное ограничение: не каждый код можно посмотреть. Разработчик обработки может поставить пароль на модуль или поставить её без исходных текстов. В таком случае легального способа увидеть код штатными средствами не существует — остаётся только запросить исходники у автора или поставщика.

Что такое текст обработки и где он хранится

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

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

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

Как открыть внешнюю обработку (файл epf) в конфигураторе

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

В меню выберите «Файл → Открыть» и укажите путь к файлу с расширением epf. Конфигуратор загрузит структуру обработки: в левой части появится дерево с формами, макетами и модулем объекта. Если вместо этого появляется сообщение об ошибке формата — файл повреждён или это не обработка, а, например, переименованный отчёт другого формата.

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

Порядок действий для внешней обработки
  1. 1
    Запустите конфигуратор 1С и войдите в базу
  2. 2
    Выберите «Файл → Открыть» и укажите файл .epf
  3. 3
    Дождитесь загрузки структуры обработки
  4. 4
    Откройте модуль объекта двойным щелчком
  5. 5
    Для просмотра кода кнопок откройте форму и перейдите в её модуль

Как посмотреть код встроенной обработки в конфигурации

Если обработка входит в состав конфигурации (например, «Универсальный обмен данными» или типовые сервисные обработки), откройте конфигуратор и выполните «Конфигурация → Открыть конфигурацию». В дереве объектов найдите ветку «Обработки» и разверните её.

Найдите нужную обработку по имени. Быстрый способ — использовать поиск по дереву конфигурации или отфильтровать объекты. Двойной щелчок по имени откроет окно редактирования объекта, а для просмотра кода нужно выбрать «Модуль объекта» через правую кнопку мыши или соответствующую закладку.

Для управляемых форм код находится отдельно: откройте форму обработки, затем перейдите на закладку «Модуль» внизу окна редактора формы. Там будут обработчики событий формы и команд.

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

Где именно искать нужный фрагмент кода

Модули обработок могут содержать сотни и тысячи строк. Чтобы не читать всё подряд, используйте поиск по модулю: сочетание клавиш Ctrl+F в окне редактора кода. Ищите по имени процедуры, тексту сообщения об ошибке, которое выдаёт обработка, или по названию реквизита.

Полезный приём — поиск по тексту сообщения. Если обработка выводит «Не заполнен договор контрагента», найдите эту строку в модуле: рядом с ней будет проверка, которая приводит к отказу, и станет понятно, какое условие нужно выполнить.

Для навигации по структуре модуля используйте выпадающий список процедур и функций в верхней части окна редактора кода либо сочетание Ctrl+O — оно открывает список всех процедур модуля с возможностью быстрого перехода.

Перед тем как читать код, запустите обработку в тестовой базе и воспроизведите проблему. Текст сообщения об ошибке или название кнопки, которая не работает, дадут точные строки для поиска — это в разы быстрее, чем чтение модуля целиком.
ПЗ
Практическое замечание

Что делать, если код защищён или недоступен

Платформа 1С предоставляет разработчикам два механизма защиты: установку пароля на модуль и поставку без исходных текстов. В первом случае при попытке открыть модуль запрашивается пароль. Во втором — модуль открывается, но пуст: код скомпилирован внутри файла и недоступен для чтения.

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

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

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

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

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

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

HTTPСоединение, WSПрокси в кодеОбработка обменивается данными с внешними серверами

Проверьте адреса подключения и какие данные передаются

Удалить() без отбора и проверокВозможно массовое удаление данных

Найдите контекст вызова и условия выполнения

ЗапуститьПриложение, КомандаСистемыОбработка запускает внешние программы

Проверьте, какие команды формируются и зачем

Пароль на модулеКод скрыт разработчиком

Без пароля проверить логику невозможно — запросите исходники

Частые ошибки при открытии и просмотре обработок

Распространённая ситуация — попытка открыть файл epf двойным щелчком в проводнике. В зависимости от ассоциаций файлов Windows он либо запустится в режиме «Предприятие» (и вы увидите только интерфейс), либо не откроется вовсе. Для просмотра кода файл нужно открывать изнутри конфигуратора.

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

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

Типичные ошибки
01
Открытие epf двойным щелчком из проводника — запускается интерфейс, а не код; открывайте файл через меню конфигуратора
02
Поиск логики только в модуле объекта — код кнопок и команд находится в модуле формы
03
Первый запуск непроверенной обработки сразу на рабочей базе — риск порчи данных; используйте копию
04
Попытка снять пароль сторонними утилитами — нарушение лицензии и риск заражения вредоносным ПО

Как убедиться, что вы видите весь код

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

Признак того, что часть кода недоступна: процедура вызывается, но её текста нет ни в одном модуле — значит, она либо в общем модуле конфигурации (для встроенных обработок), либо модуль поставлен без исходного текста.

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

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

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

Виден текст процедур и функций на встроенном языке

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

Запрос пароля или пустое окно — код защищён

Модули форм просмотрены
Норма

Открыты модули всех форм из дерева обработки

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

Кнопка есть, а её обработчик не найден — проверены не все формы

Поиск по вызываемой процедуре
Норма

Процедура найдена в одном из модулей обработки

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

Процедура не найдена нигде — она в общем модуле конфигурации или в недоступной части

FAQ: частые вопросы о просмотре текста обработок 1С

Можно ли посмотреть код обработки в режиме «Предприятие»?

Нет. Режим «Предприятие» показывает только результат работы обработки — формы и данные. Программный код доступен только в конфигураторе или через расширенные инструменты разработчика (EDT).

Чем открыть файл epf, если нет конфигуратора?

Штатных альтернатив нет: формат epf — внутренний формат платформы 1С, и его содержимое корректно читается только инструментами разработки 1С (конфигуратор или 1C:EDT). Текстовые редакторы покажут бинарные данные, а не код.

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

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

Как найти код конкретной кнопки на форме обработки?

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

Можно ли скопировать код из чужой обработки в свою?

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

Чем отличается просмотр текста отчёта от просмотра обработки?

Принцип тот же, но внешний отчёт имеет расширение erf вместо epf, а его основная логика часто находится не в модуле объекта, а в схеме компоновки данных (СКД). СКД открывается отдельной закладкой «Основная схема компоновки данных» в структуре отчёта.

Итог

Что важно запомнить

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