Открываем внешнюю обработку в 1С 8.3: пять рабочих способов

· 9 мин

Содержание

Внешняя обработка в 1С — это отдельный файл с расширением .epf. Самый быстрый способ открыть обработку в 1С 8.3 — нажать кнопку «Главное меню» в левом верхнем углу окна, выбрать Файл → Открыть (или Ctrl+O) и указать нужный .epf. Но пункт сработает только у пользователя, которому выдано право на интерактивное открытие внешних обработок.

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

Обработка и отчёт: чем они отличаются и зачем открываются

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

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

  • 🧩 Встроенные — входят в конфигурацию (например, «Групповое изменение реквизитов» или «Поиск и удаление дублей»). Их не нужно открывать файлом, они уже внутри базы.
  • 📎 Внешние — отдельные файлы .epf, которые прислал программист, скачали из сервиса или написали сами. Их и нужно подключить к базе.

Расширения легко перепутать: .epf — внешняя обработка, .erf — внешний отчёт. Открываются они одинаково, но отчёт данные не меняет.

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

Коротко — какой способ когда выбрать:

СпособКому подходитОстаётся в базе
Файл → Открытьразовый запуск, есть правонет
Конфигураторправка и отладка коданет
Командная строказапуск по расписаниюнет
Все функциивстроенные обработкида (они уже внутри)
Дополнительные обработкираздать пользователям штатнода

Способ 1. Через главное меню «Файл → Открыть»

Это путь для пользователя, которому нужно разово запустить обработку прямо из 1С:Предприятия, не привлекая администратора.

  1. Нажмите кнопку «Главное меню» в левом верхнем углу окна (значок со стрелкой вниз).
  2. Выберите Файл → Открыть или нажмите Ctrl+O.
  3. В окне выбора файла укажите нужный .epf и нажмите «Открыть».

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

Если пункт Открыть неактивен или окна выбора нет — у вашей учётной записи нет права на интерактивное открытие внешних отчётов и обработок. Это право по умолчанию выдано администраторам; обычному пользователю его либо добавляют в роль, либо дают обработку через механизм дополнительных обработок (способ 5).

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

Способ 2. Через конфигуратор — для разработки и отладки

Конфигуратор нужен не для работы с обработкой, а для её правки и отладки. Так открывают .epf, когда хотят посмотреть код, формы и реквизиты или доработать обработку.

  1. Запустите базу в режиме Конфигуратор.
  2. Выберите Файл → Открыть и укажите .epf.
  3. Откроется окно обработки с деревом: модуль объекта, формы, макеты, реквизиты и табличные части.

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

Открывать обработку в конфигураторе ради того, чтобы «просто запустить», смысла нет — для этого есть способ 1. Конфигуратор берут, когда нужно увидеть, что обработка делает внутри, или исправить ошибку в её модуле.

Способ 3. Запуск обработки из командной строки

Командную строку используют, когда обработку надо запускать по расписанию, из bat-файла или с автоматической передачей параметра. За это отвечает ключ /Execute.

Общий вид команды:

"C:\Program Files\1cv8\8.3.x.xxxx\bin\1cv8.exe" ENTERPRISE ^
 /F"D:\base" /N"Иванов" /P"пароль" ^
 /Execute"C:\obrabotki\Zagruzka.epf" /C"РежимТест"

Разберём параметры:

КлючЧто задаёт
ENTERPRISEрежим запуска 1С:Предприятие
/F"путь"путь к файловой базе
/S"сервер\база"адрес базы клиент-серверного варианта (вместо /F)
/N / /Pимя пользователя и пароль
/Execute"путь.epf"внешняя обработка, которую нужно выполнить при старте
/C"значение"строка параметра запуска, читается внутри функцией ПараметрЗапуска()

После старта платформа выполнит модуль объекта обработки. Путь к 1cv8.exe зависит от установленной версии платформы — подставьте свой номер релиза вместо 8.3.x.xxxx. Путь с пробелами всегда берите в кавычки, иначе 1С не найдёт файл.

Пара ключей, которые часто пригождаются вместе с /Execute:

  • /DisableStartupMessages — подавляет служебные предупреждения при запуске, чтобы фоновый процесс не ждал нажатия «ОК».
  • /DisableStartupDialogs — убирает стартовые диалоги (например, выбор пользователя), если логин и пароль уже переданы в /N и /P.

Для клиент-серверной базы вместо /F подставьте /S"сервер\имя_базы". Остальные ключи остаются теми же.

Так удобно автоматизировать выгрузки: планировщик Windows запускает bat-файл ночью, обработка отрабатывает и закрывает программу командой ЗавершитьРаботуСистемы() в своём коде.

Способ 4. Через меню «Все функции» — для встроенных обработок

