Подключение внешних обработок и отчётов в 1С:Предприятии

Поставить обработку в 1С можно двумя путями. Разово, на текущий сеанс — через меню Файл → Открыть в режиме 1С:Предприятие: выбрали файл .epf (обработка) или .erf (внешний отчёт), и он открылся. Постоянно, чтобы команда была у всех пользователей и после перезапуска — через справочник Дополнительные отчёты и обработки.

Файл обработки готовят в Конфигураторе или EDT и выгружают отдельным файлом. Внутри он может быть либо «простым» (просто форма, которую запускают руками), либо оформленным под подключение в справочник — с экспортной функцией СведенияОВнешнейОбработке(). От этого зависит, каким способом он вообще встанет в базу.

Ниже — оба способа по шагам, что должно быть внутри файла, как раздать права и что делать, когда обработка не открывается.

Что проверить до установки

Прежде чем открывать файл, стоит убедиться в трёх вещах.

• 📦 Формат файла. Обработка — .epf, внешний отчёт — .erf. Файлы .cf, .cfe, .dt — это не обработки, их грузят другими механизмами.
• 🧩 Совместимость с конфигурацией. Обработка пишется под конкретную конфигурацию (БП 3.0, ЗУП 3.1, УТ 11 и т. д.) и обращается к её объектам. Файл от «Бухгалтерии» в «Зарплате» чаще всего работать не будет.
• ⚙️ Версия платформы. Обработку открывает платформа с номером не ниже того, в котором её сохранили. Если на сервере платформа старее — файл выдаст ошибку совместимости.

Отдельно проверьте, какие функции конфигурации использует обработка. Если она обращается к механизму, который у вас выключен в настройках (например, к партионному учёту или к конкретному виду документов), команда подключится, но при запуске выдаст ошибку обращения к несуществующему объекту. В этом случае сначала включают нужную функциональную опцию в настройках конфигурации, и только потом пользуются обработкой.

Разовый запуск: открыть файл через меню «Файл»

Самый быстрый способ, когда обработка нужна один раз или прямо сейчас.

1. Запустите базу в режиме 1С:Предприятие.
2. Откройте меню Файл → Открыть (в интерфейсе «Такси» — круглая кнопка главного меню слева сверху, затем Файл → Открыть).
3. В диалоге выберите файл .epf или .erf и нажмите Открыть.
4. Обработка откроется своей формой — дальше работаете по её логике.

Есть и короткий вариант: перетащите файл .epf из проводника прямо в открытое окно 1С — обработка откроется так же, как через меню.

Такой запуск ничего не сохраняет в базе. После закрытия сеанса обработка исчезает, в следующий раз файл придётся открывать заново. Путь к файлу система запоминает в списке последних (Файл → Недавние), но сам объект в конфигурацию не попадает.

Способ подходит для разовых задач: массовая правка данных, выгрузка, отладочная проверка. Как только обработка понадобится постоянно или другим сотрудникам — переходите к подключению через справочник.

Постоянное подключение через справочник дополнительных обработок

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

Шаг 1. Включите подсистему. Зайдите в Администрирование → Печатные формы, отчёты и обработки и поставьте флажок Дополнительные отчёты и обработки. В конфигурациях на базе «1С:Управление торговлей» и ERP этот раздел лежит внутри НСИ и администрирование.

Шаг 2. Откройте список. Рядом с флажком появится ссылка Дополнительные отчёты и обработки — это и есть справочник.

Шаг 3. Загрузите файл. Нажмите Создать, в карточке — Загрузить из файла, выберите .epf или .erf. Система прочитает из файла его описание и сама подставит наименование, вид (обработка/отчёт/заполнение объекта и т. п.) и список команд.

Шаг 4. Настройте размещение. В карточке откройте Разместить (или Размещение) и отметьте разделы интерфейса, где должна появиться команда. Для обработок, привязанных к документу или справочнику, укажите, в каких списках и формах показывать кнопку.

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

Пути к справочнику по основным конфигурациям:

Как обновить или заменить подключённую обработку

Новую версию обработки не нужно удалять и создавать заново — её загружают поверх старой записи в справочнике.

1. Откройте Дополнительные отчёты и обработки и найдите нужную строку.
2. В карточке нажмите Загрузить из файла и выберите новый файл .epf или .erf.
3. Система заменит содержимое, но сохранит настройки размещения и быстрого доступа — пользователям ничего перенастраивать не придётся.
4. Запишите карточку.

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

Почему «простой» файл не подключается в справочник

Здесь спотыкаются чаще всего. В справочник Дополнительные отчёты и обработки встанет не любой файл .epf.

Чтобы обработка подключилась как дополнительная, внутри неё в модуле объекта должна быть экспортная функция СведенияОВнешнейОбработке(). Она возвращает описание: наименование, вид, версию, перечень команд и признак безопасного режима. По ней система и понимает, что за обработку ей дали и куда вешать команды.

Если такой функции нет, при загрузке из файла появится сообщение в духе «файл не содержит сведений о внешней обработке» или «не является дополнительной обработкой». Варианты действий:

• запускать файл через Файл → Открыть — «простым» обработкам это не мешает;
• если нужно именно подключение в справочник — доработать модуль, добавив СведенияОВнешнейОбработке(), или попросить об этом автора обработки.

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

Права доступа и где команда появится у пользователей

Разделите два права: кто подключает обработки и кто ими пользуется.

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

Пользователю для запуска нужно два условия:

1. Включённое право на работу с дополнительными обработками (в типовых конфигурациях даётся профилем группы доступа — например, профилями уровня «Менеджер», «Бухгалтер» в зависимости от конфигурации).
2. Видимость команды именно для него. Видимость задаётся в карточке обработки.

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

Право на интерактивное открытие внешних обработок с диска (способ через Файл → Открыть) настраивается отдельно — через профиль группы доступа. Выдавайте его точечно: открытие произвольных файлов с диска — это канал, через который в базу попадает любой сторонний код.

Где искать команду после подключения:

• 🧭 обработки без привязки к объекту — в разделе интерфейса, отмеченном в размещении, в группе Дополнительные обработки на панели действий;
• 🧾 обработки заполнения и печати — кнопкой в самой форме документа или справочника, к которому они привязаны;
• ⭐ самые частые — вынесите в Избранное или на начальную страницу через настройку быстрого доступа, чтобы пользователь не искал их по разделам.

Тонкий клиент, веб-клиент и безопасный режим

Тонкий клиент. Способ Файл → Открыть работает так же, как в толстом клиенте. Справочник дополнительных обработок — тоже. Это основной рабочий режим для большинства типовых баз.

Веб-клиент. Открыть файл обработки прямо с локального диска через Файл → Открыть в браузере удаётся не всегда: нужен установленный компонент работы с файлами («расширение работы с файлами 1С»), а некоторые возможности обработки в браузере недоступны. Надёжнее подключать обработку через справочник Дополнительные отчёты и обработки — тогда она доступна в веб-клиенте наравне с тонким.

Безопасный и небезопасный режим. При подключении в справочник система учитывает признак безопасного режима из описания обработки:

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

Почему обработка не открывается — разбор по симптомам

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