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

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

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

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

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

Типовые задачи, которые решают внешними обработками: загрузка номенклатуры и цен из Excel, групповое изменение реквизитов документов, поиск и удаление дублей, перенос данных между базами, тестирование запросов. Многие такие инструменты поставляются на диске ИТС или пишутся программистом под конкретную задачу.

Как запустить обработку через меню «Файл → Открыть»

Это универсальный способ, работающий в любой конфигурации — от «Бухгалтерии» до «Управления торговлей». В 1С:Предприятии 8.3 откройте главное меню (кнопка с оранжевым логотипом в левом верхнем углу), выберите «Файл → Открыть» или нажмите Ctrl+O. В диалоге выбора укажите файл .epf и подтвердите открытие.

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

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

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

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

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

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

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

Способы запуска: что выбрать

Файл → Открыть

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

Дополнительные отчеты и обработки

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

Запуск из конфигуратора

Подходит разработчику для отладки: Файл → Открыть в конфигураторе, затем запуск из режима отладки. Обычным пользователям недоступен.

Настройка прав и безопасности

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

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

Запуск в клиент-серверном варианте и на веб-клиенте

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

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

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

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

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

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

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

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

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

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

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

Норма

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

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

Часть строк пропущена без сообщений об ошибках

Данные в созданных документах

Норма

Суммы, даты и контрагенты совпадают с источником при выборочной сверке

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

Сдвинуты даты, пустые реквизиты, дубли документов

Отчёт об ошибках обработки

Норма

Пустой или содержит объяснимые пропуски (например, не найден контрагент)

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

Массовые ошибки доступа или «объект не найден»

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

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

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

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

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

Почему кнопка «Открыть» не находит файл .epf?

Проверьте фильтр типа файлов в диалоге открытия — установите «Все файлы» или «Внешние обработки (*.epf)». Также убедитесь, что файл не заблокирован Windows после скачивания: в свойствах файла нажмите «Разблокировать», если такая кнопка есть.

Опасно ли запускать обработки из интернета?

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

Обработка требует отключить модальность и защиту — это нормально?

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

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

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