Администрирование · 11 мин
Файл EPF в 1С 8.3: как установить и открыть внешнюю обработку
Как установить и открыть файл EPF в 1С 8.3: через Файл — Открыть и подключение в справочнике дополнительных отчетов и обработок, настройка прав.
Файл с расширением EPF — это внешняя обработка 1С: скомпилированный модуль, который добавляет в программу функции, отсутствующие в типовой конфигурации. Это может быть загрузка данных из Excel, печатная форма документа, обработка для группового изменения реквизитов или инструмент администратора. Установить такой файл в 1С 8.3 можно двумя способами: просто открыть его на время работы или подключить постоянно через механизм дополнительных отчетов и обработок.
Выбор способа зависит от задачи. Если обработка нужна один раз — например, чтобы выгрузить данные или исправить ошибку в документе, — достаточно открыть файл через меню. Если обработкой будут пользоваться регулярно и несколько сотрудников, её правильно зарегистрировать в информационной базе: тогда она появится в интерфейсе как штатная команда и будет доступна по расписанию или из конкретных документов.
Ниже разобраны оба варианта с точными шагами, настройкой прав, типичными ошибками и проверкой результата. Инструкции актуальны для платформы 1С:Предприятие 8.3 в режиме управляемого приложения — так работают Бухгалтерия 3.0, Управление торговлей 11, ЗУП 3.1 и другие современные конфигурации.
Что такое файл EPF и когда он нужен
EPF (External Data Processor) — внешняя обработка, созданная в конфигураторе 1С и сохранённая отдельным файлом. Внутри находится программный код на встроенном языке 1С, формы и макеты. В отличие от расширения конфигурации (файл CFE), обработка не изменяет структуру базы и не требует обновления конфигурации: её можно запустить в любой момент без монопольного доступа.
Типичные сценарии использования EPF: загрузка прайсов и выписок из Excel или CSV, универсальные отчеты, консоль запросов для разработчика, групповая обработка документов, перенос данных между базами, нестандартные печатные формы. Многие обработки публикуются на портале 1С:Инфрастарт и в отраслевых сообществах.
Важно отличать EPF от ERF — это внешний отчет. Технически они устанавливаются одинаково, разница только в назначении: отчет предназначен для вывода данных, обработка — для действий над данными. Все шаги из этой статьи применимы к обоим форматам.
Как открыть EPF для разового запуска
Самый быстрый способ — открыть файл напрямую. Обработка запустится в текущем сеансе, но после закрытия окна нигде не сохранится: при следующем запуске файл придётся открывать заново. Этот способ подходит для разовых операций и для проверки обработки перед постоянной установкой.
- 1Сохраните EPF-файл в папку, доступную с компьютера или сервера, где работает клиент 1С.
- 2Запустите 1С:Предприятие и войдите в нужную информационную базу.
- 3Откройте главное меню (кнопка с оранжевым треугольником слева вверху) и выберите «Файл» — «Открыть».
- 4Укажите путь к EPF-файлу и нажмите «Открыть».
- 5При появлении предупреждения безопасности подтвердите запуск кнопкой «Да», если источнику файла доверяете.
- 6Дождитесь открытия окна обработки и выполните нужные действия.
Если команда «Файл — Открыть» недоступна или файл не открывается, причина обычно в правах пользователя или в настройках безопасности — об этом ниже. В файловой базе файл должен лежать на диске того компьютера, где запущен толстый или тонкий клиент; в клиент-серверном варианте — на машине клиента, а не на сервере 1С.
Признак успешного запуска — появилось окно обработки с её интерфейсом (кнопки, поля, таблицы). Если окно открылось пустым или сразу возникла ошибка «Метод объекта не обнаружен», вероятно, обработка написана под другую конфигурацию или режим совместимости.
Как установить EPF постоянно через дополнительные отчеты и обработки
Для регулярной работы обработку регистрируют в справочнике «Дополнительные отчеты и обработки» — это штатный механизм библиотеки стандартных подсистем (БСП), встроенный в большинство типовых конфигураций. После регистрации обработка хранится внутри базы, доступна всем пользователям с нужными правами и может запускаться из разделов программы или по расписанию.
- 1Откройте раздел «Администрирование» — «Печатные формы, отчеты и обработки» (в некоторых конфигурациях — «НСИ и администрирование»).
- 2Установите флаг «Дополнительные отчеты и обработки».
- 3Перейдите по появившейся ссылке «Дополнительные отчеты и обработки».
- 4Нажмите «Создать» (или «Добавить из файла») и выберите EPF-файл.
- 5Подтвердите предупреждение безопасности кнопкой «Продолжить».
- 6Проверьте карточку обработки: вид, разделы размещения, быстрый доступ для пользователей.
- 7Нажмите «Записать и закрыть», затем выполните команду «Выполнить» из списка для проверки.
В карточке обработки важно заполнить поле «Размещение» — разделы программы, где появится команда запуска. Если оставить список пустым, обработка будет видна только в общем списке дополнительных обработок. Поле «Быстрый доступ» определяет, какие пользователи увидят команду у себя в интерфейсе.
Если обработка относится к типу «Заполнение объекта», «Печатная форма» или «Создание связанных объектов», она появится не в разделах, а в соответствующих документах и справочниках — например, в кнопке «Печать» или «Заполнить». Для этого в карточке обработки должны быть корректно указаны назначения (виды объектов), обычно они подставляются автоматически из файла.
Сравнение способов установки
Подходит для разовых задач и тестирования. Не требует прав администратора на справочники, но файл нужно открывать каждый раз заново.
Подходит для постоянной работы и нескольких пользователей. Требует права на изменение справочника и включённого механизма БСП.
Альтернатива, когда нужно изменить поведение типовых объектов. Требует больших прав и осторожности при обновлении конфигурации; для простых обработок избыточно.
Настройка прав и профилей безопасности
Открыть внешнюю обработку может не каждый пользователь. Необходимо одно из двух условий: у пользователя есть право «Интерактивное открытие внешних обработок» (входит в роль «Интерактивное открытие внешних отчетов и обработок»), либо он работает под полными правами. Без этого права команда «Файл — Открыть» для EPF-файлов будет заблокирована.
Для регистрации обработки в справочнике дополнительных отчетов и обработок нужны права на добавление и изменение этого справочника — обычно они есть у администратора или у пользователя с ролью «Добавление и изменение дополнительных отчетов и обработок». Рядовым пользователям достаточно права на выполнение уже зарегистрированных обработок.
В клиент-серверном режиме дополнительно действует механизм профилей безопасности кластера: администратор сервера может запретить выполнение внешнего кода вовсе или разрешить его только для доверенных файлов. Если обработка открывается у одних пользователей и не работает у других на терминальном сервере, проверьте профили безопасности в консоли кластера.
Частые ошибки и их устранение
Ошибка «Невозможно подключить дополнительный отчет из файла» при регистрации чаще всего означает, что обработка не содержит обязательной функции СведенияОВнешнейОбработке — такой файл можно только открывать вручную, но нельзя зарегистрировать в справочнике БСП. Решение: использовать разовый запуск или попросить разработчика адаптировать обработку под БСП.
Ошибки вида «Метод объекта не обнаружен» или «Поле объекта не обнаружено» при запуске говорят о несовместимости: обработка писалась под другую конфигурацию или другую версию, где есть объекты, отсутствующие в вашей базе. Например, обработка для УТ 10.3 не запустится в УТ 11. Здесь поможет только доработка кода.
Ситуация «обработка открывается, но окно пустое» типична для обработок, написанных под обычное приложение (обычные формы), которое не поддерживается в тонком и веб-клиенте. Проверьте, для какого режима создан файл; при необходимости запустите базу в режиме обычного приложения через толстый клиент.
Как проверить результат установки
После разового открытия проверка проста: окно обработки отобразилось, её команды выполняются без ошибок, а результат (загруженные данные, сформированный отчет) соответствует ожиданиям. Если обработка изменяет данные, сверьте несколько объектов вручную до и после запуска.
После регистрации в справочнике убедитесь, что обработка видна в списке «Дополнительные отчеты и обработки», команда появилась в выбранных разделах, а запуск через «Выполнить» проходит без ошибок. Затем проверьте доступ от имени рядового пользователя — именно на этом этапе чаще всего выявляются проблемы с правами и быстрым доступом.
Как проверить результат
Отображается интерфейс обработки, команды доступны
Пустое окно или ошибка при открытии — несовместимость режима или конфигурации
Обработка сохранилась, команда «Выполнить» работает
Ошибка при записи или выполнении — нет функции СведенияОВнешнейОбработке или не хватает прав
Команда есть в указанных разделах под нужными пользователями
Команды нет — не заполнены размещение или быстрый доступ
FAQ
Чем EPF отличается от расширения конфигурации CFE?
EPF — самостоятельная обработка, которая запускается по команде и не меняет конфигурацию. CFE — расширение, которое подключается к базе и изменяет поведение типовых объектов: формы, модули, роли. Для разовых инструментов достаточно EPF; расширение нужно, когда требуется доработать штатный функционал.
Можно ли установить EPF в 1С:Бухгалтерию в облаке (1С:Фреш)?
В сервисе 1С:Фреш действуют ограничения безопасности: произвольные внешние обработки запрещены, разрешены только обработки из каталога проверенных дополнений сервиса. Разовое открытие произвольного EPF-файла в облачном режиме обычно недоступно.
Почему при открытии файла появляется предупреждение безопасности?
Платформа предупреждает, что внешний файл содержит исполняемый код, который получит доступ к данным базы. Это штатное поведение. Подтверждайте запуск только для файлов из доверенных источников; при сомнениях сначала проверьте обработку на копии базы.
Обработка открылась, но выдаёт ошибку при выполнении. Что делать?
Чаще всего причина в несовместимости: обработка рассчитана на другую конфигурацию или версию. Проверьте, для какой конфигурации заявлен файл. Если конфигурация совпадает, ошибку нужно анализировать по тексту сообщения — как правило, требуется доработка кода разработчиком.
Как обновить уже зарегистрированную обработку на новую версию?
Откройте карточку обработки в справочнике «Дополнительные отчеты и обработки» и воспользуйтесь командой «Заменить на внешний файл» (или «Загрузить из файла»), выбрав новую версию EPF. Настройки размещения и быстрого доступа при этом сохраняются.
Нужны ли права администратора, чтобы просто открыть EPF-файл?
Полные права не обязательны. Достаточно права «Интерактивное открытие внешних обработок», которое администратор может добавить пользователю через профиль группы доступа. Без этого права интерактивное открытие файлов будет заблокировано.
Что важно запомнить
Разовый запуск EPF — через «Файл — Открыть», постоянная установка — через справочник «Дополнительные отчеты и обработки» с настройкой размещения и доступа. Проверяйте источник файла, запускайте новые обработки сначала на копии базы и убедитесь, что у пользователей есть нужные права.