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