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

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

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

Как подключить внешнюю обработку в 1С 8: запуск через Файл → Открыть, регистрация в справочнике дополнительных отчетов и обработок, типичные ошибки и решения.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Настройка прав и публикация для пользователей

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

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

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

Безопасность: профили безопасности и проверка файлов

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

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

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

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

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

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

Типичные ошибки
01
Регистрация обработки без настройки размещения — команда нигде не появляется, и кажется, что подключение не сработало
02
Попытка зарегистрировать обработку без функции СведенияОВнешнейОбработке — справочник БСП отказывается её принимать
03
Запуск обработки, изменяющей данные, без резервной копии — при ошибке в коде восстановить данные будет нечем
04
Игнорирование предупреждения безопасности для файла из неизвестного источника — риск выполнения вредоносного кода в базе

Проверка результата и отзыв подключения

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

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

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

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

Видимость команды
Норма

Кнопка или пункт меню появился в нужном разделе или документе у целевого пользователя

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

Команда видна только администратору или отсутствует вовсе

Результат выполнения
Норма

Обработка завершается без ошибок, данные соответствуют ожиданиям

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

Ошибки выполнения, частичные или неверные изменения данных

Влияние на базу
Норма

После работы обработки смежные отчёты и документы не изменились

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

Появились неожиданные движения, пометки удаления или изменённые документы

Частые вопросы о подключении внешних обработок

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

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

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

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

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

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

Как подключить внешнюю печатную форму к конкретному документу?

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

Работают ли обработки от 1С 8.2 в версии 8.3?

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

Нужно ли останавливать работу пользователей для подключения обработки?

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