Как использовать внешнюю обработку в 1С

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

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

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

Что такое внешняя обработка и когда она нужна

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

Типовые задачи, которые решают внешними обработками: групповое изменение реквизитов, загрузка данных из Excel или CSV, поиск и удаление дублей, регламентные проверки перед закрытием периода, подключаемые печатные формы и заполнение табличных частей документов.

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

Как открыть обработку для разового запуска

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

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

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

1. 1
   Сохраните файл .epf в доступную папку
2. 2
   В 1С откройте меню «Файл» → «Открыть» или нажмите Ctrl+O
3. 3
   Выберите файл и подтвердите открытие
4. 4
   Заполните параметры обработки и выполните нужное действие
5. 5
   Проверьте результат в данных базы

Как подключить обработку постоянно

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

Откройте справочник «Дополнительные отчеты и обработки», нажмите «Добавить из файла» и выберите файл .epf. Система прочитает сведения из модуля обработки: название, версию, вид (заполнение объекта, печатная форма, отчёт, глобальная обработка) и список объектов, к которым она привязана. Если обработка написана корректно, она зарегистрируется автоматически.

После добавления назначьте, где обработка будет доступна: в каких разделах меню, для каких видов документов и справочников. Например, обработка заполнения табличной части появится в форме документа по кнопке «Заполнить», а дополнительная печатная форма — в подменю «Печать».

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

Настройка прав и безопасного режима

По умолчанию дополнительные обработки выполняются в безопасном режиме: им запрещены операции с файловой системой, COM-объектами и внешними компонентами. Если обработке нужен доступ к файлам (например, загрузка из Excel), администратор может снять безопасный режим для конкретного элемента справочника — в карточке обработки есть соответствующий флажок.

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

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

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

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

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

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

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

Регистрация в справочнике

Норма

Обработка добавилась, вид определён корректно

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

Ошибка регистрации — нет функции СведенияОВнешнейОбработке

Данные после выполнения

Норма

Изменены только целевые объекты, итоги сходятся

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

Затронуты лишние документы или справочники

Права доступа

Норма

Обработку видят только нужные роли

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

Обработка доступна всем пользователям

Типичные ошибки и их решение

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

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

Третья проблема — обработка работает у администратора, но пустует у рядового пользователя. Это следствие RLS и ограничений по ролям: обработка читает данные в рамках прав запустившего её пользователя. Это нормальное поведение, а не сбой — либо расширяйте права пользователя, либо пересматривайте логику обработки.

Часто задаваемые вопросы

Чем внешняя обработка отличается от расширения конфигурации?

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

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

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

Можно ли запустить внешнюю обработку в 1С:Фреш или веб-клиенте?

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

Безопасно ли скачивать обработки с интернета?

Риск есть всегда: файл может содержать вредоносный или просто некорректный код. Минимальный набор мер — открыть обработку в конфигураторе и просмотреть код, проверить на копии базы, запускать в безопасном режиме и делать резервную копию перед операциями, меняющими данные.

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

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

Обработка изменила данные с ошибкой — как откатить?

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