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