Как добавить внешние обработки в 1С

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

Способ подключения зависит от режима работы конфигурации. В типовых решениях на управляемых формах (Бухгалтерия 3.0, Управление торговлей 11, ЗУП 3.1, ERP) используется механизм «Дополнительные отчеты и обработки». В конфигурациях на обычных формах (например, старые редакции УТ 10.3) применяется справочник «Внешние обработки». В обоих случаях потребуются права администратора или специальная роль.

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

Что такое внешняя обработка и когда её регистрировать в базе

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

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

Подготовка: включение механизма и проверка прав

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

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

Добавление обработки в типовой конфигурации (БСП)

Основной сценарий для Бухгалтерии 3.0, УТ 11, ЗУП 3.1 и других решений на библиотеке стандартных подсистем выглядит так:

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

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

Поле «Публикация» управляет видимостью: «Используется» делает обработку доступной пользователям, «Отключена» скрывает её без удаления, режим отладки показывает обработку только указанным пользователям. Это удобно для тестирования новой версии: опубликуйте её только себе, проверьте работу и затем переведите в общий режим.

Настройка размещения, команд и прав доступа

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

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

Добавление в конфигурации на обычных формах

В старых конфигурациях (Управление торговлей 10.3, УПП 1.3) используется справочник «Внешние обработки», который обычно находится в разделе «Сервис» или «Настройка». Создайте новый элемент справочника, укажите файл обработки, вид (дополнительная печатная форма, обработка заполнения табличных частей, произвольная) и при необходимости привязку к объектам базы через табличную часть «Принадлежность».

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

Быстрый запуск без регистрации и безопасный режим

Если обработка нужна один раз, откройте её через меню «Файл → Открыть» и выберите файл .epf. Этот способ не сохраняет обработку в базе — при следующем запуске файл нужно открывать заново. Он подходит для сервисных операций, выполняемых администратором вручную, и не требует включения механизма дополнительных отчетов.

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

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

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

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

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

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

Видимость в интерфейсе

Норма

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

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

Обработка есть в списке, но пользователь её не видит — проверьте размещение и права

Запуск

Норма

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

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

Ошибка «Нарушение прав доступа» — у пользователя нет прав на данные, которые обрабатывает код

Безопасность

Норма

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

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

Обработка требует отключить защиту или безопасный режим без понятной причины

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

Обработка добавлена, но пользователи её не видят. Что проверить?

Три причины встречаются чаще всего: не заполнено размещение в карточке обработки, публикация установлена в режим «Отключена» или отладки, а также отсутствие у пользователя роли «Выполнение дополнительных отчетов и обработок». Проверьте эти три пункта последовательно.

Можно ли запускать внешнюю обработку по расписанию?

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

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

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

Безопасно ли отключать защиту от опасных действий?

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

Обработка работала, а после обновления конфигурации перестала. Почему?

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

Можно ли добавить обработку в файловую базу без конфигуратора?

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