Подключение файла .epf к разделу «Дополнительные обработки» в 1С 8.3
Содержание
Чтобы добавить внешнюю обработку
в панель дополнительных, откройте Администрирование → Печатные формы, отчеты и обработки, включите флажок «Дополнительные отчеты и обработки», перейдите по одноимённой ссылке и нажмите «Добавить из файла…». Затем в карточке укажите разделы размещения и пользователей — и команда появится в разделе в группе «Сервис».
Путь одинаков для конфигураций на Библиотеке стандартных подсистем (БСП): Бухгалтерия 3.0, ЗУП 3.1, Управление торговлей 11, Комплексная автоматизация, ERP, УНФ. Отличия между ними — только в названиях разделов, куда вы размещаете команду.
Как устроен механизм дополнительных отчётов и обработок
Внешний файл можно открыть двумя способами. Первый — через Файл → Открыть в тонком клиенте: разово, без регистрации, с предупреждением безопасности. Второй — зарегистрировать его в справочнике «Дополнительные отчеты и обработки». Второй способ и есть «добавить в панель дополнительных».
Что даёт регистрация:
- 📦 Файл хранится в самой базе. После загрузки исходный .epf можно удалить с диска — 1С возьмёт обработку из информационной базы. Это работает и в файловом варианте, и в клиент-серверном.
- 🧭 Команда встраивается в интерфейс. Обработка появляется в нужном разделе, а печатная форма — в меню «Печать» документа.
- 👥 Доступ настраивается по пользователям. Кому-то команда видна на панели, кому-то нет.
- ⏰ Можно запускать по расписанию. Серверные команды обработки становятся регламентными заданиями.
Регистрацию принимает не любой файл. Внутри обработки должна быть экспортная функция СведенияОВнешнейОбработке() в модуле объекта. Она сообщает программе вид обработки, её версию, список команд и объекты, к которым она относится. Обработку «для открытия через Файл → Открыть» без этой функции зарегистрировать нельзя — нужно доработать файл.
| Вид в карточке | Где появится команда |
|---|---|
| Дополнительная обработка | В разделе, группа «Сервис» → «Дополнительные обработки» |
| Дополнительный отчёт | В разделе, «Дополнительные отчеты» |
| Печатная форма | В меню «Печать» документов или справочников из назначения |
| Заполнение объекта | В командах заполнения формы документа |
| Создание связанных объектов | В командах «Создать на основании» объекта |
| Отчёт (контекстный) | В форме объекта, к которому он привязан |
Вид задаёт разработчик внутри файла. В карточке его поменять нельзя — только посмотреть.
Что подготовить до регистрации обработки
Перед тем как подключить файл, проверьте три вещи. Это занимает пару минут и снимает половину вопросов «почему не добавляется».
- Формы обработки управляемые. Обработка с обычными формами не откроется в тонком и веб-клиенте. Для Такси-интерфейса нужен файл, сделанный под управляемое приложение.
- Файл написан под вашу конфигурацию. Обработка для Бухгалтерии не обязана работать в ЗУП, даже если регистрируется. Она обращается к конкретным справочникам и регистрам, и в чужой базе их может не быть.
- У вас есть права. Добавлять обработки может пользователь с полными правами или с профилем, в названии которого есть «Добавление и изменение дополнительных отчетов и обработок».
Храните все рабочие .epf и .erf в одной сетевой папке с понятными именами и номером версии: ЗагрузкаЦен_v1.3.epf. Сама база путь к папке не запоминает — регистрация копирует файл внутрь. Но папка нужна, чтобы через полгода понять, какая версия загружена и где лежит исходник для правки.
Внешний файл выполняет любой код с правами пользователя, который его запустил. Загружайте только обработки от разработчика, которому доверяете. Обработку из интернета сначала откройте в Конфигураторе и посмотрите модуль: нет ли там удаления данных или отправки базы куда-то вовне.
Пошагово: как добавить внешнюю обработку в 1С
Шаг 1. Включите функциональность
- Откройте раздел
Администрирование → Печатные формы, отчеты и обработки. - Установите флажок «Дополнительные отчеты и обработки».
- Рядом с флажком станет активной ссылка «Дополнительные отчеты и обработки» — откройте её.
Флажок включается один раз на базу. Без него ссылка неактивна, и в разделах нет команд «Дополнительные обработки».
Шаг 2. Загрузите файл
- В списке нажмите «Добавить из файла…».
- Появится предупреждение безопасности о том, что внешний код может навредить базе. Нажмите «Продолжить».
- Выберите файл с расширением
.epf(обработка) или.erf(отчёт).
Если файл подходит, сразу откроется карточка новой обработки. Наименование, версия и вид уже заполнены из файла.
Шаг 3. Настройте публикацию
В поле «Публикация» доступны три значения:
| Значение | Что значит | Когда выбирать |
|---|---|---|
| Используется | Обработка работает у всех, кому назначена | Рабочий режим |
| Режим отладки | Обработка доступна для проверки администратором | Тестирование новой версии |
| Отключена | Обработка хранится, но нигде не видна | Временно убрать, не удаляя |
Шаг 4. Укажите размещение
Для видов «Дополнительная обработка» и «Дополнительный отчёт» найдите в карточке поле «Размещение» — по умолчанию там стоит «Не определено». Нажмите на него и отметьте разделы: например, «Продажи» и «Склад». Без этого шага обработка зарегистрирована, но в панели её не найти.
Для печатных форм и обработок заполнения размещение задаётся иначе — через назначение. Список объектов (например, документ «Реализация (акт, накладная, УПД)») обычно приходит из файла. Проверьте его на вкладке с назначением и при необходимости добавьте объекты вручную.
Шаг 5. Настройте команды и быстрый доступ
В табличной части команд перечислено, что умеет обработка. Для каждой команды можно:
- 👤 задать быстрый доступ — выбрать пользователей, у которых команда окажется прямо на панели раздела;
- ⏰ задать расписание — только для команд серверного вызова, они станут регламентным заданием.
Шаг 6. Сохраните и проверьте
Нажмите «Записать и закрыть». Перейдите в раздел из размещения, в группе «Сервис» откройте «Дополнительные обработки» и запустите команду. Если вы добавили себя в быстрый доступ, команда будет видна на панели без лишних кликов.
Как обновить уже загруженную обработку
Разработчик прислал новую версию — не добавляйте её второй раз. Появится дубль, и пользователи запутаются, какая из двух рабочая.
Правильно так:
- Откройте карточку зарегистрированной обработки.
- В меню «Ещё» выберите загрузку обработки из файла.
- Укажите новый файл и запишите карточку.
Размещение, быстрый доступ и расписание сохранятся. Версия в карточке обновится из файла.
Там же, в «Ещё», есть обратная команда — выгрузка обработки в файл. Она выручает, когда исходник потерян, а обработку нужно отдать программисту на доработку.
Если обработка работает по расписанию, обновляйте её вне рабочего окна регламентного задания. Иначе задание может стартовать посередине замены и завершиться ошибкой.
Права пользователей и персональная настройка панели
Здесь две разные задачи: кто может добавлять обработки и кто может пользоваться ими.
Добавление и изменение. Даётся через группы доступа: Администрирование → Настройки пользователей и прав → Группы доступа. Найдите или создайте группу с профилем, где разрешено добавление и изменение дополнительных отчётов и обработок, и включите в неё нужного сотрудника. Обычно это главный бухгалтер или ответственный за 1С.
Использование. Рядовой пользователь видит обработку, если у него есть доступ к разделу, в котором она размещена, и права на данные, с которыми она работает. Обработка не расширяет права: если бухгалтер не видит зарплату, обработка по зарплате у него выдаст ошибку доступа или пустой результат.
Персональная настройка делается через быстрый доступ:
- 👥 у бухгалтера по банку на панели «Банк и касса» — обработка загрузки выписок;
- 👥 у кладовщика на панели «Склад» — обработка печати этикеток;
- 👥 у остальных эти команды не мешают, но доступны через «Дополнительные обработки», если нужны.
Пользователь может и сам вынести команду ближе: в разделе через «Настройки навигации» или «Настройки действий» добавить её на панель. Это личная настройка и на других не влияет.
Безопасный режим и внешние ресурсы
Зарегистрированные обработки в современных версиях БСП выполняются в безопасном режиме. Если обработке нужно работать с файлами на диске, COM-объектами или интернетом, она запрашивает разрешения. При регистрации 1С покажет окно с перечнем запрошенных ресурсов — администратор подтверждает его.
В клиент-серверном варианте с включёнными профилями безопасности кластера эти разрешения применяются на сервере. Если администратор сервера профили не настроил, а обработка просит внешние ресурсы, регистрация может не пройти — это вопрос к тому, кто администрирует кластер.
Почему обработка не добавляется или не видна в панели
Ещё одна частая причина — дубли. Если обработку добавили дважды, в списке «Дополнительные обработки» видны две команды с одинаковым названием. Отключите лишнюю или пометьте её на удаление, а рабочую обновляйте только загрузкой файла в существующую карточку.
Если после правки размещения команда не появилась, перезапустите сеанс 1С. Командный интерфейс раздела кешируется и обновляется при новом входе.
Работа в веб-клиенте, тонком клиенте и в облаке
Регистрация через справочник — единственный нормальный способ работы с внешними обработками в веб-клиенте. Команды Файл → Открыть для произвольного .epf там нет.
| Клиент | Разовое открытие .epf | Регистрация в «Дополнительных» |
|---|---|---|
| Тонкий клиент | Да, через Файл → Открыть, с предупреждением безопасности | Да |
| Веб-клиент | Нет | Да, файл выбирается через браузер |
| Облачная 1С (сервис по подписке) | Зависит от правил провайдера | Обычно да, иногда с проверкой файла провайдером |
Особенности веб-клиента:
- 🌐 При выборе файла браузер может попросить установить расширение для работы с файлами. Согласитесь — без него часть операций с файлами недоступна.
- 🌐 Код обработки исполняется на сервере 1С, а не на компьютере пользователя. Если обработка читает файл с локального диска, он сначала должен быть загружен на сервер через диалог выбора.
- 🌐 Обработки, которые используют COM-объекты на клиенте (например, Excel через COM), в браузере не заработают.
В тонком клиенте разовое открытие через Файл → Открыть в платформе 8.3 сопровождается предупреждением о небезопасном действии. Это защита от опасных действий, она включается в свойствах пользователя информационной базы. Отключать её ради удобства не стоит: проще один раз зарегистрировать обработку в справочнике — тогда предупреждение при каждом запуске не появляется.
В облачных сервисах провайдер нередко разрешает только обработки, прошедшие его проверку, или запрещает расширенные разрешения. Перед покупкой обработки уточните у разработчика, работает ли она в вашем облаке.