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