Этот способ — не про внешние файлы, а про обработки, которые уже есть в конфигурации. Через «Все функции» открывают встроенные обработки и отчёты, которых нет в обычном интерфейсе.

Сначала команду нужно включить:

  1. Главное меню → Сервис → Параметры.
  2. Поставьте флажок «Отображать команду “Все функции”» и нажмите «ОК».
  3. Теперь в Главное меню → Все функции открывается дерево объектов базы.

В дереве разверните ветку Обработки — там перечислены все обработки конфигурации. Двойной щелчок по нужной — и она откроется. Рядом ветки Отчёты, Справочники, Документы — удобно, когда объекта нет в настроенном меню, а зайти в него надо.

Внешние .epf в «Все функции» не появляются — там только то, что встроено в конфигурацию. Для файла с диска используйте способ 1 или 5.

Способ 5. Через «Дополнительные отчёты и обработки» (БСП)

Это штатный и безопасный способ подключить внешнюю обработку так, чтобы она осталась в базе и была доступна пользователям без права открывать файлы. Механизм входит в Библиотеку стандартных подсистем и есть в БП 3.0, ЗУП 3.1, УТ 11, КА и ERP.

Чтобы обработку можно было добавить, она должна быть сделана как дополнительная — с экспортной функцией СведенияОВнешнейОбработке() в модуле объекта. Обычный .epf «для себя» так не подключить.

Порядок подключения (нужны права администратора):

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

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

В карточке дополнительной обработки задаётся её вид — от него зависит, где она будет вызываться:

  • 📄 Печатная форма — встаёт в меню «Печать» нужного документа или справочника.
  • ✏️ Заполнение объекта — добавляется в команды заполнения документа.
  • 🔗 Создание связанных объектов — создаёт на основании документа другие документы.
  • 🧰 Дополнительная обработка — открывается как самостоятельная форма из списка раздела.

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

Флажок «Безопасный режим» в карточке ограничивает обработке доступ к файловой системе и внешним соединениям. Снимайте его только для проверенных обработок: в безопасном режиме часть кода может не отработать, но и вреда чужой код не нанесёт.

Путь к списку по конфигурациям немного различается — ориентируйтесь на раздел Администрирование:

КонфигурацияГде включить и открыть
Бухгалтерия 3.0Администрирование → Печатные формы, отчёты и обработки
ЗУП 3.1Администрирование → Печатные формы, отчёты и обработки
УТ 11НСИ и администрирование → Печатные формы, отчёты и обработки

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

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

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

Отдельная ситуация — сообщение о запрете по соображениям безопасности при добавлении в дополнительные обработки. Оно означает, что включён безопасный режим, а обработке нужен доступ к файлам или внешним ресурсам. Решение описано в способе 5: снять флажок безопасного режима для проверенной обработки.

Нюансы по версиям платформы и типам клиента

Способы выше описаны для платформы 1С 8.3 с интерфейсом «Такси». В более старых версиях и в разных клиентах есть различия.

  • 🖥️ Толстый и тонкий клиент (приложение). Все пять способов работают. Меню Файл → Открыть доступно при наличии права.
  • 🌐 Веб-клиент (через браузер). Открыть .epf с диска через Файл → Открыть нельзя — браузер не даёт платформе читать локальные файлы напрямую. Остаётся способ 5: обработку подключают через дополнительные обработки, и она доступна в вебе наравне с приложением.
  • 🕹️ Платформа 8.2. Главного меню со стрелкой нет — пункт Файл → Открыть вызывают из верхней строки меню или сочетанием Ctrl+O. Механизм дополнительных обработок есть не во всех конфигурациях того времени.

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

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

Чем файл .epf отличается от .erf?
.epf — это внешняя обработка, она может записывать и менять данные. .erf — внешний отчёт, он данные только показывает. Открываются одинаково, через Файл → Открыть.
Сохранится ли обработка в базе после закрытия программы?
Нет, если вы открыли её файлом через Файл → Открыть. При следующем запуске 1С её нужно открыть заново. Чтобы обработка осталась в базе, подключите её через «Дополнительные отчёты и обработки».
Можно ли открыть обработку без прав администратора?
Разово — только если вам выдано право на интерактивное открытие внешних обработок. Если обработку подключил администратор через дополнительные обработки, она доступна вам из списка раздела без каких-либо особых прав.
Почему обработка открывается в приложении, но не в браузере?
Веб-клиент не может читать файлы с вашего диска, поэтому Файл → Открыть в браузере не поможет. Используйте механизм дополнительных обработок — он работает и в вебе.
Можно ли запускать обработку по расписанию?
Да. Создайте bat-файл с запуском 1cv8.exe и ключом /Execute"путь.epf", а в планировщике Windows задайте время. Обработка отработает и закроет программу, если это предусмотрено её кодом.