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

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

Внешние обработки 1С: что это и как с ними работать

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

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

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

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

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

Файл внешней обработки создаётся в конфигураторе 1С через меню «Файл → Новый → Внешняя обработка». Внутри находятся: модуль объекта с кодом на встроенном языке, одна или несколько форм для интерфейса пользователя, макеты (например, печатные формы или шаблоны табличных документов) и описание реквизитов обработки.

Ключевое свойство — независимость от конфигурации. Обработка не хранится внутри базы как объект метаданных (если её специально не подключили), поэтому её можно передавать между разными базами и организациями. Одна и та же обработка загрузки из Excel может работать и в «1С:Бухгалтерии», и в «1С:Управление торговлей», если код не привязан к специфичным объектам конкретной конфигурации.

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

Чем обработка отличается от внешнего отчёта

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

Граница условна: отчёт тоже может содержать кнопки и код, а обработка — выводить таблицы. Но при выборе инструмента ориентируйтесь на задачу. Если нужно посмотреть данные — это отчёт; если нужно что-то сделать с данными — обработка.

ПараметрВнешняя обработкаВнешний отчёт
Расширение файла.epf.erf
Основное назначениеИзменение данных, сервисные операцииПросмотр и анализ данных
Основа построенияПроизвольный код и формыСхема компоновки данных (СКД)
Типичные примерыГрупповая обработка справочников, загрузка из ExcelАнализ продаж, ведомость по складам
Риск для данныхМожет изменять и удалять объектыОбычно только читает данные

Как открыть внешнюю обработку в 1С

Самый простой способ — открыть файл напрямую из режима «Предприятие». В меню выберите «Файл → Открыть» (или нажмите Ctrl+O), укажите путь к EPF-файлу и подтвердите открытие. Обработка запустится в отдельном окне, и можно сразу с ней работать.

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

Как открыть EPF-файл
  1. 1
    Сохраните файл обработки на локальный диск, а не запускайте из почты или архива
  2. 2
    Откройте базу 1С под пользователем с минимально достаточными правами
  3. 3
    Выберите «Файл → Открыть» или нажмите Ctrl+O и укажите путь к файлу
  4. 4
    Дождитесь загрузки формы обработки и проверьте, что интерфейс соответствует описанию
  5. 5
    Перед выполнением основного действия сделайте тестовый прогон на одном объекте

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

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

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

Чтобы подключить обработку, включите флажок «Дополнительные отчеты и обработки», откройте одноимённый справочник, нажмите «Добавить из файла» и выберите EPF-файл. Система предложит указать, в каких разделах интерфейса будет доступна команда запуска, и кому из пользователей она видна. После записи обработка появится в меню «Дополнительные обработки» выбранных разделов.

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

Безопасность: что проверить перед запуском

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

Минимальный набор проверок: убедитесь, что файл получен из доверенного источника (официальный диск ИТС, известные отраслевые порталы, ваш разработчик); проверьте его антивирусом; по возможности откройте обработку в конфигураторе и просмотрите код на предмет подозрительных конструкций — отправки данных на внешние адреса, удаления объектов без условий, запуска внешних программ.

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

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

Где взять готовые обработки и когда писать свою

Готовые обработки распространяются через портал 1С:ИТС (в составе дисков и подписки), отраслевые решения партнёров 1С, сообщества разработчиков. Многие сервисные инструменты — консоль запросов, редактор объекта, поиск и замена значений — существуют в виде свободно распространяемых обработок и давно стали стандартом инструментария специалиста.

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

Откуда брать обработки

Портал 1С:ИТС

Проверенные обработки от вендора, подходят под типовые конфигурации. Требуется действующая подписка ИТС.

Разработчик или франчайзи

Обработка пишется под вашу задачу и конфигурацию. Дороже, но точное попадание в требования.

Открытые сообщества

Бесплатные универсальные инструменты. Требуют самостоятельной проверки кода и совместимости.

Собственная разработка

Полный контроль над логикой. Нужны навыки программирования на встроенном языке 1С.

Проверка результата после выполнения обработки

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

Если обработка выводит протокол (журнал выполненных действий), сохраните его. При обнаружении ошибки протокол поможет понять, какие именно объекты были затронуты, и оценить масштаб исправлений. Для критичных операций полезно провести выборочную ручную проверку: открыть 2–3 изменённых документа и убедиться, что реквизиты заполнены корректно.

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

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

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

Совпадает с ожидаемым числом из отбора

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

Обработано больше или меньше, чем попало в выборку

Значения изменённых реквизитов
Норма

Соответствуют заданному правилу на выборочных объектах

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

Пустые значения, неверные типы данных, лишние изменения

Протокол выполнения
Норма

Есть список обработанных объектов без ошибок

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

Протокола нет или в нём сообщения об ошибках

Связанные данные
Норма

Проведённые документы остались проведёнными, движения корректны

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

Нарушилась последовательность документов, слетели движения

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

Чем открыть файл EPF, если нет 1С?

Никак. Формат EPF — проприетарный, его открывает только платформа 1С:Предприятие (режим «Предприятие» или конфигуратор). Текстовые редакторы и просмотрщики покажут бинарное содержимое. Если нужно просто посмотреть код без запуска, файл открывают в конфигураторе — там доступны модули и формы без выполнения алгоритмов.

Почему обработка не подключается через «Дополнительные отчеты и обработки»?

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

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

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

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

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

Работает ли обработка из «1С:Бухгалтерии» в «1С:Управление торговлей»?

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

Как запретить пользователям запускать внешние обработки?

В клиент-серверном варианте администратор настраивает профили безопасности кластера и может запретить интерактивное открытие внешних файлов. Дополнительно ограничьте доступ к справочнику «Дополнительные отчеты и обработки» и не выдавайте пользователям права администратора без необходимости.

Итог

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

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