Как загрузить и запустить внешнюю обработку в 1С 8.3

Разовую обработку проще всего открыть через главное меню: Файл → Открыть (или Ctrl+O) и выбрать файл с расширением .epf. Для внешнего отчёта (.erf) путь тот же. Если обработка нужна постоянно и всем пользователям — её подключают через раздел «Дополнительные отчёты и обработки». Разработчику удобнее открыть файл в Конфигураторе, а для автоматического запуска по расписанию есть ключ командной строки /Execute.

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

Что проверить перед загрузкой файла

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

Перед открытием стоит убедиться в трёх вещах:

• 📁 Файл доступен локально. Диалог открытия читает файл с диска компьютера, а не из базы. Положите .epf в папку, к которой у вас есть доступ.
• 🧩 Обработка написана под вашу конфигурацию. Файл, собранный под «Бухгалтерию предприятия», может не заработать в «Управлении торговлей»: он обращается к объектам, которых в другой конфигурации нет.
• 🔑 У роли включено право на открытие внешних обработок. Без него пункт меню недоступен — это чаще всего и есть причина, по которой «ничего не открывается» (разбор в разделе о правах ниже).

Открытие через меню «Файл → Открыть»

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

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

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

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

У обработки может не быть собственной формы — тогда при открытии сразу запускается её основной модуль, и вы видите только результат: сообщение о выполнении или готовый отчёт. Это нормально: разработчик мог не делать интерфейс, если обработка выполняет одно действие.

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

Постоянное подключение: «Дополнительные отчёты и обработки»

Этот механизм хранит обработку внутри базы и показывает её пользователям по правам. Он есть в конфигурациях на Библиотеке стандартных подсистем — «Бухгалтерия предприятия 3.0», «Зарплата и управление персоналом 3.1», «Управление торговлей 11» и других.

Сначала включают саму возможность:

1. Откройте Администрирование → Печатные формы, отчёты и обработки.
2. Поставьте флажок Дополнительные отчёты и обработки.
3. Перейдите по появившейся ссылке Дополнительные отчёты и обработки.

Затем добавляют файл:

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

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

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

• 🧮 Обработка с командой — в меню раздела, который вы отметили;
• 📊 Отчёт — в списке отчётов раздела;
• 🖨 Печатная форма — в меню печати конкретного документа;
• 📝 Заполнение объекта — кнопкой в форме документа или справочника.

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

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

Открытие и отладка в Конфигураторе

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

Что здесь делают:

• 🔍 читают и правят код в модуле объекта и модулях форм;
• 🎨 меняют формы — добавляют поля, кнопки, команды;
• 💾 сохраняют правки обратно в файл через Ctrl+S.

Запустить обработку прямо из Конфигуратора на выполнение нельзя — он не исполняет прикладной код. Чтобы отладить обработку, работают в связке:

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

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

Если обработку планируется встроить в конфигурацию навсегда и обновлять вместе с ней, вместо внешнего файла чаще берут расширение конфигурации (механизм доступен с платформы 8.3.6). Расширение подключается в режиме Предприятие через Администрирование → Печатные формы, отчёты и обработки → Расширения и не отваливается при обновлении типовой конфигурации — в отличие от внешнего .epf, который нужно открывать или подключать заново.

Права и безопасность: почему пункт недоступен

Самая частая проблема — не сам файл, а права. В платформе 8.3 за открытие внешних файлов отвечают два отдельных права роли, которые настраиваются в Конфигураторе:

• Интерактивное открытие внешних обработок — для файлов .epf;
• Интерактивное открытие внешних отчётов — для файлов .erf.

Если право у роли выключено, пункт Файл → Открыть для таких файлов будет недоступен, а программный запуск завершится ошибкой доступа. Включают право администратор или разработчик: Конфигуратор → Роли → нужная роль → вкладка «Права».

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

На серверных базах действие внешнего кода дополнительно ограничивают профили безопасности (security profiles). Если для базы включён профиль, запрещающий внешний код, обработка не откроется даже при включённом праве — пока администратор сервера не разрешит её в профиле. Настраивается это в кластере серверов, через консоль администрирования.

Запуск из командной строки и программно

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

"C:\Program Files\1cv8\8.3.24.1234\bin\1cv8.exe" ENTERPRISE ^
  /F"C:\Base" /N"Иванов" /P"пароль" ^
  /Execute"C:\Обработки\ВыгрузкаВБанк.epf" /C"Параметр"

Разбор ключей:

• ENTERPRISE — запуск в режиме «1С:Предприятие».
• /F"..." — путь к файловой базе; для серверной вместо него /S"сервер\база".
• /N и /P — имя пользователя и пароль.
• /Execute"..." — путь к файлу обработки, которая выполнится сразу после старта.
• /C"..." — строка параметра; внутри обработки её читают через свойство ПараметрЗапуска.

Внутри встроенного языка (в толстом клиенте или на сервере) обработку создают и запускают так:

Обработка = ВнешниеОбработки.Создать("C:\Обработки\ВыгрузкаВБанк.epf");
Обработка.ВыполнитьВыгрузку(); // экспортный метод модуля обработки

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

Выбор между /Execute и регламентным заданием простой. /Execute поднимает отдельный сеанс каждый раз, когда внешний планировщик (например, Планировщик заданий Windows) запускает 1cv8.exe — удобно для разовой ночной выгрузки. Регламентное задание внутри базы не требует запуска платформы снаружи и выполняется на сервере по собственному расписанию — так подключают обработки, которые должны работать постоянно.

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