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