Запуск внешней обработки .epf в 1С 8.3: из файла, из справочника и при старте базы

· 10 мин

Содержание

Чтобы открыть обработку в 1С 8.3, запустите базу в режиме 1С:Предприятие, нажмите Ctrl+O (или главное меню → Файл → Открыть) и выберите файл с расширением .epf. Платформа покажет предупреждение безопасности — нажмите «Да», и форма обработки откроется. Если обработка нужна регулярно, её лучше один раз добавить в программу через Администрирование → Печатные формы, отчеты и обработки.

Типичная ситуация: программист прислал файл «ЗагрузкаИзExcel.epf», бухгалтер дважды щёлкает по нему в проводнике — и ничего не происходит. Файл обработки не запускается сам по себе, его открывают изнутри работающей базы. Как именно — зависит от того, разовый это запуск или постоянный инструмент.

Что такое внешняя обработка и чем она отличается от встроенной

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

Обработки бывают двух видов:

  • 📦 Встроенные — входят в конфигурацию. Например, «Групповое изменение реквизитов» или «Удаление помеченных объектов». Открываются из меню разделов или через «Все функции».
  • 📄 Внешние — отдельный файл .epf, который лежит на диске. Конфигурацию не меняет, обновление программы не ломает. Именно их чаще всего и спрашивают, как открыть.

Рядом живут внешние отчёты — файлы .erf. Открываются они точно так же, всё сказанное ниже относится и к ним.

Внешняя обработка выполняется с правами того пользователя, который её запустил. Если у вас есть право удалять документы, обработка тоже сможет их удалить. Поэтому файлы из незнакомых источников открывать нельзя.

Перед запуском обработки, которая что-то записывает в базу, сделайте резервную копию. Отменить групповое перезаполнение или загрузку тысячи документов кнопкой «Назад» не получится.

Как вам удобнее запускать обработку?

Способ 1. Как открыть обработку через меню «Файл»

Самый быстрый путь, работает в любой конфигурации на платформе 8.3: Бухгалтерии, ЗУП, УТ, УНФ, ERP и самописных.

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

💡 Обработку не обязательно копировать на сервер или в папку базы. Её можно открыть из «Загрузок», с флешки или из сетевой папки. Главное — чтобы у вашего компьютера был доступ к файлу.

Если меню «Файл» не видно

В интерфейсе «Такси» меню «Файл» спрятано в главном меню, а не висит отдельной строкой. Если кнопки с полосками нет, проверьте, не свернута ли верхняя панель. Сочетание Ctrl+O работает в любом случае.

Повторное открытие

Платформа помнит недавно открытые файлы. В главном меню в разделе «Файл» обычно есть список последних — повторно искать обработку на диске не придётся.

Способ 2. Как открыть обработку через «Дополнительные обработки»

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

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

  1. Перейдите в Администрирование → Печатные формы, отчеты и обработки.
  2. Установите флажок «Дополнительные отчеты и обработки».
  3. Рядом станет активна ссылка «Дополнительные отчеты и обработки» — по ней откроется справочник.

Шаг 2. Загрузите файл

  1. В справочнике нажмите «Добавить из файла» (или «Создать» — кнопка зависит от релиза, но обе ведут к выбору файла).
  2. Подтвердите предупреждение безопасности.
  3. Выберите .epf. Программа прочитает из файла описание: название, вид, версию, список команд.
  4. В карточке проверьте поле «Вид» — от него зависит, где появится команда.

Шаг 3. Настройте размещение и доступ

  • 📍 Размещение — укажите разделы, в которых появится команда. Для дополнительной обработки это, например, «Продажи» или «Банк и касса».
  • 👥 Быстрый доступ — отметьте пользователей, у которых команда будет видна сразу.
  • 📝 Назначение — для печатных форм и обработок заполнения укажите документы или справочники.
  • ✅ Публикация — значение «Используется». В режиме «Отключена» команда не появится.

Запишите и закройте карточку.

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

Вид в карточкеГде появится команда
Дополнительная обработкаВ выбранном разделе: панель навигации → «Сервис» → «Дополнительные обработки»
Дополнительный отчётВ выбранном разделе → «Дополнительные отчеты»
Печатная формаВ форме назначенного документа, кнопка «Печать»
Заполнение объектаВ форме назначенного документа, кнопка «Заполнить»
Создание связанных объектовВ форме назначенного объекта, команда «Создать на основании»

