Открываем внешнюю обработку в 1С 8.3: пять рабочих способов
Содержание
Внешняя обработка в 1С — это отдельный файл с расширением .epf. Самый быстрый способ открыть обработку в 1С 8.3 — нажать кнопку «Главное меню» в левом верхнем углу окна, выбрать Файл → Открыть (или Ctrl+O) и указать нужный .epf. Но пункт сработает только у пользователя, которому выдано право на интерактивное открытие внешних обработок.
Если права нет или обработку нужно раздать коллегам безопасно — её подключают через механизм дополнительных обработок в разделе Администрирование. Ниже — все пять способов запустить обработку: от открытия файлом за пару секунд до штатного подключения в конфигурации.
Обработка и отчёт: чем они отличаются и зачем открываются
Обработка — это объект 1С, который что-то делает с данными: загружает, выгружает, меняет, формирует печатную форму, чистит мусор. Отличие от отчёта в том, что отчёт данные только показывает, а обработка может их записать и изменить.
Обработки бывают двух видов:
- 🧩 Встроенные — входят в конфигурацию (например, «Групповое изменение реквизитов» или «Поиск и удаление дублей»). Их не нужно открывать файлом, они уже внутри базы.
- 📎 Внешние — отдельные файлы
.epf, которые прислал программист, скачали из сервиса или написали сами. Их и нужно подключить к базе.
Расширения легко перепутать: .epf — внешняя обработка, .erf — внешний отчёт. Открываются они одинаково, но отчёт данные не меняет.
Если файл пришёл со стороны, перед запуском в рабочей базе сделайте резервную копию или проверьте обработку на копии. Внешний код может записать движения или удалить данные без возможности отката.
Коротко — какой способ когда выбрать:
| Способ | Кому подходит | Остаётся в базе |
|---|---|---|
| Файл → Открыть | разовый запуск, есть право | нет |
| Конфигуратор | правка и отладка кода | нет |
| Командная строка | запуск по расписанию | нет |
| Все функции | встроенные обработки | да (они уже внутри) |
| Дополнительные обработки | раздать пользователям штатно | да |
Способ 1. Через главное меню «Файл → Открыть»
Это путь для пользователя, которому нужно разово запустить обработку прямо из 1С:Предприятия, не привлекая администратора.
- Нажмите кнопку «Главное меню» в левом верхнем углу окна (значок со стрелкой вниз).
- Выберите
Файл → Открытьили нажмитеCtrl+O. - В окне выбора файла укажите нужный
.epfи нажмите «Открыть».
Обработка откроется в отдельном окне — дальше работаете с её формой. После закрытия программы она в базе не останется: при следующем запуске файл придётся открыть заново.
Если пункт Открыть неактивен или окна выбора нет — у вашей учётной записи нет права на интерактивное открытие внешних отчётов и обработок. Это право по умолчанию выдано администраторам; обычному пользователю его либо добавляют в роль, либо дают обработку через механизм дополнительных обработок (способ 5).
Открытие внешних файлов — это ещё и вопрос безопасности. Право специально закрыто для рядовых пользователей, чтобы в базу не занесли произвольный код. Не просите «включить всем» — лучше подключить проверенную обработку штатно.
Способ 2. Через конфигуратор — для разработки и отладки
Конфигуратор нужен не для работы с обработкой, а для её правки и отладки. Так открывают .epf, когда хотят посмотреть код, формы и реквизиты или доработать обработку.
- Запустите базу в режиме Конфигуратор.
- Выберите
Файл → Открытьи укажите.epf. - Откроется окно обработки с деревом: модуль объекта, формы, макеты, реквизиты и табличные части.
Чтобы запустить обработку из конфигуратора в рабочем режиме, используйте отладку: Отладка → Начать отладку (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. Через меню «Все функции» — для встроенных обработок
Этот способ — не про внешние файлы, а про обработки, которые уже есть в конфигурации. Через «Все функции» открывают встроенные обработки и отчёты, которых нет в обычном интерфейсе.
Сначала команду нужно включить:
Главное меню → Сервис → Параметры.- Поставьте флажок «Отображать команду “Все функции”» и нажмите «ОК».
- Теперь в
Главное меню → Все функцииоткрывается дерево объектов базы.
В дереве разверните ветку Обработки — там перечислены все обработки конфигурации. Двойной щелчок по нужной — и она откроется. Рядом ветки Отчёты, Справочники, Документы — удобно, когда объекта нет в настроенном меню, а зайти в него надо.
Внешние .epf в «Все функции» не появляются — там только то, что встроено в конфигурацию. Для файла с диска используйте способ 1 или 5.
Способ 5. Через «Дополнительные отчёты и обработки» (БСП)
Это штатный и безопасный способ подключить внешнюю обработку так, чтобы она осталась в базе и была доступна пользователям без права открывать файлы. Механизм входит в Библиотеку стандартных подсистем и есть в БП 3.0, ЗУП 3.1, УТ 11, КА и ERP.
Чтобы обработку можно было добавить, она должна быть сделана как дополнительная — с экспортной функцией СведенияОВнешнейОбработке() в модуле объекта. Обычный .epf «для себя» так не подключить.
Порядок подключения (нужны права администратора):
- Откройте
Администрирование → Печатные формы, отчёты и обработки. - Включите флажок «Дополнительные отчёты и обработки».
- Перейдите по ссылке
Дополнительные отчёты и обработки. - Нажмите «Добавить из файла» и выберите
.epf. - Платформа предупредит о безопасности — подтвердите, если обработке доверяете.
- Укажите, в каких разделах и у каких пользователей она будет видна, запишите карточку.
После этого обработка появится у пользователей в списке дополнительных обработок соответствующего раздела — открывать файл им уже не нужно.
В карточке дополнительной обработки задаётся её вид — от него зависит, где она будет вызываться:
- 📄 Печатная форма — встаёт в меню «Печать» нужного документа или справочника.
- ✏️ Заполнение объекта — добавляется в команды заполнения документа.
- 🔗 Создание связанных объектов — создаёт на основании документа другие документы.
- 🧰 Дополнительная обработка — открывается как самостоятельная форма из списка раздела.
Вид обработка сообщает сама, через ту же функцию СведенияОВнешнейОбработке(). Если при добавлении 1С не предлагает привязать печатную форму к документу — скорее всего, обработка сделана как самостоятельная, а не как печатная форма.
Флажок «Безопасный режим» в карточке ограничивает обработке доступ к файловой системе и внешним соединениям. Снимайте его только для проверенных обработок: в безопасном режиме часть кода может не отработать, но и вреда чужой код не нанесёт.
Путь к списку по конфигурациям немного различается — ориентируйтесь на раздел Администрирование:
| Конфигурация | Где включить и открыть |
|---|---|
| Бухгалтерия 3.0 | Администрирование → Печатные формы, отчёты и обработки |
| ЗУП 3.1 | Администрирование → Печатные формы, отчёты и обработки |
| УТ 11 | НСИ и администрирование → Печатные формы, отчёты и обработки |
Почему обработка не открывается: разбор ошибок
Чаще всего дело не в файле, а в правах, формате или версии платформы. Ниже — что означают типичные сообщения и как их снять.
.erf вместо обработки .epf, файл повреждён или это не файл 1С. Проверьте расширение и источник./Execute или пробелы в пути без кавычек. Укажите полный путь к .epf в двойных кавычках.Отдельная ситуация — сообщение о запрете по соображениям безопасности при добавлении в дополнительные обработки. Оно означает, что включён безопасный режим, а обработке нужен доступ к файлам или внешним ресурсам. Решение описано в способе 5: снять флажок безопасного режима для проверенной обработки.
Нюансы по версиям платформы и типам клиента
Способы выше описаны для платформы 1С 8.3 с интерфейсом «Такси». В более старых версиях и в разных клиентах есть различия.
- 🖥️ Толстый и тонкий клиент (приложение). Все пять способов работают. Меню
Файл → Открытьдоступно при наличии права. - 🌐 Веб-клиент (через браузер). Открыть
.epfс диска черезФайл → Открытьнельзя — браузер не даёт платформе читать локальные файлы напрямую. Остаётся способ 5: обработку подключают через дополнительные обработки, и она доступна в вебе наравне с приложением. - 🕹️ Платформа 8.2. Главного меню со стрелкой нет — пункт
Файл → Открытьвызывают из верхней строки меню или сочетаниемCtrl+O. Механизм дополнительных обработок есть не во всех конфигурациях того времени.
Если обработка не запускается в вебе, а в приложении работает — почти всегда причина в том, что её пытаются открыть файлом. Через дополнительные обработки она откроется в обоих клиентах.
Частые вопросы
Чем файл .epf отличается от .erf?
.epf — это внешняя обработка, она может записывать и менять данные. .erf — внешний отчёт, он данные только показывает. Открываются одинаково, через Файл → Открыть.Сохранится ли обработка в базе после закрытия программы?
Файл → Открыть. При следующем запуске 1С её нужно открыть заново. Чтобы обработка осталась в базе, подключите её через «Дополнительные отчёты и обработки».Можно ли открыть обработку без прав администратора?
Почему обработка открывается в приложении, но не в браузере?
Файл → Открыть в браузере не поможет. Используйте механизм дополнительных обработок — он работает и в вебе.Можно ли запускать обработку по расписанию?
1cv8.exe и ключом /Execute"путь.epf", а в планировщике Windows задайте время. Обработка отработает и закроет программу, если это предусмотрено её кодом.