Внешние обработки и отчёты в 1С 8.3: зачем они бухгалтеру и как их запустить
Содержание
Внешняя обработка 1С — это файл с расширением .epf, который подключается к базе снаружи, без изменения конфигурации. Запустить его можно двумя путями: разово через меню Файл → Открыть или постоянно — через Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки (в БП 3.0 и ЗУП 3.1).
Зачем нужны внешние обработки: чтобы добавить печатную форму, загрузку из Excel, групповое исправление документов или свой отчёт, не снимая базу с поддержки. Типовое обновление такие доработки не затирает, а программист может поправить файл за час, не трогая рабочую конфигурацию.
Чем внешняя обработка отличается от внешнего отчёта
Оба объекта живут вне конфигурации и устроены похоже. Разница — в назначении и в том, что внутри.
| Признак | Внешняя обработка | Внешний отчёт |
|---|---|---|
| Расширение файла | .epf | .erf |
| Задача | Что-то сделать с данными: заполнить, загрузить, исправить, распечатать | Показать данные: выборка, группировки, итоги |
| Основа | Модуль объекта и форма с командами | Обычно схема компоновки данных (СКД) с вариантами настроек |
| Изменяет данные базы | Может (и часто для этого и пишется) | Как правило, нет — только читает |
| Программный менеджер | ВнешниеОбработки | ВнешниеОтчеты |
Отдельно стоят расширения конфигурации
(.cfe). Это уже не внешний файл, а встроенная в базу доработка: она может менять типовые формы и модули. Внешняя обработка так не умеет — она только добавляет новое рядом с типовым.
Правило выбора простое. Нужна новая кнопка, печатная форма или разовая операция — хватит внешней обработки. Нужно поменять поведение типового документа — это задача для расширения.
Где внешние обработки помогают в работе
Внешние обработки 1С закрывают задачи, под которые фирма не стала делать типовой механизм. Самые частые сценарии:
- 🖨️ Печатные формы. Счёт со своим логотипом, акт с дополнительными колонками, бланк для конкретного контрагента. Команда появляется прямо в меню «Печать» документа.
- 📥 Загрузка данных. Номенклатура, контрагенты, остатки из Excel или выписок, которые типовая загрузка не принимает.
- 🔧 Групповая обработка. Перепровести, заполнить реквизит, поменять счёт учёта у сотни документов за один проход.
- 📊 Дополнительные отчёты. Своя аналитика по продажам, оборотам, задолженности — с вариантами настроек.
- 📝 Заполнение табличных частей. Кнопка «Заполнить» в документе, которая подставляет строки по вашим правилам.
- 🧹 Служебные операции. Поиск дублей, выгрузка в сторонние системы, проверка данных перед закрытием месяца.
Многие поставщики сервисов (банки, маркетплейсы, транспортные компании) распространяют свои модули интеграции именно как внешние обработки. Это удобно: их не нужно встраивать в конфигурацию.
Сколько стоит заказать обработку
Цена зависит от объёма работы программиста. Ориентировочные вилки на рынке:
| Задача | Примерная стоимость |
|---|---|
| Простая печатная форма по готовому макету | 3–10 тыс. ₽ |
| Групповое заполнение или исправление реквизита | 5–15 тыс. ₽ |
| Загрузка из Excel с сопоставлением справочников | 10–30 тыс. ₽ |
| Отчёт на СКД с несколькими вариантами | 10–25 тыс. ₽ |
| Интеграция с внешним сервисом | от 30 тыс. ₽ |
Перед заказом опишите задачу на примере: приложите образец документа или таблицы и укажите конфигурацию с номером релиза. Так оценка будет точнее, а обработка — без переделок.
Как устроен файл обработки и где он хранится
Файл .epf или .erf — это бинарный контейнер. Внутри: модуль объекта, модули форм, макеты (например, табличный документ печатной формы), реквизиты и табличные части.
Открыть и править его можно в Конфигураторе через Файл → Открыть. Для хранения в системе контроля версий Конфигуратор умеет выгружать внешнюю обработку
в набор XML-файлов и собирать её обратно — команды есть в меню Файл.
Где обработка «живёт» после подключения, зависит от способа:
| Способ | Где хранится | Что будет при переносе базы |
|---|---|---|
| Разовое открытие файла | На диске пользователя или в сетевой папке | Файл нужно переносить отдельно |
| Справочник «Дополнительные отчеты и обработки» | Внутри информационной базы | Переезжает вместе с базой и её резервной копией |
Второй вариант надёжнее. Файл на диске после регистрации можно удалить — база держит свою копию. Обновить её можно, загрузив новую версию файла из карточки обработки.
Требования к файлу для регистрации
Чтобы обработку можно было добавить в справочник, в её модуле объекта должна быть экспортная функция СведенияОВнешнейОбработке(). Она сообщает программе вид обработки, версию, команды и объекты, к которым она привязана. Типовой каркас на основе Библиотеки стандартных подсистем (БСП) выглядит так:
Функция СведенияОВнешнейОбработке() Экспорт
ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке();
ПараметрыРегистрации.Вид = ДополнительныеОтчетыИОбработкиКлиентСервер.ВидОбработкиДополнительнаяОбработка();
ПараметрыРегистрации.Версия = "1.0";
ПараметрыРегистрации.БезопасныйРежим = Истина;
Команда = ПараметрыРегистрации.Команды.Добавить();
Команда.Представление = "Выполнить обработку";
Команда.Идентификатор = "ВыполнитьОбработку";
Команда.Использование = ДополнительныеОтчетыИОбработкиКлиентСервер.ТипКомандыОткрытиеФормы();
Возврат ПараметрыРегистрации;
КонецФункции
Нет этой функции — файл можно только открыть разово, но не зарегистрировать. Это самая частая причина, почему «скачанная обработка не добавляется».
Как подключить внешнюю обработку: два способа
Выбор способа зависит от того, как часто вы будете ей пользоваться и кто ещё в базе должен её видеть.
Способ 1. Открыть файл разово
- В программе нажмите кнопку главного меню (значок с тремя полосками в левом верхнем углу).
- Выберите
Файл → Открытьили нажмитеCtrl+O. - Укажите файл
.epfили.erfна диске. - Если платформа покажет предупреждение безопасности, прочитайте его и подтвердите открытие только для файла из надёжного источника.
- Откроется форма обработки — работайте с ней как с обычным окном программы.
После закрытия формы ничего не сохраняется. В следующий раз файл придётся открыть снова.
Способ 2. Добавить в дополнительные отчёты и обработки
Сначала включите сам механизм. Пути в типовых конфигурациях:
| Конфигурация | Где включить |
|---|---|
| 1С:Бухгалтерия 3.0 | Администрирование → Печатные формы, отчеты и обработки |
| 1С:ЗУП 3.1 | Администрирование → Печатные формы, отчеты и обработки |
| 1С:Управление торговлей 11 | НСИ и администрирование → Печатные формы, отчеты и обработки |
Дальше по шагам:
- Откройте указанный раздел и установите флажок «Дополнительные отчеты и обработки».
- Перейдите по ссылке «Дополнительные отчеты и обработки» рядом с флажком.
- Нажмите «Добавить из файла…» и выберите файл.
- Подтвердите предупреждение о безопасности. Откроется карточка обработки: программа сама прочитает вид, версию и команды из файла.
- Настройте, где будет видна команда:
- для дополнительной обработки или отчёта — укажите разделы в поле размещения;
- для печатной формы и заполнения — проверьте список объектов назначения (документы, справочники).
- В таблице команд укажите пользователей для быстрого доступа, если кнопка нужна не всем.
- Проверьте статус публикации: «Используется». Нажмите «Записать и закрыть».
После этого печатная форма появится в меню «Печать» документа, а дополнительная обработка — в разделе через команду «Дополнительные обработки» (или «Дополнительные отчеты»).
Статус «Режим отладки» удобен при доработке: обработка видна только администраторам и не мешает остальным, пока вы её тестируете.
Как обновить, отключить или удалить обработку
Разработчик прислал новую версию файла — не добавляйте его второй раз. Получится две карточки с одинаковыми командами, и пользователи будут путаться, какую нажимать.
- Откройте список «Дополнительные отчеты и обработки» и найдите нужную строку.
- Откройте карточку и загрузите новый файл командой загрузки из файла в командной панели карточки.
- Сверьте номер версии в карточке с тем, что сообщил разработчик.
- Проверьте, что размещение и пользователи быстрого доступа не сбились, и запишите карточку.
Если обработка временно не нужна, переведите статус публикации в «Отключена». Команды исчезнут у всех пользователей, а сама карточка и настройки останутся — включить обратно можно за минуту.
Удалять карточку стоит, только когда обработка точно больше не понадобится. Помеченную на удаление карточку окончательно убирает администратор через удаление помеченных объектов.
Храните исходные файлы .epf и .erf в одной папке с номером версии в имени, например Печать_Счета_v1.3.epf. Когда понадобится откатиться, не придётся искать старую версию по почте.
Права доступа и безопасность внешних обработок
Внешняя обработка выполняет любой код с правами того, кто её запустил. Поэтому платформа и типовые конфигурации ставят несколько барьеров.
Какие права нужны
- 🔐 Интерактивное открытие внешних обработок / отчётов — право платформы для способа 1. Без него при открытии файла будет
Нарушение прав доступа!. В типовых конфигурациях оно есть у ролей полного доступа, у обычных пользователей обычно нет. - 🗂️ Добавление и изменение дополнительных отчётов и обработок — роль из БСП для регистрации файлов в справочнике. Её выдают через группы доступа (профили), а не напрямую пользователю.
- ▶️ Запуск зарегистрированной обработки — после регистрации пользователю не нужно право на открытие файлов. Достаточно, что команда ему доступна по настройкам размещения.
Поэтому правильная схема в компании: администратор один раз регистрирует проверенный файл, а бухгалтеры пользуются готовой кнопкой.
Защита от опасных действий
В платформе 8.3 есть флажок «Защита от опасных действий» в свойствах пользователя. Пока он включён, при открытии внешнего файла программа показывает предупреждение и ждёт подтверждения. Отключать его ради удобства не стоит.
Безопасный режим
При регистрации обработки с параметром БезопасныйРежим = Истина её код не может работать с файлами на сервере, запускать внешние программы и обращаться к COM-объектам. Если обработке это нужно (например, загрузка файла с сетевого диска), разработчик отключает безопасный режим, а администратор при добавлении подтверждает выдачу разрешений.
Внешняя обработка может не только читать, но и удалять или менять данные. Не запускайте файлы из форумов и почты в рабочей базе без проверки и без свежей резервной копии. Сначала откройте обработку на копии базы.
Признаки, при которых файл стоит показать программисту до запуска:
- в коде есть удаление объектов или очистка регистров;
- обработка обращается к внешним адресам, почте, файловой системе;
- безопасный режим отключён без понятной причины;
- модуль закрыт паролем, и автор неизвестен.
Почему внешняя обработка не открывается или не работает
Ещё одна типичная ситуация — после обновления конфигурации обработка перестала работать. Она обращается к реквизитам и общим модулям по именам. Если в новом релизе фирма переименовала реквизит или поменяла параметры процедуры, код обработки падает. Ремонт — только правкой файла под новый релиз, поэтому после каждого обновления проверяйте свои обработки на копии базы.