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

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

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

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

Что проверить перед запуском обработки

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

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

Способ 1. Открыть обработку через меню «Файл»

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

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

В старых конфигурациях на обычных формах (например, «Управление торговлей 10.3», «Бухгалтерия 2.0») путь тот же: «Файл → Открыть», но запускаться должны обработки, созданные именно для обычного приложения. Если у вас файл .epf открывается пустым окном — скорее всего, он написан под другой режим запуска.

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

Способ 2. Подключить через «Дополнительные отчеты и обработки»

Для регулярной работы правильнее подключить обработку в штатный механизм БСП (библиотеки стандартных подсистем), который встроен в большинство типовых конфигураций. Тогда обработка появится в интерфейсе пользователей как обычная команда, не потребует доступа к файловой системе и будет запускаться в контролируемом режиме.

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

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

Настройка прав и отключение защиты от опасных действий

Если при открытии файла появляется сообщение «Интерактивные операции недоступны» или обработка не открывается вовсе, причина почти всегда в правах. Открытие внешних файлов регулируется правом «Интерактивное открытие внешних обработок» (и аналогичным для отчетов). Проверьте в конфигураторе или через администратора, что у вашей роли это право установлено.

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

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

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

Для автоматического запуска по расписанию (например, ночная выгрузка данных) используют регламентные задания. Внешнюю обработку подключают как дополнительную, а затем настраивают задание через консоль заданий или штатный механизм «Поиск и удаление дублей»-подобных инструментов БСП, если обработка поддерживает серверный вызов. Альтернатива — запуск через командную строку платформы с параметром /Execute, но этот способ требует аккуратной настройки и обычно используется администраторами.

"C:\Program Files\1cv8\<версия>\bin\1cv8.exe" ENTERPRISE /F"D:\Bases\MyBase" /N"Пользователь" /P"Пароль" /Execute"D:\Обработки\Выгрузка.epf"

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

Наиболее частая проблема — «Ошибка при вызове метода контекста» сразу после открытия. Обычно это означает, что обработка обращается к объекту метаданных, которого нет в вашей конфигурации: например, к документу «ЗаказКлиента» в базе «Бухгалтерии», где такого документа нет. Лечения на стороне пользователя нет — нужна версия обработки под вашу конфигурацию.

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

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

После выполнения обработки, изменяющей данные, обязательно проведите контрольную проверку. Минимальный набор: сравните количество обработанных объектов с ожидаемым (многие обработки выводят отчет о выполнении — сохраните его), откройте несколько измененных документов или элементов справочника вручную и убедитесь, что значения корректны, проверьте связанные отчеты — например, оборотно-сальдовую ведомость, если менялись проводки.

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

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