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

Автоматизация · 12 мин

Внешняя обработка 1С: для чего нужна и как её использовать

Что такое внешняя обработка 1С, для чего она нужна, чем отличается от отчёта и расширения. Как подключить, запустить и не навредить базе.

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

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

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

Что такое внешняя обработка и как она устроена

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

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

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

Часто путают внешние обработки и внешние отчёты — файлы .erf. Разница в назначении: отчёт предназначен для чтения и представления данных (обычно на основе СКД), а обработка — для действий над данными: создания, изменения, удаления, загрузки. Формально обработка тоже может выводить табличный документ, но её основная роль — операции, а не аналитика.

Расширение конфигурации (.cfe) — более «тяжёлый» механизм: оно подключается к базе постоянно, может переопределять типовые процедуры и добавлять объекты метаданных. Расширение оправдано, когда нужно изменить поведение типовой логики для всех пользователей. Обработка же легче: она не меняет поведение системы, а лишь выполняет отдельные операции по требованию.

Что выбрать под задачу

Внешняя обработка (.epf)

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

Внешний отчёт (.erf)

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

Расширение конфигурации (.cfe)

Требуется постоянно изменить поведение типовых объектов: переопределить проведение, добавить реквизиты, новые роли.

Изменение конфигурации

Глубокая переработка, которую нельзя реализовать расширением. Минус — снятие с полной поддержки и сложные обновления.

Типовые задачи, которые решают внешние обработки

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

  • Загрузка и выгрузка данных. Импорт номенклатуры, цен и остатков из Excel или CSV, выгрузка документов в банк, обмен с маркетплейсами и сайтами, миграция данных между базами.
  • Групповая обработка объектов. Массовое изменение реквизитов справочников, перепроведение документов за период, установка или снятие пометки удаления, закрытие «висящих» заказов.
  • Исправление ошибок учёта. Поиск и устранение дублей контрагентов, корректировка движений документов, восстановление последовательностей, проверка заполнения обязательных полей.
  • Нестандартные печатные формы. Печать документов по макету заказчика, этикетки, ценники, реестры — через подключение внешней печатной формы к типовому документу.
  • Сервисные операции. Тестирование запросов, анализ прав доступа, контроль целостности данных перед отчётным периодом.

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

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

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

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

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

Безопасность: чего опасаться при запуске сторонних обработок

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

Минимальный безопасный порядок такой: сначала запуск в копии базы, затем — в рабочей базе под пользователем с ограниченными правами, и только после проверки результата — штатное использование. Для операций, изменяющих данные массово (перепроведение, групповое изменение), перед запуском делают резервную копию или выгрузку .dt. В файловых базах это копирование файла 1Cv8.1CD при остановленной работе пользователей, в клиент-серверных — штатный бэкап СУБД.

Ограничения и частые ошибки

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

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

Типичные ошибки при работе с обработками
01
Запуск файла из интернета сразу в рабочей базе — риск порчи или утечки данных. Проверяйте на копии.
02
Использование обработки, написанной под другую конфигурацию или старую версию, — ошибки вида «Поле объекта не обнаружено» или тихое искажение данных.
03
Массовые изменения без резервной копии — невозможность отката при ошибке в логике обработки.
04
Проверка только под администратором — у рядовых пользователей обработка потом не работает из-за прав.
05
Хранение единственной копии обработки на локальном диске сотрудника — после его ухода или сбоя диска инструмент теряется.

Как проверить, что обработка отработала корректно

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

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

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

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

Количество обработанных объектов
Норма

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

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

Часть объектов пропущена без объяснения в протоколе

Контрольные суммы и итоги
Норма

Суммы по отчётам до и после отличаются ровно на величину операции

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

Необъяснимые расхождения в оборотах или остатках

Выборочная проверка объектов
Норма

Реквизиты заполнены ожидаемыми значениями

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

Пустые поля, неверные типы значений, «битые» ссылки

Журнал регистрации и протокол
Норма

Есть записи об изменениях, ошибок нет

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

Ошибки в журнале, отсутствие протокола у обработки

Когда обработки недостаточно

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

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

Маршрут решения

Как выбрать действие

Операция разовая или редкая, меняет только данныеИспользуйте внешнюю обработку через «Файл → Открыть»
Обработку должны запускать пользователи регулярно из интерфейсаПодключите её через «Дополнительные отчеты и обработки» с настройкой размещения и прав
Нужно изменить поведение типовых документов или добавить реквизитыРеализуйте доработку расширением конфигурации
Требуются новые объекты учёта и глубокая переработка логикиПланируйте изменение конфигурации с учётом стоимости дальнейших обновлений
Держите каталог используемых обработок с указанием версии конфигурации, под которую каждая написана, и кратким описанием логики. После обновления базы это позволит за минуты понять, какие обработки нужно перепроверить, а не вспоминать по памяти.
ПЗ
Практическое замечание

Частые вопросы

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

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

Чем файл .epf отличается от .erf?

.epf — внешняя обработка, предназначена для действий над данными (загрузка, изменение, печать). .erf — внешний отчёт, предназначен для выборки и представления данных, обычно на основе системы компоновки данных.

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

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

Обработка после обновления конфигурации выдаёт ошибку «Поле объекта не обнаружено». Что делать?

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

Можно ли отменить изменения, которые внесла обработка?

Штатной кнопки «отменить» нет: обработка изменяет данные напрямую. Откат возможен только восстановлением из резервной копии или обратной операцией, если она предусмотрена. Поэтому перед массовыми изменениями всегда делайте копию базы и тестируйте обработку на ней.

Где безопасно брать готовые внешние обработки?

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

Итог

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

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