Файл .epf или .erf в базе 1С 8.3: разовый запуск, регистрация, права и ошибки

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

Типичная ситуация: программист прислал бухгалтеру печатную форму счёта с логотипом или загрузчик выписки из Excel. Файл лежит на рабочем столе, а куда его «вставить» в 1С — непонятно. Разовое открытие решит задачу за минуту, но печатная форма так в меню «Печать» не встанет — для неё нужна регистрация.

Что проверить до подключения внешней обработки

Внешние файлы бывают двух типов:

• 📄 .epf — внешняя обработка: загрузчик, групповое изменение, печатная форма, заполнение табличной части;
• 📊 .erf — внешний отчёт.

Добавляются они одинаково, разница только в том, где потом искать команду.

Перед подключением ответьте себе на четыре вопроса.

1. Для какой конфигурации написан файл. Печатная форма для 1С:Бухгалтерии 3.0 не заработает в УТ 11: у объектов другие реквизиты, и платформа выдаст ошибку при первом же обращении к полю.
2. Поддерживает ли обработка регистрацию. Чтобы файл можно было добавить в справочник дополнительных обработок, в модуле объекта должна быть экспортная функция СведенияОВнешнейОбработке(). Без неё работает только разовое открытие через меню «Файл». Спросите у разработчика или проверьте сами: откройте файл в Конфигураторе и посмотрите модуль объекта.
3. Что обработка делает с данными. Печатная форма и отчёт ничего не меняют. Загрузчик, перепроведение или групповое изменение реквизитов пишут в базу.
4. Откуда файл. Внешняя обработка выполняет произвольный код с правами пользователя. Файл из случайного архива на форуме может удалить документы или отправить данные наружу.

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

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

Самый быстрый вариант. Ничего не регистрируется, файл просто запускается в текущем сеансе.

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

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

💡 Если меню «Файл» не видно, проверьте вид интерфейса. В «Такси» оно спрятано под кнопкой главного меню. Ещё быстрее — перетащить файл .epf мышью прямо в окно 1С.

Почему разовое открытие не всегда подходит

• 🔒 Обычному пользователю в типовых конфигурациях на базе БСП это право по умолчанию не выдают. У администратора всё работает, у бухгалтера — «Нарушение прав доступа!».
• 🖨️ Печатная форма, открытая через «Файл», не встаёт в меню «Печать» документа. Её нужно регистрировать.
• 🌐 В веб-клиенте и облачных сервисах вроде 1С:Фреш произвольный файл с диска не откроется: там подключают только допущенные к использованию обработки через справочник.

Способ 2. Добавить обработку в справочник дополнительных отчётов и обработок

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

Шаг 1. Включите функциональность

Путь к настройке в типовых конфигурациях:

Установите флажок «Дополнительные отчеты и обработки». Рядом станет активной одноимённая ссылка — по ней открывается список.

Шаг 2. Загрузите файл

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

Вид определяет, где появится команда:

• 🖨️ Печатная форма — в меню «Печать» документов или справочников, для которых она написана;
• ✏️ Заполнение объекта — в командах заполнения формы документа;
• 🔗 Создание связанных объектов — в командах «Создать на основании»;
• ⚙️ Дополнительная обработка и 📊 Дополнительный отчёт — в выбранных разделах программы;
• 📋 Отчёт — в форме конкретного объекта.

Шаг 3. Настройте размещение и доступ

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

Для глобальных обработок и отчётов в карточке есть поле размещения. Выберите разделы, где будет команда, например «Банк и касса» для загрузчика выписок.

На вкладке «Команды» можно указать быстрый доступ: каким пользователям команда будет видна сразу, без дополнительной настройки.

Поле «Публикация»:

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

Нажмите «Записать и закрыть».

Шаг 4. Найдите команду

• Печатная форма — откройте документ нужного вида, меню «Печать». Новая форма в конце списка.
• Глобальная обработка — откройте раздел, указанный в размещении, и найдите в панели раздела команду «Дополнительные обработки» или «Дополнительные отчеты».

