Разработка и Конфигурация · 9 мин
Как добавить дополнительную обработку в 1С
Как подключить внешнюю обработку в 1С через БСП и вручную: права, безопасный режим, регистрация команд, проверка результата и типичные ошибки.
Дополнительные (внешние) обработки позволяют расширить функциональность 1С без изменения конфигурации: добавить кнопку массовой обработки документов, печатную форму, заполнение табличной части или отчёт. Это безопаснее доработки типовой конфигурации, потому что обновление релиза не затрагивает внешние файлы, а отключить неудачную обработку можно в один клик.
Существует три рабочих сценария: подключение через типовой механизм «Дополнительные отчеты и обработки» (он есть в большинстве конфигураций на БСП — «Управление торговлей», «Бухгалтерия предприятия», «ERP»), ручное открытие файла обработки через меню «Файл — Открыть» и добавление обработки прямо в конфигуратор. Выбор зависит от того, есть ли в вашей конфигурации подсистема БСП и нужна ли обработка постоянно или разово.
Ниже разобраны все три способа с точными действиями, условиями применимости и проверками результата, а также ограничения безопасного режима и типичные ошибки, из-за которых обработка «не появляется» в интерфейсе.
Способ 1. Подключение через «Дополнительные отчеты и обработки» (БСП)
Это основной и рекомендуемый способ для типовых конфигураций. Сначала убедитесь, что механизм включён: откройте «Администрирование → Печатные формы, отчеты и обработки» и установите флажок «Дополнительные отчеты и обработки». Если флажок недоступен — у вашей учётной записи нет права «Добавление дополнительных отчетов и обработок», его должен выдать администратор.
Далее перейдите по появившейся ссылке «Дополнительные отчеты и обработки», нажмите «Добавить из файла» и выберите файл с расширением .epf (обработка) или .erf (отчёт). Программа покажет карточку регистрации: вид обработки, версию, команды и размещение — разделы интерфейса, где появится кнопка.
Проверьте размещение: типовая обработка сама указывает, в каких разделах и для каких объектов она работает, но вы можете скорректировать список. После нажатия «Записать и закрыть» команда появится в указанных разделах — обычно в меню «Дополнительные обработки» на форме списка или объекта.
- 1Включите флажок «Дополнительные отчеты и обработки» в разделе «Администрирование»
- 2Откройте список дополнительных обработок и нажмите «Добавить из файла»
- 3Выберите файл .epf или .erf и подтвердите предупреждение безопасности
- 4Проверьте размещение команд в карточке обработки
- 5Запишите и откройте раздел, где должна появиться команда
Если обработка требует отключения безопасного режима
По умолчанию дополнительные обработки выполняются в безопасном режиме: им запрещён доступ к файловой системе, COM-объектам и внешним компонентам. Если обработка читает файлы Excel или обращается к внешним сервисам, она может не работать. В карточке обработки есть флажок «Отключить безопасный режим» — включайте его только для обработок из доверенного источника, предварительно просмотрев код.
Способ 2. Разовый запуск через «Файл — Открыть»
Если обработка нужна один раз — например, для загрузки данных или тестирования — регистрировать её в справочнике не обязательно. В клиентском приложении откройте «Файл → Открыть», выберите файл .epf и подтвердите запуск. Обработка откроется как обычная форма и будет работать, пока её не закроют.
У этого способа есть ограничения: команда не появится в интерфейсе других пользователей, настройки размещения недоступны, а в тонком и веб-клиенте часть обработок, написанных под обычные формы, просто не запустится. Способ подходит для проверки обработки перед постоянным подключением.
Способ 3. Добавление обработки в конфигуратор
Когда обработка должна стать постоянной частью решения с собственной кнопкой в командном интерфейсе, её добавляют в состав конфигурации. Откройте конфигуратор, в дереве конфигурации найдите ветку «Обработки», вызовите контекстное меню и выберите «Добавить». Затем через «Действия → Загрузить из файла» подмените пустую обработку готовым файлом .epf.
После этого задайте синоним (отображаемое имя) и при необходимости добавьте обработку в подсистемы — тогда ссылка на неё появится в панели разделов. Сохраните конфигурацию и обновите конфигурацию базы данных (клавиша F7).
Учтите риск: изменённая конфигурация частично снимается с поддержки, и при обновлении типового релиза добавленные объекты могут потребовать ручного сопоставления. Для типовых конфигураций способ через БСП почти всегда предпочтительнее.
Как выбрать подходящий способ
Выбор зависит от трёх условий: наличия БСП, частоты использования и количества пользователей. Разовая задача для одного специалиста решается открытием файла, регулярная работа нескольких сотрудников — регистрацией в справочнике дополнительных обработок, а глубокая интеграция с интерфейсом — доработкой конфигурации.
Как выбрать способ
Проверка результата после подключения
После регистрации обработки проверьте три вещи: команда видна в заявленном разделе, обработка запускается без ошибок, результат её работы корректен. Откройте раздел, указанный в размещении, найдите кнопку в меню «Дополнительные обработки» (для форм списка и объектов) или в панели навигации раздела.
Запустите обработку на тестовых данных: например, обработку заполнения табличной части проверяйте на копии документа, а не на реальном проведённом. Если обработка изменяет данные, убедитесь, что изменения соответствуют ожиданиям и не затронули лишние объекты.
Как проверить результат
Кнопка есть в меню «Дополнительные обработки» нужного раздела
Команды нет — проверьте размещение и права пользователя
Форма открывается без сообщений об ошибках
Ошибка компиляции или «метод не обнаружен» — обработка не совместима с конфигурацией
Изменены только целевые объекты, данные корректны
Затронуты лишние документы или данные искажены — откатите из копии
Типичные ошибки и ограничения
Чаще всего пользователи сталкиваются с тем, что обработка «не появляется» после подключения. Причины почти всегда одни и те же: не заполнено размещение в карточке, у пользователя нет прав на выполнение дополнительных обработок, либо обработка назначена конкретному виду объектов (например, только документам «Реализация товаров»), а её ищут в другом месте.
Вторая группа проблем — несовместимость: обработка писалась под другую конфигурацию и обращается к объектам, которых в вашей базе нет, либо использует обычные формы в управляемом приложении. В этом случае поможет только адаптация кода разработчиком.
Часто задаваемые вопросы
Чем файл .epf отличается от .erf?
Файл .epf — это внешняя обработка (произвольные действия с данными), а .erf — внешний отчёт, построенный на системе компоновки данных. Оба подключаются одним и тем же механизмом «Дополнительные отчеты и обработки», различается только назначение.
Почему кнопка «Добавить из файла» недоступна?
Скорее всего, у вашей учётной записи нет права «Добавление дополнительных отчетов и обработок» либо не включён сам функциональный опция в разделе «Администрирование». Обратитесь к администратору базы для выдачи права.
Можно ли подключить обработку сразу для всех пользователей?
Да. Обработка, зарегистрированная в справочнике дополнительных обработок, доступна всем пользователям, у которых есть право на выполнение дополнительных обработок и доступ к разделам, указанным в размещении. Отдельных настроек для каждого сотрудника не требуется.
Обработка выдаёт ошибку «Метод объекта не обнаружен». Что делать?
Это означает, что обработка обращается к объекту или процедуре, отсутствующим в вашей конфигурации или версии платформы. Самостоятельно это не исправить — нужен разработчик, который адаптирует код под вашу конфигурацию.
Нужно ли отключать обработку перед обновлением конфигурации?
Нет, внешние обработки хранятся в справочнике базы и обновление конфигурации их не удаляет. Но после обновления стоит проверить работоспособность обработки: в новом релизе могли измениться объекты, к которым она обращается.
Что важно запомнить
Основной способ подключения — механизм «Дополнительные отчеты и обработки» в разделе «Администрирование»: добавьте файл, проверьте размещение и права. Разовые задачи решайте через «Файл → Открыть», в конфигуратор лезьте только при необходимости глубокой интеграции. Перед первым запуском любой обработки сделайте резервную копию и проверьте источник файла.