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