Внешняя обработка в 1С 8.3: три способа подключить

Чтобы подключить внешнюю обработку в 1С 8.3 через типовой механизм, зайдите в Администрирование → Печатные формы, отчёты и обработки → Дополнительные отчёты и обработки, нажмите Создать → Загрузить из файла и укажите файл с расширением .epf. Если обработку нужно запустить разово, её проще открыть напрямую: меню Файл → Открыть и выбор того же .epf.

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

Чем отличаются способы подключения

Внешняя обработка хранится в файле .epf, внешний отчёт — в .erf. Это скомпилированный объект с собственными формами, модулями и реквизитами. Он не входит в конфигурацию и не требует её изменения, поэтому обновление базы такие файлы не затрагивает.

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

Подготовка файла перед загрузкой

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

• 📄 Расширение. Обработка — .epf, отчёт — .erf. Файл с расширением .cf, .cfe или .dt сюда не относится: это конфигурация, расширение и выгрузка базы соответственно.
• 🧩 Назначение. Уточните у автора, рассчитана ли обработка на вашу конфигурацию (БП 3.0, ЗУП 3.1, УТ 11 и т. д.). Обработка, использующая процедуры конкретной конфигурации, в чужой базе выдаст ошибку при запуске.
• 💾 Источник. Запускайте только файлы из доверенного источника. Внешняя обработка выполняет произвольный код с правами текущего пользователя — чужой непроверенный .epf опасен так же, как любой исполняемый файл.

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

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

Это основной способ для постоянной работы. Он есть в конфигурациях на Библиотеке стандартных подсистем — БП 3.0, ЗУП 3.1, УТ 11, КА, ERP и других.

Сначала включите саму возможность, если раздел не виден:

1. Откройте Администрирование → Печатные формы, отчёты и обработки.
2. Установите флажок Дополнительные отчёты и обработки.

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

1. В списке нажмите Создать.
2. В окне выбора укажите файл .epf на диске (Загрузить из файла).
3. 1С прочитает служебную информацию из файла и заполнит карточку: наименование, вид, версию. Не меняйте вид обработки вручную — он берётся из самого файла.
4. В поле Размещение выберите разделы командного интерфейса, где должна появиться команда запуска.
5. Проверьте, что в поле Публиковать стоит значение Используется.
6. Нажмите Записать и закрыть.

Команда запуска появится там, где вы указали размещение. Как правило, это пункт в группе Дополнительные обработки нужного раздела.

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

Виды обработок и привязка к объектам

Вид обработки платформа определяет сама — по тому, как она устроена внутри. От вида зависит, где именно появится команда.

• Дополнительная обработка — запускается как самостоятельная команда из раздела интерфейса.
• Заполнение объекта — добавляет кнопку в форму документа или элемента справочника, чтобы заполнить его по своим правилам.
• Создание связанных объектов — формирует на основании открытого документа другие объекты.
• Печатная форма — встраивается в меню печати документа.
• Отчёт — открывается как внешний отчёт из списка.

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

Если команду после загрузки не видно, проверьте две вещи: заполнено ли Размещение и стоит ли статус Используется. Пустое размещение — самая частая причина «обработка загрузилась, а её нигде нет».

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

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

1. Меню Файл → Открыть (или сочетание Ctrl+O).
2. Выберите файл .epf.
3. Откроется основная форма обработки — работайте с ней как с обычной.

Ограничения способа:

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

Запуск и доработка в Конфигураторе

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

Отсюда доступны:

• редактирование форм и модулей;
• отладка (для этого обработку запускают из Конфигуратора при включённой отладке в параметрах);
• сохранение изменённого файла обратно в .epf через Файл → Сохранить.

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

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

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

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

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

Профили безопасности (клиент-серверный вариант). На сервере 1С действие внешнего кода дополнительно регулируется профилями безопасности кластера. Если профиль безопасности для информационной базы настроен, обработка сможет выполнять только то, что в профиле разрешено. Настройка профилей — задача администратора сервера; она делается в консоли администрирования или утилитой rac (смотрите справку rac help).

Коротко о распределении ролей:

• 🔑 Загрузка новой обработки — администратор.
• 👁 Запуск подключённой обработки — пользователь с правом использования.
• 🛡 Отключение безопасного режима и профили — осознанное решение администратора, только для проверенного кода.

Совместимость версий и что делать, если не подключается

Внешняя обработка несёт в себе номер версии платформы, на которой её сохранили. Правило простое: файл открывается на платформе, номер которой не ниже того, что указан в обработке. Обработку из новой платформы на старой вы не откроете; наоборот — обычно работает.

Второй слой совместимости — конфигурация. Если обработка вызывает процедуры конкретной конфигурации (например, функции БСП определённой версии), то в базе со старой или другой конфигурацией она запустится, но упадёт с ошибкой при обращении к отсутствующему методу.

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

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

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