Подключение внешних обработок в 1С Фреш

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

Чтобы подключить обработку в 1С Фреш, нужны два условия. Первое — права администратора абонента (у рядового пользователя кнопки загрузки не будет). Второе — сама обработка должна быть адаптирована под механизм дополнительных отчётов и обработок и работать в безопасном режиме. Если файл этого не поддерживает, облако его просто не примет.

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

Механизм дополнительных обработок встроен в типовые конфигурации на управляемых формах — Бухгалтерию, ЗУП, Управление торговлей, УНФ, Комплексную автоматизацию. В облаке он доступен ровно в том же виде, что и в локальной базе, с поправкой на запрет небезопасных действий. Так что инструкция ниже подойдёт практически для любой типовой базы в Фреш.

Что проверить до загрузки файла

Прежде чем жать кнопки, убедитесь, что обработка вообще пригодна для облака. В 1С Фреш действуют ограничения, которых нет в локальной базе.

• 🔑 Права. Загрузка доступна администратору абонента. Если вы работаете под обычной учётной записью, попросите администратора или откройте базу под пользователем с полными правами.
• 🧩 Тип обработки. Подойдёт только обработка, подготовленная как дополнительная — с экспортной функцией СведенияОВнешнейОбработке() в модуле объекта. Произвольный .epf из конфигуратора в список не добавится.
• 🛡️ Безопасный режим. Облако запускает сторонний код в безопасном режиме: без обращения к файловой системе сервера, COM-объектам и запуску внешних программ. Обработка, которой нужны такие действия, в Фреш не заработает.
• 📦 Источник. Файл должен быть от вендора или партнёра, который прямо указывает совместимость с вашей конфигурацией и с подключением «как дополнительная обработка».

Короткий чек-лист готовности перед загрузкой:

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

Как загрузить внешнюю обработку: пошаговый порядок

Механизм один и тот же для типовых конфигураций в Фреш — Бухгалтерии, ЗУП, Управления торговлей, УНФ. Названия пунктов могут чуть отличаться между конфигурациями, но логика совпадает.

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

После записи команда появляется у выбранных пользователей — в разделе, в меню Ещё списка или по кнопке печати (для печатной формы). Чтобы запустить обработку вручную, пользователь открывает Дополнительные отчёты и обработки и выбирает нужную из списка — если ей не задано размещение в конкретных документах.

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

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

Подключение внешней печатной формы

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

После загрузки файла в карточке:

• в поле команды будет строка с названием печатной формы;
• в размещении укажите документы или справочники, из которых форму должны печатать (например, реализация, счёт, акт);
• при необходимости отметьте, заменяет ли новая форма типовую или добавляется к ней отдельным пунктом.

После настройки форма появляется в меню Печать выбранных документов. Открываете документ, жмёте Печать — и в списке рядом с типовыми формами будет ваша.

Дополнительные отчёты (.erf) подключаются так же, только вид будет Дополнительный отчёт, а размещается такой отчёт обычно в разделе с другими отчётами, а не в документе.

Виды дополнительных обработок и где они появляются

При загрузке 1С читает из файла его вид и дальше по-разному встраивает команду в интерфейс. От вида зависит, в каком месте пользователь увидит обработку и что указывать в размещении.

Вид определяет сам разработчик файла — вручную его в карточке не меняют. Если вид не тот, что вам нужен (например, вместо печатной формы загрузилась обработка-команда), значит, вам дали не тот файл — запросите у поставщика нужный вариант.

Запустить обработку, не привязанную к документу, можно из того же раздела: Администрирование → Печатные формы, отчёты и обработки → Дополнительные отчёты и обработки — открываете список и выбираете строку. Печатные формы и заполнения запускаются прямо из документа, к которому они привязаны размещением.

Расширение конфигурации: когда обработки недостаточно

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

В 1С Фреш возможности расширений ограничены сильнее, чем в локальной базе:

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

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

Практический вывод простой: печать, выгрузка, разовый пересчёт — это обработка. Изменение форм и логики программы — это расширение, и в облаке его согласовывают с администратором сервиса.

Почему обработка не подключается: разбор ошибок

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

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

Безопасность: почему облако проверяет сторонние файлы

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

Что снижает риск:

• 📥 Берите файлы только у вендора или проверенного партнёра. У легального поставщика есть описание, что именно делает обработка и под какую конфигурацию она рассчитана.
• 🔒 Безопасный режим — ваша защита. В Фреш он включён принудительно и не даёт обработке выйти за пределы базы: нет доступа к диску сервера, запуску программ и системным вызовам. Файл, которому этого мало, просто не запустится.
• 👥 Ограничивайте быстрый доступ. Чем меньше пользователей видят стороннюю команду, тем меньше шанс, что её запустят случайно или не по назначению.
• 🗑️ Снимайте ненужное. Обработку, которой больше не пользуетесь, удаляйте из списка — лишний чужой код в базе хранить незачем.

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

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