Как подключить внешнюю обработку в 1С:Бухгалтерия

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

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

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

Проверка перед подключением: что должно быть готово

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

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

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

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

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

1. 1
   Откройте «Администрирование — Печатные формы, отчеты и обработки»
2. 2
   Установите флажок «Дополнительные отчеты и обработки»
3. 3
   Перейдите по ссылке «Дополнительные отчеты и обработки»
4. 4
   Нажмите «Создать» и выберите файл .epf через команду загрузки из файла
5. 5
   Подтвердите предупреждение безопасности и запишите элемент
6. 6
   Проверьте команду запуска в разделе, указанном в настройках размещения

Регистрация обработки в справочнике

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

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

Настройка размещения и быстрого доступа

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

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

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

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

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

Одноразовый запуск без регистрации

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

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

Сравнение вариантов

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

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

Открытие через «Файл — Открыть»

Подходит для разовых сервисных задач и тестирования. Не требует настройки, но команда не встраивается в документы и разделы.

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

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

Проверка результата и обновление версии обработки

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

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

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

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

Команда в интерфейсе

Норма

Команда видна в разделе или документе, указанном в размещении

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

Команды нет ни в одном разделе — проверьте размещение и быстрый доступ

Запуск обработки

Норма

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

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

Ошибка при открытии — несовместимость с релизом конфигурации или платформы

Видимость у пользователей

Норма

У всех сотрудников с нужными правами команда отображается

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

Видна только администратору — не хватает прав или настройки быстрого доступа

Безопасный режим

Норма

Снят только при реальной необходимости и для доверенной обработки

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

Снят у всех обработок подряд «на всякий случай»

Ответы на частые вопросы

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

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

Обработка подключается, но при запуске выдает ошибку «Метод объекта не обнаружен». Что делать?

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

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

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

Нужно ли снимать конфигурацию с поддержки для подключения внешней обработки?

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

Почему обработку видит администратор, а бухгалтер — нет?

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

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

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