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

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

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

Главный риск при работе с внешними обработками — безопасность. Файл .epf содержит исполняемый код на встроенном языке 1С, который может изменять или удалять данные. Поэтому перед подключением важно проверять источник файла и понимать, что именно он делает. Ниже разобраны оба способа подключения, настройка прав, проверка результата и типичные ошибки.

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

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

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

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

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

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

Учтите ограничение разового способа: после закрытия сеанса обработку придётся открывать заново, а другие пользователи базы её не увидят. Для регулярной работы правильнее зарегистрировать обработку в справочнике дополнительных отчётов и обработок.

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

Как подключить обработку через «Дополнительные отчеты и обработки»

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

Откройте одноимённый справочник и создайте новый элемент. По кнопке загрузки выберите файл .epf. Если обработка написана по стандарту БСП, она сама сообщит сведения о себе: название, версию, вид (печатная форма, заполнение объекта, создание связанных объектов, отчёт) и назначение — для каких документов или справочников она применяется. Эти данные подставятся автоматически, останется записать элемент.

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

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

По умолчанию загружать дополнительные отчёты и обработки могут только пользователи с правами администратора. Обычным пользователям доступно лишь выполнение уже зарегистрированных обработок. Это осознанное ограничение: право загрузки исполняемого кода в базу нельзя раздавать широко.

Для каждой зарегистрированной обработки можно настроить «Быстрый доступ» — список пользователей или групп, которым видна команда. Это удобно, когда печатная форма нужна только менеджерам по продажам, а кадровая обработка — только отделу кадров. Настройка выполняется в карточке элемента справочника на вкладке быстрого доступа.

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

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

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

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

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

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

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

Форма обработки открылась

Норма

Форма отображается, поля и кнопки доступны

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

Ошибка «Метод объекта не обнаружен» или пустое окно — обработка несовместима с версией конфигурации

Выполнение операции

Норма

Сообщение о количестве обработанных объектов, журнал регистрации без ошибок

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

Ошибки в журнале регистрации, часть объектов пропущена

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

Норма

Контрольные объекты содержат ожидаемые значения

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

Значения не изменились или изменились неверно — откатите из резервной копии

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

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

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

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

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

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

Обработка или расширение

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

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

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

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

Доработка в конфигураторе

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

FAQ: частые вопросы о внешних обработках

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

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

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

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

Почему обработка просит отключить безопасный режим?

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

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

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

Влияют ли внешние обработки на обновление конфигурации?

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

Кто в организации должен подключать внешние обработки?

Загрузку файлов в базу должен выполнять администратор 1С или ответственный специалист с соответствующими правами. Рядовым пользователям достаточно права запуска уже зарегистрированных обработок. Такое разграничение защищает базу от случайного запуска вредоносного или некорректного кода.