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

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

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

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

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

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

В тонком клиенте и веб-клиенте порядок тот же, но в веб-клиенте браузер может запросить разрешение на доступ к файловой системе. Работа с локальными файлами в веб-клиенте требует установки расширения для работы с файлами — без него диалог выбора файла не откроется.

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

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

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

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

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

Программное открытие обработки

Когда обработку нужно запустить из другого кода — например, из регламентного задания, кнопки на форме или внешнего отчёта — используются методы объекта ВнешниеОбработки. На сервере обработку создают методом Создать(), передав полный путь к файлу.

Обработка = ВнешниеОбработки.Создать("C:\Обработки\ЗагрузкаДанных.epf", Ложь);
Обработка.ВыполнитьЗагрузку();

Второй параметр метода Создать() определяет безопасный режим: Истина запрещает обработке опасные операции (запуск приложений, доступ к файловой системе вне временных каталогов). Для доверенных файлов указывайте Ложь, для сторонних — Истина или профиль безопасности.

Чтобы открыть форму внешней обработки на клиенте в управляемом приложении, используйте метод ПолучитьФорму() с указанием полного пути: ВнешниеОбработки.ПолучитьФорму("C:\Обработки\Файл.epf"). Учтите, что путь должен быть доступен с того компьютера, где выполняется код: при серверном вызове — с сервера 1С, при клиентском — с рабочей станции пользователя.

Открытие в конфигураторе для просмотра и отладки

Если нужно не выполнить обработку, а посмотреть или изменить её код, откройте файл в конфигураторе: «Файл» → «Открыть» и выберите .epf. Обработка откроется как отдельный объект с деревом метаданных: формы, макеты, модуль объекта. Здесь же можно поставить точки останова и запустить отладку — обработка подключится к сеансу отладки как обычный объект конфигурации.

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

Права доступа и безопасность

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

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

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

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

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

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

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

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