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