К статье
Практический материал

Администрирование · 11 мин

Как подгрузить обработку в 1С

Как подгрузить внешнюю обработку в 1С: открытие epf-файла, подключение через дополнительные отчеты и обработки, настройка прав и решение типичных ошибок.

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

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

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

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

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

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

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

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

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

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

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

Способ 2: регистрация в дополнительных отчетах и обработках

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

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

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

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

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

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

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

Отдельно обратите внимание на флаг «Безопасный режим» в карточке обработки. В безопасном режиме коду запрещены операции с файловой системой, COM-объектами, внешними компонентами и запуском приложений. Для обработок, которые только читают и записывают данные базы, безопасный режим желательно оставлять включенным. Отключайте его только если обработке объективно нужен доступ к файлам (например, загрузка из Excel) и вы доверяете её коду.

Проверка результата и типичные ошибки

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

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

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

Обработка в разделе
Норма

Видна в списке дополнительных обработок выбранного раздела

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

Отсутствует — проверьте размещение и права пользователя

Запуск
Норма

Форма открывается без ошибок, операция выполняется

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

Ошибка при открытии — несовместимость версии или режима

Печатная форма
Норма

Новый пункт в меню «Печать» документа

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

Пункта нет — не указаны объекты назначения

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

Типичные ошибки
01
Регистрация обработки без включения опции «Дополнительные отчеты и обработки» — справочник просто не виден в интерфейсе
02
Попытка зарегистрировать файл, не написанный по стандарту БСП — программа отказывает в добавлении, такой файл открывают только через Файл → Открыть
03
Забытые объекты назначения у печатной формы — обработка есть в базе, но не появляется ни в одном документе
04
Отключенный безопасный режим для непроверенной обработки — риск повреждения данных
05
Тестирование новой обработки сразу на рабочей базе вместо копии — ошибки приходится исправлять восстановлением из резервной копии

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

Обновление, замена и удаление обработки

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

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

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

Часто задаваемые вопросы

Можно ли подгрузить обработку в 1С без прав администратора?

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

Почему при добавлении файла появляется сообщение, что обработка не предназначена для подключения?

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

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

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

Обработка работала, а после обновления конфигурации перестала. Что делать?

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

Как подгрузить обработку в 1С:Предприятие 7.7?

В версии 7.7 внешние обработки имеют расширение .ert и открываются через «Файл → Открыть». Распространенные обработки размещают в папке ExtForms каталога базы — тогда они доступны из меню «Сервис → Дополнительные возможности». Механизма регистрации, как в 8.3, в этой версии нет.

Безопасно ли отключать предупреждение при открытии внешних обработок?

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

Итог

Что важно запомнить

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