Добавить в справочник можно не всякий файл. Обработка должна быть написана под БСП: в модуле объекта у неё есть экспортная функция СведенияОВнешнейОбработке(). Если программа отвечает, что обработка несовместима с подсистемой дополнительных отчётов и обработок, — запускайте её способом 1, через Файл → Открыть.

Права на открытие обработок и защита от опасных действий

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

Какое право нужно

На уровне платформы открытие внешних файлов регулируют права «Интерактивное открытие внешних обработок» и «Интерактивное открытие внешних отчетов». У роли «Полные права» они есть. В конфигурациях на БСП права выдают через группы доступа:

  1. Откройте Администрирование → Настройки пользователей и прав → Группы доступа.
  2. Найдите группу с профилем, в названии которого есть «Открытие внешних отчетов и обработок», или создайте такую группу на основе этого профиля.
  3. Добавьте в неё сотрудника.
  4. Пользователю нужно перезапустить 1С — права применяются при входе.

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

Предупреждение безопасности

Окно «Предупреждение безопасности» появляется при открытии каждого внешнего файла. Это механизм платформы «Защита от опасных действий». Его можно отключить для конкретного пользователя:

  1. Откройте базу в Конфигураторе.
  2. Администрирование → Пользователи, двойной щелчок по пользователю.
  3. На вкладке «Основные» снимите флажок «Защита от опасных действий».

Есть и вариант для всей рабочей станции: параметр 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
Конфигуратор + отладкаПройти код по шагам с точками останова

Как отладить обработку

  1. В Конфигураторе откройте файл через Файл → Открыть.
  2. Поставьте точку останова в модуле (F9).
  3. Запустите отладку (F5) — откроется 1С:Предприятие.
  4. В нём откройте тот же файл через Файл → Открыть. Выполнение остановится на точке.

После правки кода сохраните файл (Ctrl+S) и откройте его в Предприятии заново. Уже открытая форма изменения не подхватит.

Обработка под обычные формы

Старые обработки, написанные для 8.2 и обычного приложения, содержат только обычные формы. В тонком клиенте «Такси» такая форма не откроется. Варианты:

  • открыть базу в толстом клиенте в режиме обычного приложения (параметр запуска /RunModeOrdinaryApplication);
  • попросить разработчика добавить управляемую форму.

Первый вариант работает только для файловой базы или при установленном толстом клиенте, и не во всех конфигурациях обычные формы разрешены настройками. Для БП 3.0 и ЗУП 3.1 правильный путь — второй.

Почему не открывается обработка в 1С: разбор ошибок

Диагностика: выберите симптом

Если не помогло

Откройте файл в Конфигураторе. Если он не открывается и там, файл битый или сохранён в платформе с номером выше вашего — обновите платформу или попросите разработчика пересохранить обработку. Если в Конфигураторе всё открывается, запустите отладку по шагам из раздела выше: строка, на которой выполнение упадёт, покажет, какого объекта не хватает.

Частые вопросы

Можно ли открыть обработку в 1С Фреш или другом облачном сервисе?
Открыть файл через Файл → Открыть в облаке обычно нельзя. Обработку загружают в справочник дополнительных обработок, и в 1С:Фреш она проходит проверку сервисом перед использованием.
Работает ли открытие обработок в веб-клиенте?
Да, через то же меню Файл → Открыть. Браузер предложит выбрать файл, после чего он передаётся на сервер. Обработки, которые работают с файлами на компьютере пользователя, в веб-клиенте могут вести себя иначе.
Нужно ли заново загружать обработку после обновления конфигурации?
Нет, загруженная в справочник обработка сохраняется. Но если в новом релизе изменились реквизиты, с которыми она работает, обработка начнёт выдавать ошибки, и потребуется её новая версия.
Чем отличается .epf от .erf?
.epf — внешняя обработка, .erf — внешний отчёт. Открываются одинаково, но отчёт только выводит данные, а обработка может их изменять.
Где хранится обработка, добавленная в дополнительные обработки?
Внутри информационной базы, в справочнике. Файл на диске после загрузки можно удалить: при выгрузке базы в .dt обработка сохранится вместе с данными.