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