Подключаем файл .epf к базе 1С 8.3: разовый запуск, регистрация и права

Чтобы установить внешнюю обработку в 1С, её не нужно «инсталлировать» как программу. Файл .epf либо открывают разово через главное меню Файл → Открыть, либо регистрируют в базе: в БП 3.0 это Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки → Добавить из файла. После регистрации обработка живёт внутри базы, и файл на диске больше не нужен.

Частое заблуждение — что достаточно положить файл в папку с базой или в каталог программы 1С:Предприятие. Платформа такие файлы не подхватывает. Обработка появляется в интерфейсе только после явного открытия или регистрации, и только у пользователя с нужными правами.

1. Что проверить перед установкой обработки

Внешние объекты бывают двух видов:

• 📄 .epf — внешняя обработка (загрузка данных, групповое изменение, печатная форма, заполнение табличной части);
• 📊 .erf — внешний отчёт.

Порядок подключения у них одинаковый. Дальше говорим «обработка», имея в виду оба вида.

Перед загрузкой проверьте четыре вещи.

1. Источник файла. Обработка — это программный код. Он выполняется с правами пользователя, который её запустил, и может менять или удалять данные . Берите файлы только у разработчика, которому доверяете.
2. Для какой конфигурации она написана. Обработка для БП 3.0 обращается к справочникам и документам БП. В ЗУП 3.1 или УТ 11 она, скорее всего, упадёт с ошибкой при первом же обращении к отсутствующему объекту.
3. Версия платформы. Файл, сохранённый в более новой версии 1С, может не открыться на старой. Номер вашей платформы виден в окне Справка → О программе (в главном меню «Такси»).
4. Поддерживает ли файл регистрацию. Обработку можно добавить в справочник дополнительных обработок только если в её модуле объекта есть экспортная функция СведенияОВнешнейОбработке(). Если её нет, файл всё равно открывается через Файл → Открыть, но зарегистрировать его не выйдет.

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

2. Разовый запуск внешней обработки через «Файл → Открыть»

Самый быстрый способ — открыть файл как документ. Так поступают, когда обработку нужно запустить один-два раза: перенести остатки, исправить реквизиты, выгрузить данные.

Порядок действий в интерфейсе «Такси»

1. Откройте базу в режиме 1С:Предприятие.
2. Нажмите кнопку главного меню (значок с тремя полосками в левом верхнем углу) или сочетание Ctrl+O.
3. Выберите Файл → Открыть.
4. Укажите файл .epf или .erf на диске.
5. Если платформа покажет предупреждение безопасности — прочитайте его и подтвердите открытие, только если файл надёжный.
6. Откроется форма обработки. Дальше работаете по инструкции её автора.

Обработка, открытая так, в базе не сохраняется. После закрытия программы её придётся открывать снова.

Кому это доступно

Способ работает только у пользователей с правом интерактивного открытия внешних обработок. Обычно оно есть у роли «Полные права». Рядовой бухгалтер при попытке открыть файл получит сообщение о нарушении прав доступа. Как это настроить — в разделе 4.

3. Регистрация обработки в дополнительных отчётах и обработках

Если обработкой пользуются регулярно, её регистрируют в базе. Этот механизм есть во всех типовых конфигурациях на Библиотеке стандартных подсистем: БП 3.0, ЗУП 3.1, УТ 11, КА 2, ERP 2, УНФ.

Шаг 1. Включите механизм

В БП 3.0 зайдите в Администрирование → Печатные формы, отчеты и обработки и установите флажок «Дополнительные отчеты и обработки». Без него ссылка на список дополнительных обработок не появится.

Где этот раздел в популярных конфигурациях:

Шаг 2. Добавьте файл

1. В том же разделе откройте ссылку «Дополнительные отчеты и обработки».
2. Нажмите «Добавить из файла…».
3. Прочитайте предупреждение о безопасности и подтвердите.
4. Выберите файл .epf или .erf.
5. Откроется карточка. Программа сама прочитает из файла вид, название, версию и список команд.

Шаг 3. Настройте карточку

В карточке есть три настройки, которые решают, увидит ли кто-то обработку.

• 🔘 Публикация. Значение «Используется» — обработка доступна. «Отключена» — сохранена в базе, но скрыта. «Режим отладки» — видна только администраторам.
• 📍 Размещение. Для вида «Дополнительная обработка» или «Дополнительный отчёт» укажите раздел, в котором она появится (например, «Банк и касса» или «Склад»). Для печатных форм и обработок заполнения размещение задаётся списком объектов: документов или справочников, к которым они привязаны.
• 👤 Быстрый доступ. Пользователи, у которых команда будет на виду сразу, без поиска в списке.

