Внешние обработки 1С: подключение, права и автозапуск

Внешнюю обработку в 1С 8.3 подключают двумя путями: разовый запуск через Главное меню → Файл → Открыть (выбираете файл .epf) и постоянное подключение через список дополнительных отчётов и обработок в разделе Администрирование. Первый способ быстрый, но требует права на интерактивное открытие; второй безопаснее и переживает обновления.

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

Что такое внешняя обработка и когда она нужна

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

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

Когда обработка нужна:

• 🔧 разовая задача — исправить партии товаров, перепровести документы, заполнить реквизит у тысячи элементов;
• 📥 загрузка из внешнего источника — прайс поставщика, выписка банка, файл маркетплейса;
• 🖨 своя печатная форма или дополнительная команда в документе;
• 🧪 диагностика — посмотреть служебные данные, которых нет в интерфейсе.

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

Разовый запуск: открыть файл обработки напрямую

Самый быстрый способ, когда файл нужен один раз.

1. Нажмите кнопку Главное меню — это иконка со стрелкой в левом верхнем углу окна программы.
2. Выберите Файл → Открыть.
3. В диалоге укажите файл .epf и нажмите Открыть.

Откроется форма обработки — дальше работаете в ней. Способ работает и в тонком клиенте, и в толстом.

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

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

Постоянное подключение через дополнительные обработки

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

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

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

Теперь добавьте файл:

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

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

Короткий порядок подключения, чтобы ничего не пропустить:

Какой способ выбрать

Оба способа решают одну задачу по-разному. Коротко — когда что брать.

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

Путь к списку дополнительных обработок одинаков в типовых решениях на Библиотеке стандартных подсистем: Администрирование → Печатные формы, отчёты и обработки. В Бухгалтерии 3.0, ЗУП 3.1 и УТ 11 он не отличается, меняется только набор разделов, куда обработку можно разместить.

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

Прямое открытие и подключение через список — разные права, и часто не хватает именно нужного.

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

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

На практике это выглядит так. Бухгалтеру нужна обработка загрузки выписки раз в день. Если выдать ему интерактивное открытие, он сможет запустить и любой другой файл .epf, в том числе случайно присланный. Безопаснее добавить обработку в список один раз и включить бухгалтера в группу доступа с правом использования: он запускает только эту проверенную обработку, остальные файлы ему недоступны.

Безопасный режим обработки

При добавлении в список каждая обработка получает признак запуска в безопасном режиме. Безопасный режим ограничивает потенциально опасные операции: работу с файловой системой, запуск внешних программ, COM-соединения, обращение к интернету.

Логика простая:

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

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

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

Для клиент-серверной базы одного флажка мало. Выполнение кода в небезопасном режиме на сервере разрешает профиль безопасности (Профиль безопасности), настроенный в консоли администрирования кластера и назначенный информационной базе. Без профиля попытка небезопасной операции на сервере завершится ошибкой, даже если флажок снят. Настройку профиля выполняет администратор сервера.

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

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

Ключ запуска — /Execute. Он запускает модуль внешней обработки сразу после старта программы:

"C:\Program Files\1cv8\8.3.XX.XXXX\bin\1cv8.exe" ENTERPRISE /IBName "Бухгалтерия" /N "Иванов" /P "пароль" /Execute "D:\obrabotki\zagruzka.epf"

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

• ENTERPRISE — запуск в режиме 1С:Предприятие;
• /IBName — имя базы из списка (или /F для файловой базы по пути, /S для серверной);
• /N и /P — пользователь и пароль;
• /Execute — путь к файлу .epf, который нужно выполнить.

Передать в обработку собственные параметры можно ключом /C:

1cv8.exe ENTERPRISE /IBName "Бухгалтерия" /Execute "D:\obrabotki\zagruzka.epf" /C "режим=авто;файл=D:\in\price.xml"

Значение ключа /C обработка читает в своём коде через ПараметрЗапуска. Чтобы запуск шёл без участия человека, в модуле обработки предусматривают выход после выполнения, иначе окно останется открытым.

Несколько практических моментов:

• 🔤 пути с пробелами берите в кавычки целиком, иначе 1С прочитает только первое слово пути;
• 🧾 результат автозапуска обработка обычно пишет в свой файл-лог или в журнал регистрации — через командную строку сообщения на экране вы не увидите;
• 🔁 для повторяемости кладите файл .epf в постоянную папку и не переименовывайте — путь жёстко прописан в команде запуска.

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

Если обработка не подключается

Собрали частые симптомы и что с ними делать.

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

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