Если команды нет, сначала перезапустите сеанс: состав команд часто перечитывается только при новом входе.

Пример: загрузчик выписок для двух бухгалтеров

В БП 3.0 программист передал файл ZagruzkaVypiski.epf с видом «Дополнительная обработка». Бухгалтеру Ивановой и бухгалтеру Петровой он нужен, остальным — нет.

1. Администратор загружает файл кнопкой «Добавить из файла».
2. В размещении выбирает раздел «Банк и касса».
3. На вкладке «Команды» в быстром доступе отмечает двух пользователей.
4. Ставит публикацию «Режим отладки», проверяет загрузку на тестовой выписке, затем переключает на «Используется».

Иванова и Петрова после перезахода видят команду в разделе «Банк и касса». Другие пользователи с правом на дополнительные обработки найдут её только в общем списке дополнительных обработок раздела.

Как обновить, выгрузить или отключить подключённую обработку

Разработчик прислал новую версию файла — заводить вторую карточку не нужно.

1. Откройте список дополнительных отчётов и обработок.
2. Откройте карточку нужной обработки.
3. Выберите команду загрузки из файла и укажите новую версию.
4. Сверьте поле версии и сохраните карточку.

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

Чтобы получить файл обратно (например, передать программисту для правки), в карточке есть команда выгрузки в файл.

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

Встроить обработку через Конфигуратор

Третий путь — сделать внешнюю обработку частью конфигурации. Это работа администратора или программиста, а не бухгалтера.

Встраивание в основную конфигурацию

1. Откройте базу в режиме «Конфигуратор».
2. Включите возможность изменения конфигурации, если она на поддержке.
3. В дереве в ветке «Обработки» добавьте новую обработку.
4. Через контекстное меню выберите «Заменить на внешнюю обработку, отчет…» и укажите файл.
5. Добавьте обработку в нужную подсистему и выдайте права в ролях.
6. Выполните «Обновить конфигурацию базы данных» (F7).

Обратная операция — «Сохранить как внешнюю обработку, отчет…» — выгружает встроенный объект в файл .epf.

Расширение вместо правки конфигурации

Если обработка должна стать «своей», но конфигурацию трогать нельзя, программист переносит её в расширение. Расширения появились в платформе 8.3.6. Конфигурация остаётся на поддержке, а расширение подключается отдельным файлом .cfe через Администрирование → Печатные формы, отчеты и обработки → Расширения.

Конфигуратор для отладки

Конфигуратор пригодится и без встраивания. Через Файл → Открыть в нём можно посмотреть модуль и формы внешней обработки, а затем запустить «1С:Предприятие» в режиме отладки и открыть файл там. Так видно, на какой строке кода падает обработка.

Права пользователей на внешние обработки

Права в типовых конфигурациях на базе БСП раздаются группами доступа: Администрирование → Настройки пользователей и прав.

Право на открытие файлов с диска

За открытие через меню «Файл» отвечает роль «Интерактивное открытие внешних отчетов и обработок». Её добавляют в профиль группы доступа пользователя.

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

Доступ к зарегистрированной обработке

Для работы с обработками из справочника нужны:

• 👀 право на использование дополнительных отчётов и обработок — для запуска;
• 🛠️ право на добавление и изменение — только для тех, кто будет загружать файлы, обычно администратор;
• 📌 настройка видимости команды в карточке обработки на вкладке «Команды».

Защита от опасных действий

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

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

Разбор симптомов, которые чаще всего встречаются после подключения:

Если не помогло

• Запустите тот же файл под администратором. Если там работает, проблема в правах, а не в файле.
• Откройте журнал регистрации: Администрирование → Обслуживание → Журнал регистрации, отбор по пользователю и времени. Текст исключения там полнее, чем в окне ошибки.
• Попросите разработчика указать, под какую конфигурацию, релиз и версию платформы написан файл. Обработка под платформу 8.3.20 и новее может не открыться в базе на старой платформе.

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