Нажмите «Записать и закрыть».

Где потом искать обработку

Это зависит от её вида, а вид задаёт разработчик внутри файла.

Если вы ждали обработку в разделе, а её там нет — сначала проверьте вид и размещение в карточке. Это самая частая причина «пропажи».

Как обновить уже зарегистрированную обработку

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

4. Права пользователей и защита от опасных действий

Здесь чаще всего и застревают: администратор всё видит, а бухгалтер — нет.

Три разных права

Чтобы рядовой пользователь запускал зарегистрированную обработку, право на открытие внешних файлов ему не нужно. Это главный довод в пользу регистрации: безопасность не страдает.

Где выдать права

В БП 3.0 и ЗУП 3.1 права выдают через группы доступа: Администрирование → Настройки пользователей и прав → Группы доступа. В профилях групп доступа ищите профиль или роль с названием про открытие внешних отчётов и обработок. Добавьте пользователя в группу с этим профилем, если ему действительно нужно открывать произвольные файлы.

Защита от опасных действий

В актуальных версиях платформы у пользователя есть флажок «Защита от опасных действий». Он включён по умолчанию. Если обработка обращается к файлам, внешним компонентам или COM-объектам, при открытии появится предупреждение. Пользователь должен подтвердить, что доверяет файлу.

Флажок виден в Конфигураторе: Администрирование → Пользователи, карточка пользователя. Снимать его ради одной обработки не стоит — предупреждение срабатывает при каждом открытии из файла и защищает от случайного запуска вредного кода.

Безопасный режим

У зарегистрированной обработки разработчик может указать, что она работает в безопасном режиме. Тогда ей запрещены операции с файлами на сервере, внешние компоненты и COM. Если обработке эти возможности нужны, при регистрации программа запросит разрешения. В клиент-серверной базе с включёнными профилями безопасности такие разрешения дополнительно подтверждает администратор кластера.

5. Ошибки при подключении обработки и их причины

Ниже — симптомы, которые встречаются при установке, а не при работе самой обработки.

Ещё один случай — обработка «зависает» при запуске в клиент-серверной базе. Обычно это серверный код, который долго работает с большим объёмом данных. Подождите или запустите её на копии в нерабочее время. Не завершайте рабочий процесс сервера вручную — оборвутся сеансы всех пользователей.

6. Запуск внешней обработки из командной строки

Для регулярных задач (ночная выгрузка, загрузка курсов, обмен с сайтом) обработку запускают без участия человека. Для этого у 1cv8.exe есть параметр /Execute: платформа открывает базу и сразу запускает указанный файл.

Файловая база

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" ENTERPRISE /F"D:\Bases\Buh" /N"Робот" /P"пароль" /Execute"D:\Obr\vygruzka.epf" /DisableStartupMessages

Клиент-серверная база

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" ENTERPRISE /S"srv1c\buh" /N"Робот" /P"пароль" /Execute"D:\Obr\vygruzka.epf" /DisableStartupMessages

Номер версии в пути замените на свой — посмотрите папку C:\Program Files\1cv8\.

Что важно для автозапуска:

• 🔑 Пользователь «Робот» должен иметь право открывать внешние обработки, иначе запуск остановится на ошибке прав.
• 🛡 Отключите ему «Защиту от опасных действий» в Конфигураторе — иначе платформа выведет окно подтверждения, и ночью нажать на него будет некому. Это единственный случай, где флажок уместно снимать.
• 🔚 Чтобы сеанс закрылся сам, в обработке должна быть команда завершения работы. Обычно её ставят в конце процедуры ПриОткрытии формы: ЗавершитьРаботуСистемы(Ложь);.
• 📨 Параметр для обработки передают ключом /C"текст". Внутри кода его читают из глобальной переменной ПараметрЗапуска.

Файл .bat ставят в «Планировщик заданий» Windows. Запускайте задачу от учётной записи, у которой есть доступ к папке с обработкой.

Альтернатива без командной строки

Если обработка зарегистрирована и имеет команду вида «Вызов серверного метода», в её карточке можно задать расписание. Тогда типовая конфигурация выполнит её регламентным заданием прямо на сервере 1С — без .bat, без открытого пароля и без Планировщика Windows. Для клиент-серверных баз это надёжнее.

7. Что выбрать: открытие файла, регистрацию или расширение

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

Если разработчик прислал файл .cfe, это не обработка. Через «Дополнительные отчеты и обработки» его не загрузить: расширения подключают в разделе администрирования, в списке расширений.