Запуск внешней обработки .epf в 1С 8.3: из файла, из справочника и при старте базы
Содержание
Чтобы открыть обработку в 1С 8.3, запустите базу в режиме 1С:Предприятие, нажмите Ctrl+O (или главное меню → Файл → Открыть) и выберите файл с расширением .epf. Платформа покажет предупреждение безопасности — нажмите «Да», и форма обработки откроется. Если обработка нужна регулярно, её лучше один раз добавить в программу через Администрирование → Печатные формы, отчеты и обработки.
Типичная ситуация: программист прислал файл «ЗагрузкаИзExcel.epf», бухгалтер дважды щёлкает по нему в проводнике — и ничего не происходит. Файл обработки не запускается сам по себе, его открывают изнутри работающей базы. Как именно — зависит от того, разовый это запуск или постоянный инструмент.
Что такое внешняя обработка и чем она отличается от встроенной
Обработка в 1С — это объект, который выполняет действие с данными: загружает, перезаполняет, проверяет, выгружает. Отчёт только показывает данные, обработка их меняет. Это главное, что нужно помнить перед запуском чужого файла.
Обработки бывают двух видов:
- 📦 Встроенные — входят в конфигурацию. Например, «Групповое изменение реквизитов» или «Удаление помеченных объектов». Открываются из меню разделов или через «Все функции».
- 📄 Внешние — отдельный файл
.epf, который лежит на диске. Конфигурацию не меняет, обновление программы не ломает. Именно их чаще всего и спрашивают, как открыть.
Рядом живут внешние отчёты — файлы .erf. Открываются они точно так же, всё сказанное ниже относится и к ним.
Внешняя обработка выполняется с правами того пользователя, который её запустил. Если у вас есть право удалять документы, обработка тоже сможет их удалить. Поэтому файлы из незнакомых источников открывать нельзя.
Перед запуском обработки, которая что-то записывает в базу, сделайте резервную копию. Отменить групповое перезаполнение или загрузку тысячи документов кнопкой «Назад» не получится.
Файл → Открыть. В программу ничего добавлять не нужно, после закрытия формы следов не останется.Файл → Открыть тут не подходит.Способ 1. Как открыть обработку через меню «Файл»
Самый быстрый путь, работает в любой конфигурации на платформе 8.3: Бухгалтерии, ЗУП, УТ, УНФ, ERP и самописных.
- Запустите базу в режиме 1С:Предприятие (не Конфигуратор).
- Откройте главное меню — кнопка с тремя полосками в левом верхнем углу окна.
- Выберите
Файл → Открыть. То же самое делает сочетаниеCtrl+O. - В окне выбора файла найдите нужный
.epf. Если в списке пусто, переключите фильтр типа файлов на «Все файлы». - Появится предупреждение безопасности о том, что файл может содержать небезопасный код. Нажмите «Да», если доверяете источнику.
- Откроется основная форма обработки. Дальше работаете с её кнопками.
💡 Обработку не обязательно копировать на сервер или в папку базы. Её можно открыть из «Загрузок», с флешки или из сетевой папки. Главное — чтобы у вашего компьютера был доступ к файлу.
Если меню «Файл» не видно
В интерфейсе «Такси» меню «Файл» спрятано в главном меню, а не висит отдельной строкой. Если кнопки с полосками нет, проверьте, не свернута ли верхняя панель. Сочетание Ctrl+O работает в любом случае.
Повторное открытие
Платформа помнит недавно открытые файлы. В главном меню в разделе «Файл» обычно есть список последних — повторно искать обработку на диске не придётся.
Способ 2. Как открыть обработку через «Дополнительные обработки»
Этот механизм есть во всех типовых конфигурациях на БСП: Бухгалтерия 3.0, ЗУП 3.1, УТ 11, КА 2, ERP, УНФ. Обработку один раз загружают в базу, и она хранится внутри неё. Файл на диске больше не нужен.
Шаг 1. Включите механизм
- Перейдите в
Администрирование → Печатные формы, отчеты и обработки. - Установите флажок «Дополнительные отчеты и обработки».
- Рядом станет активна ссылка «Дополнительные отчеты и обработки» — по ней откроется справочник.
Шаг 2. Загрузите файл
- В справочнике нажмите «Добавить из файла» (или «Создать» — кнопка зависит от релиза, но обе ведут к выбору файла).
- Подтвердите предупреждение безопасности.
- Выберите
.epf. Программа прочитает из файла описание: название, вид, версию, список команд. - В карточке проверьте поле «Вид» — от него зависит, где появится команда.
Шаг 3. Настройте размещение и доступ
- 📍 Размещение — укажите разделы, в которых появится команда. Для дополнительной обработки это, например, «Продажи» или «Банк и касса».
- 👥 Быстрый доступ — отметьте пользователей, у которых команда будет видна сразу.
- 📝 Назначение — для печатных форм и обработок заполнения укажите документы или справочники.
- ✅ Публикация — значение «Используется». В режиме «Отключена» команда не появится.
Запишите и закройте карточку.
Где потом искать обработку
| Вид в карточке | Где появится команда |
|---|---|
| Дополнительная обработка | В выбранном разделе: панель навигации → «Сервис» → «Дополнительные обработки» |
| Дополнительный отчёт | В выбранном разделе → «Дополнительные отчеты» |
| Печатная форма | В форме назначенного документа, кнопка «Печать» |
| Заполнение объекта | В форме назначенного документа, кнопка «Заполнить» |
| Создание связанных объектов | В форме назначенного объекта, команда «Создать на основании» |
Добавить в справочник можно не всякий файл. Обработка должна быть написана под БСП: в модуле объекта у неё есть экспортная функция СведенияОВнешнейОбработке(). Если программа отвечает, что обработка несовместима с подсистемой дополнительных отчётов и обработок, — запускайте её способом 1, через Файл → Открыть.
Права на открытие обработок и защита от опасных действий
Если меню «Открыть» неактивно или после выбора файла появляется «Нарушение прав доступа!», дело в правах. Обычный пользователь типовой конфигурации внешние файлы открывать не может — это сделано намеренно.
Какое право нужно
На уровне платформы открытие внешних файлов регулируют права «Интерактивное открытие внешних обработок» и «Интерактивное открытие внешних отчетов». У роли «Полные права» они есть. В конфигурациях на БСП права выдают через группы доступа:
- Откройте
Администрирование → Настройки пользователей и прав → Группы доступа. - Найдите группу с профилем, в названии которого есть «Открытие внешних отчетов и обработок», или создайте такую группу на основе этого профиля.
- Добавьте в неё сотрудника.
- Пользователю нужно перезапустить 1С — права применяются при входе.
Для работы через справочник дополнительных обработок право на открытие файлов пользователю не нужно. Он запускает уже загруженную и проверенную администратором обработку. Это ещё один довод в пользу способа 2.
Предупреждение безопасности
Окно «Предупреждение безопасности» появляется при открытии каждого внешнего файла. Это механизм платформы «Защита от опасных действий». Его можно отключить для конкретного пользователя:
- Откройте базу в Конфигураторе.
Администрирование → Пользователи, двойной щелчок по пользователю.- На вкладке «Основные» снимите флажок «Защита от опасных действий».
Есть и вариант для всей рабочей станции: параметр DisableUnsafeActionProtection в файле conf.cfg каталога платформы. В нём указывают шаблон строки соединения с базами, для которых защиту отключают.
DisableUnsafeActionProtection=.*srvr=server1c.*
Отключать защиту стоит только для администраторов и программистов, которые постоянно гоняют свои обработки. Для бухгалтеров предупреждение — последний шанс не запустить вредоносный файл из письма.
Безопасный режим в карточке обработки
В справочнике дополнительных обработок у карточки есть признак безопасного режима. Обработки, которые работают с файлами, COM-объектами или внешними ресурсами, в безопасном режиме выдают ошибку. Снимать признак может только администратор и только для файлов из надёжного источника.
Запуск обработки прямо из файла: командная строка и ярлык
Иногда обработку нужно запускать сразу при входе в базу: например, рабочее место кладовщика или сервисная загрузка курсов. Для этого у 1cv8.exe есть параметр /Execute.
"C:\Program Files\1cv8\common\1cestart.exe" ENTERPRISE /F"D:\Bases\Buh" /N"Администратор" /P"" /Execute"D:\Tools\Zagruzka.epf"
Что здесь происходит:
ENTERPRISE— запуск в режиме 1С:Предприятие;/F— путь к файловой базе (для серверной вместо него/S"сервер\база");/Nи/P— имя и пароль пользователя;/Execute— путь к внешней обработке, которая откроется после входа.
Такую строку можно вставить в поле «Объект» ярлыка на рабочем столе. Предупреждение безопасности при этом всё равно появится, если защита у пользователя не отключена.
💡 Пароль в ярлыке виден любому, кто откроет его свойства. Для сотрудников лучше настроить вход через аутентификацию Windows и не указывать /N и /P вовсе.
Перетаскивание и двойной щелчок
Двойной щелчок по .epf в проводнике запускает 1С, только если расширение связано с платформой. Тогда откроется окно выбора базы, а после входа — обработка. Если ассоциации нет, проще и надёжнее открывать файл изнутри программы.
Обработка в режиме Предприятия и в Конфигураторе
Новички часто открывают .epf в Конфигураторе и удивляются, что вместо формы видят дерево с реквизитами и модулями. Это нормально: в Конфигураторе обработку редактируют, а не выполняют.
| Режим | Что можно сделать с обработкой |
|---|---|
| 1С:Предприятие | Запустить, заполнить поля формы, выполнить действие с данными |
| Конфигуратор | Посмотреть и изменить код, формы, макеты; сохранить новый .epf |
| Конфигуратор + отладка | Пройти код по шагам с точками останова |
Как отладить обработку
- В Конфигураторе откройте файл через
Файл → Открыть. - Поставьте точку останова в модуле (
F9). - Запустите отладку (
F5) — откроется 1С:Предприятие. - В нём откройте тот же файл через
Файл → Открыть. Выполнение остановится на точке.
После правки кода сохраните файл (Ctrl+S) и откройте его в Предприятии заново. Уже открытая форма изменения не подхватит.
Обработка под обычные формы
Старые обработки, написанные для 8.2 и обычного приложения, содержат только обычные формы. В тонком клиенте «Такси» такая форма не откроется. Варианты:
- открыть базу
в толстом клиенте в режиме обычного приложения (параметр запуска
/RunModeOrdinaryApplication); - попросить разработчика добавить управляемую форму.
Первый вариант работает только для файловой базы или при установленном толстом клиенте, и не во всех конфигурациях обычные формы разрешены настройками. Для БП 3.0 и ЗУП 3.1 правильный путь — второй.
Почему не открывается обработка в 1С: разбор ошибок
Файл → Открыть или попросите разработчика добавить регистрацию.Если не помогло
Откройте файл в Конфигураторе. Если он не открывается и там, файл битый или сохранён в платформе с номером выше вашего — обновите платформу или попросите разработчика пересохранить обработку. Если в Конфигураторе всё открывается, запустите отладку по шагам из раздела выше: строка, на которой выполнение упадёт, покажет, какого объекта не хватает.
Частые вопросы
Можно ли открыть обработку в 1С Фреш или другом облачном сервисе?
Файл → Открыть в облаке обычно нельзя. Обработку загружают в справочник дополнительных обработок, и в 1С:Фреш она проходит проверку сервисом перед использованием.Работает ли открытие обработок в веб-клиенте?
Файл → Открыть. Браузер предложит выбрать файл, после чего он передаётся на сервер. Обработки, которые работают с файлами на компьютере пользователя, в веб-клиенте могут вести себя иначе.Нужно ли заново загружать обработку после обновления конфигурации?
Чем отличается .epf от .erf?
.epf — внешняя обработка, .erf — внешний отчёт. Открываются одинаково, но отчёт только выводит данные, а обработка может их изменять.Где хранится обработка, добавленная в дополнительные обработки?
.dt обработка сохранится вместе с данными.