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

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

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

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

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

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

Ниже разобраны оба сценария для управляемого приложения (1С:Предприятие 8.3, конфигурации на БСП — «Управление торговлей», «Бухгалтерия предприятия», «ERP» и другие), а также варианты для тонкого клиента, веб-клиента и случаев, когда стандартный механизм в конфигурации отключен.

Что такое внешняя обработка и когда её устанавливать

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

Типичные сценарии использования: загрузка номенклатуры из Excel, групповое изменение реквизитов, дополнительные печатные формы документов, сверка данных, выгрузка в форматы контрагентов. Устанавливать обработку стоит, когда функция нужна регулярно и ей пользуются несколько сотрудников. Для разовой операции регистрация в базе не обязательна.

Проверка перед установкой: источник, права и совместимость

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

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

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

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

Это основной способ для постоянной работы. Порядок действий в типовых конфигурациях на БСП (УТ 11, ERP, БП 3.0, ЗУП):

Порядок подключения обработки
  1. 1
    Откройте «Администрирование → Печатные формы, отчеты и обработки».
  2. 2
    Включите флажок «Дополнительные отчеты и обработки», если он снят.
  3. 3
    Перейдите по ссылке «Дополнительные отчеты и обработки».
  4. 4
    Нажмите «Добавить из файла» и выберите EPF-файл.
  5. 5
    Подтвердите предупреждение безопасности, если файл из надёжного источника.
  6. 6
    В карточке обработки проверьте «Размещение» — разделы, где она появится.
  7. 7
    Нажмите «Записать и закрыть» и проверьте запуск из раздела «Дополнительные обработки».

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

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

Разовый запуск без установки в базу

Если обработка нужна один раз или вы хотите её протестировать, регистрировать её в базе не обязательно. Откройте меню «Файл → Открыть» (в тонком клиенте также работает сочетание Ctrl+O), выберите EPF-файл и подтвердите открытие. Обработка запустится сразу, но после закрытия сеанса никаких следов в базе не останется.

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

Особенности для разных клиентов и режимов

Тонкий клиент и веб-клиент

В тонком клиенте установка выполняется так же, как в толстом: через справочник дополнительных обработок. В веб-клиенте добавление файла тоже поддерживается, но сам файл при этом загружается на сервер и хранится в информационной базе — пользователям не нужен доступ к исходному EPF-файлу после установки.

Файловая и клиент-серверная база

В файловой базе обработка хранится внутри файла базы и доступна всем, кто с ней работает. В клиент-серверном варианте хранение аналогично — в базе данных на сервере СУБД. Разница проявляется в правах: в серверном варианте чаще действует разграничение ролей, и рядовой пользователь может не иметь права добавлять обработки.

Безопасный режим и профили безопасности

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

Способы запуска обработки

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

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

Справочник дополнительных обработок

Постоянная установка для всех пользователей с выбором разделов интерфейса. Требует прав на добавление и работающей подсистемы БСП.

Расширение конфигурации

Альтернатива, если нужно менять поведение типовых объектов. Устанавливается через «Конфигурация → Расширения конфигурации», требует аккуратности при обновлениях.

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

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

Типичные ошибки
01
Обработка не добавляется с сообщением «не является дополнительной обработкой» — файл написан без поддержки БСП; запускайте его через «Файл → Открыть».
02
Обработка установлена, но пользователи её не видят — не заполнено размещение в разделах или у пользователей нет права «Выполнение дополнительных обработок».
03
Ошибка при выполнении в безопасном режиме — обработке нужен доступ к файлам или COM-объектам; настройте профиль безопасности вместо отключения защиты глобально.
04
Установлена обработка от другой конфигурации — команды открываются, но падают с ошибкой обращения к несуществующим объектам метаданных.
05
Отключена защита от опасных действий ради сомнительного файла — прямой риск порчи данных и утечки информации.
Контрольные точки

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

Обработка в списке
Норма

Есть в справочнике дополнительных обработок, флажок публикации установлен

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

Записи нет или она помечена на удаление

Видимость для пользователя
Норма

Команда появилась в указанном разделе под обычной учетной записью

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

У администратора видна, у пользователя — нет: проблема с правами или размещением

Запуск
Норма

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

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

Ошибки о безопасном режиме или отсутствующих объектах метаданных

Как обновить или удалить обработку

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

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

Итог

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

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

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

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

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

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

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

Почему обработка работает у меня, но не у коллеги?

Чаще всего причина в правах: у коллеги нет права на выполнение дополнительных отчетов и обработок либо обработка обращается к объектам, к которым у него закрыт доступ. Вторая причина — размещение: команда не добавлена в разделы, которыми пользуется коллега.

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

Отключение защиты снимает предупреждения при запуске любого кода, поэтому делать это глобально не рекомендуется. Если проверенной обработке нужен доступ к файлам или COM-объектам, правильный путь — настроить профиль безопасности конкретно для неё, а не отключать защиту целиком.

Обработка не добавляется: «файл не является дополнительным отчетом или обработкой». Что делать?

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

Нужно ли заново устанавливать обработку после обновления конфигурации?

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