Файл .epf в базе 1С 8.3: разовый запуск, регистрация для всех и права на открытие
Содержание
Чтобы загрузить внешнюю обработку
в 1С 8.3 один раз, откройте главное меню (кнопка с тремя полосками в левом верхнем углу), выберите Файл → Открыть и укажите файл .epf. Чтобы обработка была у всех пользователей в меню раздела, её регистрируют в справочнике дополнительных обработок: Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки.
Первый способ подходит для разовой задачи: перезаполнить реквизит, выгрузить данные, проверить гипотезу. Второй — для обработки, которой будут пользоваться постоянно: она хранится в самой базе, не теряется вместе с папкой «Загрузки» и запускается без лишних предупреждений. Третий путь — встроить код в конфигурацию или расширение через Конфигуратор. Его выбирают, когда обработка становится частью учёта.
Какой способ загрузки обработки выбрать
| Способ | Когда выбирают | Кто может | Что учесть |
|---|---|---|---|
Файл → Открыть | Разовый запуск, проверка | Пользователь с правом на интерактивное открытие | Предупреждение безопасности при каждом новом сеансе |
| Дополнительные обработки | Постоянная работа, печатные формы, заполнение документов | Администратор базы | Обработка должна быть написана под этот механизм |
| Конфигуратор: в конфигурацию или расширение | Обработка нужна всегда и навсегда | Программист | Изменение конфигурации, обновление структуры базы |
Командная строка /Execute | Автоматический запуск, ночные задания | Администратор | Пароль пользователя попадает в bat-файл |
Подготовка файла перед загрузкой в 1С
До загрузки проверьте три вещи. Это занимает две минуты и снимает большую часть проблем.
- 📁 Расширение файла. Обработка —
.epf, внешний отчёт —.erf. Если пришёл архив, сначала распакуйте его. Открывать.epfпрямо из архива нельзя: 1С увидит временный путь, который исчезнет. - 🧩 Под какую конфигурацию написана. Обработка обращается к справочникам и документам по именам. Файл, сделанный для УТ 11, в Бухгалтерии 3.0 упадёт на первом же обращении к несуществующему объекту.
- 🖥️ Тип форм. Обработки с управляемыми формами работают в тонком клиенте и веб-клиенте. Старые обработки с обычными формами открываются только в толстом клиенте.
- 🔒 Источник. Внешняя обработка выполняет любой код с правами пользователя, который её запустил. Файл от незнакомого «фрилансера» может удалить данные или отправить их наружу.
Перед запуском обработки, которая меняет данные, сделайте резервную копию базы. Групповое перезаполнение реквизитов или перепроведение не отменяется кнопкой «Назад».
Файл удобно хранить в постоянной папке, например C:\1C\Обработки\, а не на рабочем столе. Так проще найти его снова и понять, какая версия у вас в работе.
Как открыть внешнюю обработку в 1С через меню Файл
Это самый быстрый способ загрузить обработку в 1С Предприятие. Подходит для Бухгалтерии 3.0, ЗУП 3.1, УТ 11, ERP и любой другой конфигурации на платформе 8.3.
- Запустите базу в режиме 1С:Предприятие.
- Нажмите кнопку главного меню в левом верхнем углу окна.
- Выберите
Файл → Открытьили нажмитеCtrl+O. - Укажите файл
.epfи нажмите «Открыть». - Появится окно «Предупреждение безопасности». Если вы доверяете файлу, нажмите «Да».
- Обработка откроется в новой вкладке. Работайте с ней как с обычной формой.
Предупреждение безопасности появилось в платформе 8.3.9 и связано с механизмом защиты от опасных действий. В рамках одного сеанса повторно для того же файла оно обычно не показывается. После перезапуска 1С вопрос будет снова.
Отключить предупреждение можно в свойствах пользователя: в Конфигураторе Администрирование → Пользователи, карточка пользователя, флажок «Защита от опасных действий». Делайте это только для опытных сотрудников: предупреждение защищает от случайного запуска чужого кода.
В веб-клиенте путь тот же, только файл сначала загружается в браузер. В клиент-серверной базе файл передаётся на сервер автоматически, класть его в сетевую папку для сервера 1С не нужно.
Регистрация обработки в справочнике дополнительных обработок
Если обработкой пользуются каждый день, её лучше один раз загрузить в базу. Механизм входит в Библиотеку стандартных подсистем, поэтому есть во всех современных типовых конфигурациях.
| Конфигурация | Где включить и найти |
|---|---|
| Бухгалтерия 3.0, ЗУП 3.1 | Администрирование → Печатные формы, отчеты и обработки |
| УТ 11, КА 2, ERP | НСИ и администрирование → Печатные формы, отчеты и обработки |
Шаг 1. Включите механизм
В разделе «Печатные формы, отчеты и обработки» установите флажок «Дополнительные отчеты и обработки». Под ним станет активна ссылка на одноимённый справочник.
Шаг 2. Добавьте файл
- Откройте справочник «Дополнительные отчеты и обработки».
- Нажмите «Добавить из файла…».
- Подтвердите предупреждение безопасности и укажите файл
.epfили.erf. - Программа прочитает из файла вид, название и список команд и заполнит карточку.
Вид определяется самой обработкой: дополнительная обработка, дополнительный отчёт, печатная форма, заполнение объекта, создание связанных объектов. Поменять его в карточке нельзя.
Шаг 3. Настройте размещение и доступ
- 📌 Размещение. Для дополнительной обработки или отчёта выберите разделы, где появится команда. Например, «Продажи» или «Зарплата и кадры».
- 📄 Назначение. Для печатной формы и заполнения укажите документы или справочники, в форме которых появится кнопка.
- 👥 Быстрый доступ. В таблице команд отметьте пользователей, которым команда видна в разделе сразу.
- 🔘 Публикация. Значение «Используется» включает обработку, «Отключена» прячет её без удаления, «Режим отладки» показывает её только администраторам.
Нажмите «Записать и закрыть». Команда появится в разделе, обычно в группе «Сервис» или в подменю «Дополнительные обработки».
Почему файл не добавляется
Регистрировать можно только обработку, написанную под этот механизм. В модуле объекта у неё должна быть экспортная функция СведенияОВнешнейОбработке(), которая сообщает вид, версию и команды. Обычную обработку без этой функции программа добавить откажется. Тогда остаются два пути: открывать её через Файл → Открыть или попросить разработчика доработать модуль.
Как обновить зарегистрированную версию
Когда разработчик присылает новую версию, не создавайте вторую карточку. Откройте существующую, нажмите «Загрузить из файла…» и выберите новый .epf. Настройки размещения и быстрого доступа сохранятся.
Встраивание обработки через Конфигуратор
Иногда обработку нужно сделать постоянной частью базы, а не внешним файлом. Это работа программиста, но порядок полезно знать.
Открыть и посмотреть код
В Конфигураторе выберите Файл → Открыть и укажите .epf. Откроется дерево обработки: формы, макеты, модуль объекта. Так проверяют, что делает чужой файл, до запуска в рабочей базе. Здесь же можно исправить код и сохранить файл
командой Файл → Сохранить.
Перенести в расширение
Типовую конфигурацию
лучше не снимать с поддержки. Чище создать расширение
(Конфигурация → Расширения конфигурации), добавить в него новую обработку и перенести туда реквизиты, формы и модули. После этого расширение обновляется в базе одной командой и переживает обновление типовой.
Перенести в саму конфигурацию
Для самописных конфигураций обработку добавляют в ветку «Обработки» дерева конфигурации. После переноса нужно выполнить Конфигурация → Обновить конфигурацию базы данных (F7).
Обновление конфигурации базы данных с изменением структуры требует, чтобы в базе не было других пользователей. Предупредите сотрудников: их сеансы придётся завершить. Делайте это вне рабочего времени и после резервной копии.
Права доступа на загрузку внешних обработок
Самая частая жалоба: администратор открывает обработку, а бухгалтер получает ошибку Нарушение прав доступа!. Причина в том, что открытие внешних файлов — отдельное право.
На уровне платформы оно называется «Интерактивное открытие внешних обработок» (для отчётов — отдельное право на внешние отчёты). В типовых конфигурациях на БСП право входит в роль «Интерактивное открытие внешних отчетов и обработок».
Как выдать право в типовой конфигурации
- Откройте
Администрирование → Настройки пользователей и прав → Группы доступа(в УТ 11 — черезНСИ и администрирование). - Создайте группу доступа на основе профиля, в который входит роль «Интерактивное открытие внешних отчетов и обработок». В поставке БСП обычно есть готовый профиль с похожим названием. Если его нет, создайте свой профиль в справочнике «Профили групп пользователей» и отметьте эту роль.
- Добавьте в группу нужных пользователей.
- Пользователь должен перезапустить 1С: права применяются к новому сеансу.
Права и зарегистрированные обработки
Для обработки из справочника дополнительных обработок это право не нужно. Пользователь запускает её командой из раздела, а доступ регулирует администратор через быстрый доступ и роли на работу с дополнительными обработками.
Отсюда практичный приём: не раздавайте право на интерактивное открытие всем подряд. Оставьте его администраторам, а рабочие обработки регистрируйте в базе. Тогда случайный файл из почты сотрудник не запустит.
В клиент-серверной базе внешние обработки дополнительно ограничиваются профилями безопасности кластера. Если администратор сервера их включил, обработка без разрешённого профиля будет работать в безопасном режиме и не получит доступ к файлам и внешним программам.
Ошибки при загрузке обработки и что с ними делать
Если ошибка возникает только в одной базе, а в копии работает, проверьте релиз конфигурации. Обработка, сделанная под релиз годичной давности, может обращаться к реквизитам, которые потом переименовали.
Автоматический и пакетный запуск обработок
Обработку можно запустить без ручного открытия. Это пригодится для ночных выгрузок, загрузки прайсов, перепроведения по расписанию.
Параметр командной строки /Execute
Платформа умеет открыть внешнюю обработку сразу после входа в базу. Пример bat-файла для файловой базы:
@echo off
start "" /wait "C:\Program Files\1cv8\8.3.25.1374\bin\1cv8.exe" ENTERPRISE ^
/F"D:\Bases\Buh" ^
/N"Регламент" /P"пароль" ^
/Execute"C:\1C\Обработки\Выгрузка.epf" ^
/DisableStartupMessages
Номер версии в пути замените на установленный у вас. Для серверной базы вместо /F укажите /S"сервер\имябазы". Чтобы передать обработке параметр, добавьте /C"строка": в коде её читают через глобальное свойство ПараметрЗапуска.
Сама обработка должна уметь работать без человека: выполнить действие при открытии формы и завершить сеанс. Обычную интерактивную обработку /Execute просто откроет и оставит ждать нажатия кнопки.
Пароль в bat-файле лежит открытым текстом. Создайте отдельного пользователя только с нужными правами и ограничьте доступ к файлу. Запускайте через Планировщик заданий Windows от служебной учётной записи.
Запуск по расписанию из базы
В справочнике дополнительных обработок для команд типа «Вызов серверного метода» можно задать расписание. Тогда обработка выполняется как регламентное задание на сервере, без открытого клиента. Это надёжнее bat-файла: не нужен пароль в файле и сеанс пользователя.
Для файловой базы регламентные задания выполняются, только пока кто-то работает в программе или база опубликована на веб-сервере. Если нужен гарантированный запуск ночью, в файловом варианте остаётся планировщик Windows.
Несколько обработок подряд
Пакетный запуск разных файлов делают двумя способами. Первый — несколько строк с /Execute в одном bat-файле, каждая следующая стартует после завершения предыдущего сеанса благодаря start /wait и прямому вызову 1cv8.exe (лаунчер 1cestart.exe ждать не умеет). Второй — одна управляющая серверная обработка, зарегистрированная в базе и вызывающая нужные действия по очереди.