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