Внешняя обработка в базе 1С: загрузка в справочник, разовый запуск и права
Содержание
Чтобы добавить обработку
в 1С 8.3 насовсем, включите флажок Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки, откройте одноимённый список по ссылке рядом и нажмите Добавить из файла. После этого выберите файл .epf (или .erf для отчёта), укажите, где обработка появится в меню, и запишите карточку. Путь одинаковый для 1С:Бухгалтерии 3.0, ЗУП 3.1, УТ 11 и других типовых конфигураций на Библиотеке стандартных подсистем.
Частое заблуждение — «добавить» значит один раз открыть файл через Файл → Открыть. Так обработка только запускается в текущем сеансе: в базе её нет, завтра файл снова придётся искать на диске, а у коллег на других компьютерах её не будет вовсе. Ниже оба варианта и разница между ними.
| Способ | Где хранится обработка | Кто видит | Когда подходит |
|---|---|---|---|
| Загрузка в справочник «Дополнительные отчеты и обработки» | Внутри информационной базы | Все пользователи, которым её назначили | Постоянная работа, печатные формы, заполнение табличных частей |
Файл → Открыть или перетаскивание файла | На диске компьютера | Только тот, кто открыл файл | Разовая задача, проверка, отладка |
Подготовка файла обработки к загрузке
Сначала проверьте сам файл. Это занимает пару минут и избавляет от лишних ошибок при загрузке.
- 📄 Расширение. Обработка —
.epf, отчёт —.erf. Архив.zipсначала распакуйте: 1С не открывает обработку из архива. - 🧩 Поддержка регистрации. Чтобы обработку можно было загрузить в справочник, в её модуле объекта должна быть экспортная функция
СведенияОВнешнейОбработке(). Она сообщает базе вид обработки (печатная форма, заполнение, глобальная и т. д.), версию и команды. Если функции нет, такую обработку можно только открыть через меню. - 🖥 Тип форм. Для интерфейса «Такси» и тонкого клиента нужны управляемые формы. Обработка со старой обычной формой в тонком клиенте и веб-клиенте не откроется.
- 🔢 Версия платформы. Файл, сохранённый в более новой платформе, может не открыться в старой. Номер вашей платформы виден в окне
Справка → О программе; если разработчик указал минимальную версию, ваша должна быть не ниже. - 🔒 Происхождение. Внешняя обработка — это программный код, который выполняется с вашими правами. Берите файлы только у известного разработчика или из проверенного источника.
Если файл прислал разработчик, попросите его сразу сказать вид обработки и объекты, к которым она привязана (например, «печатная форма для документа Реализация»). Это понадобится при настройке карточки.
Как добавить обработку в 1С 8.3 через «Дополнительные отчеты и обработки»
Этот способ сохраняет обработку прямо в базе. В серверной базе она станет доступна на всех компьютерах сразу, файл на диске после загрузки больше не нужен.
Шаг 1. Включите механизм
- Откройте раздел
Администрирование → Печатные формы, отчеты и обработки. - Установите флажок Дополнительные отчеты и обработки.
- Рядом станет активной ссылка с тем же названием — нажмите её.
Флажок включается один раз на всю базу. Если раздела Администрирование в меню нет, у вас нет административных прав — переходите к разделу о правах ниже.
Шаг 2. Загрузите файл
- В списке дополнительных отчетов и обработок нажмите Добавить из файла.
- Платформа покажет предупреждение безопасности о том, что внешний код может навредить базе. Если файл из надёжного источника, подтвердите продолжение.
- Выберите файл
.epfили.erfна диске.
Откроется карточка. Поля Наименование, Вид и Версия заполнятся из функции регистрации — их обычно не трогают.
Шаг 3. Настройте, где обработка появится
Что заполнять, зависит от вида, указанного в карточке:
| Вид в карточке | Что настроить | Где пользователь её найдёт |
|---|---|---|
| Дополнительная обработка / Дополнительный отчет | Размещение: разделы меню | В выбранном разделе, в списке дополнительных обработок или отчётов |
| Печатная форма | Назначение: документы или справочники | В меню Печать формы документа |
| Заполнение объекта | Назначение: документы | В командах заполнения документа |
| Создание связанных объектов | Назначение: объекты-основания | В командах создания на основании |
Для глобальных обработок перейдите на вкладку размещения и отметьте разделы, например «Продажи» или «Склад». Для печатных форм и заполнения список объектов обычно уже заполнен разработчиком — проверьте, что там нужные документы.
Шаг 4. Выберите режим публикации и запишите
Поле Публикация принимает три значения:
- ✅ Используется — обработка работает у всех, кому доступна.
- 🧪 Режим отладки — видна только администраторам. Удобно проверить новую версию до того, как её увидят пользователи.
- ⛔ Отключена — обработка остаётся в базе, но в меню её нет.
Нажмите Записать и закрыть. Теперь откройте раздел или документ, который указали в размещении, и проверьте, что команда появилась.
На вкладке команд в карточке можно включить Быстрый доступ для конкретных пользователей: команда окажется у них на виду без поиска по разделу.
Как обновить обработку новой версией
Новую версию не добавляют вторым элементом — так появятся две одинаковые команды. Откройте существующую карточку и загрузите файл через команду загрузки из файла в её командной панели. Номер версии в карточке обновится, настройки размещения и быстрого доступа сохранятся. Старую версию можно предварительно выгрузить в файл из той же карточки — на случай отката.
Разовый запуск: меню «Файл» и перетаскивание файла в окно
Когда обработка нужна один раз — свернуть остатки, проверить данные, выгрузить список, — загружать её в справочник не обязательно.
Через главное меню
- Нажмите кнопку главного меню (значок с тремя полосками в левом верхнем углу) или
Ctrl+O. - Выберите
Файл → Открыть. - Укажите файл
.epfи подтвердите предупреждение безопасности.
Форма обработки откроется сразу. Закрыли базу — обработка из неё «исчезла», файл остался там же на диске.
Перетаскиванием (Drag-and-Drop)
Перетащите файл .epf из проводника Windows прямо в окно работающей 1С. Результат тот же, что у Файл → Открыть: обработка открывается в текущем сеансе, с тем же предупреждением и теми же требованиями к правам. Это просто короткий путь, а не отдельный механизм загрузки.
Перетаскивание работает в тонком и толстом клиенте под Windows. В веб-клиенте и при работе через удалённый рабочий стол (RemoteApp) перенос файлов с локального компьютера часто ограничен — там надёжнее меню Файл → Открыть.
Обработка, открытая из файла, может менять данные так же, как загруженная в базу. Перед запуском незнакомой обработки, которая что-то записывает, сделайте резервную копию базы.
Открыть обработку в Конфигураторе
Если нужно посмотреть код или поправить форму, откройте файл в Конфигураторе через Файл → Открыть. Изменения сохраняются в тот же .epf командой Файл → Сохранить. Конфигурацию базы это не затрагивает, монопольный доступ не требуется.
Права пользователей на добавление и запуск обработок
Права делятся на два уровня: кто может загружать обработки в базу и кто может их запускать.
Кто может добавлять
В типовых конфигурациях загружать и менять дополнительные обработки по умолчанию могут пользователи из группы доступа Администраторы. Чтобы дать это право бухгалтеру без полного администрирования:
- Откройте
Администрирование → Настройки пользователей и прав → Группы доступа. - Создайте отдельную группу или откройте существующую и посмотрите её профиль.
- В профиле должна быть роль, отвечающая за добавление и изменение дополнительных отчетов и обработок. Найдите её в списке ролей профиля поиском по слову «дополнительных».
- Включите пользователя в эту группу.
Профили групп доступа в типовых конфигурациях на поддержке менять нельзя — для своих настроек скопируйте профиль и правьте копию.
Кто может запускать загруженную обработку
Загруженную обработку пользователь увидит, если она размещена в доступном ему разделе и включена в публикацию. Отдельного права на сам файл не нужно: код хранится в базе и запускается из справочника.
Кто может открывать файлы с диска
Открытие .epf через Файл → Открыть требует права Интерактивное открытие внешних обработок (для отчётов — отдельное право на внешние отчёты). У рядовых ролей типовых конфигураций его обычно нет — это сознательная защита: так пользователь не запустит случайный код из интернета.
Ещё один слой — защита от опасных действий в свойствах пользователя информационной базы. При включённой защите платформа показывает предупреждение перед открытием внешнего файла. Отключать её ради удобства не стоит.
Если бухгалтеру регулярно нужна одна и та же обработка, загрузите её в справочник и назначьте ему, а не выдавайте право открывать любые файлы с диска.
Файловая и клиент-серверная база: что меняется при подключении
Для пользователя шаги одинаковые. Различие — в том, где выполняется код и какие ресурсы ему доступны.
| Вопрос | Файловая база | Клиент-серверная база |
|---|---|---|
| Где хранится загруженная обработка | В файле базы 1Cv8.1CD | В базе данных на сервере СУБД |
| Где выполняется серверный код обработки | На компьютере пользователя (в файловом режиме) | В рабочем процессе сервера 1С |
| Под кем идёт обращение к файлам и папкам | Под учётной записью пользователя Windows | Под учётной записью службы сервера 1С (часто USR1CV8) |
| Чем ограничивается небезопасный код | Безопасным режимом в карточке обработки | Безопасным режимом и профилями безопасности кластера |
Из таблицы вытекают три практических следствия.
Пути к файлам
Обработка, которая читает или пишет файлы в серверной базе, видит диск сервера, а не ваш. Путь C:\Users\Buh\Desktop\price.xlsx на сервере не существует. Используйте сетевую папку, к которой у службы сервера 1С есть права, или обработку, которая сама передаёт файл с клиента на сервер.
Безопасный режим
Загруженные дополнительные обработки по умолчанию выполняются в безопасном режиме. В нём нельзя обращаться к файловой системе, COM-объектам и внешним компонентам. Если обработке это нужно (загрузка из Excel , выгрузка на диск), в карточке появится запрос разрешений, который подтверждает администратор. Отключать безопасный режим для обработки неизвестного происхождения нельзя.
Профили безопасности
В клиент-серверном варианте администратор сервера может настроить профили безопасности в консоли администрирования кластера: какие каталоги, COM-классы и адреса разрешены внешнему коду. Если профиль назначен базе, обработка получит только перечисленные ресурсы, даже с отключённым безопасным режимом в карточке.
Настройку профилей безопасности на работающем сервере делайте вне рабочего времени: при ошибке в профиле пользователи перестанут выполнять операции, которые раньше работали.
Ошибки при добавлении обработки в 1С 8.3 и как их исправить
Сначала найдите свой симптом в диагностике ниже.
Ещё две ошибки, которые не дают сообщения, но портят работу:
- 🔁 Две одинаковые печатные формы в меню. Новую версию добавили вторым элементом вместо обновления существующего. Отключите старый элемент или пометьте его на удаление.
- 🗂 Обработка работает у администратора, а у бухгалтера нет. Чаще всего она висит в публикации «Режим отладки». Переключите на «Используется».
Частые вопросы
Можно ли загрузить одну обработку в несколько баз?
Обработка пропадёт после обновления конфигурации?
Как удалить ненужную обработку?
Можно ли выгрузить обработку из базы обратно в файл?
Чем внешняя обработка отличается от расширения конфигурации?
.cfe) встраивается в конфигурацию и может менять её формы и поведение. Для разовых задач и печатных форм обычно хватает обработки.