Как загрузить обработку в 1С:Фреш

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

Главное ограничение облака — требования безопасности. Каждая загружаемая обработка проходит автоматическую проверку: сервис анализирует код на наличие запрещенных операций (прямой доступ к файловой системе сервера, COM-объекты, внешние компоненты без разрешения). Обработки, написанные для обычной файловой базы, часто содержат такие конструкции и не проходят проверку без доработки.

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

Что потребуется перед загрузкой

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

Сама обработка должна быть в формате .epf. Проверьте, что она рассчитана на работу в режиме управляемого приложения: обработки с обычными формами (написанные под «толстый» клиент старых версий) в облаке не запустятся. Также убедитесь, что обработка совместима с вашей конфигурацией — обработка для «Управления торговлей» не обязана корректно работать в «Бухгалтерии предприятия».

Включение механизма дополнительных отчетов и обработок

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

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

Пошаговая регистрация обработки

Откройте список дополнительных отчетов и обработок и нажмите «Создать» или «Добавить из файла» — в зависимости от версии конфигурации формулировка кнопки различается. Укажите файл .epf на вашем компьютере. Сервис загрузит файл и запустит автоматическую проверку безопасности.

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

1. 1
   Включите «Дополнительные отчеты и обработки» в разделе «Администрирование → Печатные формы, отчеты и обработки»
2. 2
   Откройте список дополнительных отчетов и обработок и нажмите «Добавить из файла»
3. 3
   Выберите файл .epf и дождитесь завершения проверки безопасности
4. 4
   Заполните карточку: наименование, размещение в разделах, быстрый доступ для пользователей
5. 5
   Запишите карточку и проверьте появление команды в указанных разделах

Настройка размещения и прав доступа

В карточке обработки на вкладке «Размещение» укажите, в каких разделах интерфейса она появится: «Продажи», «Закупки», «Банк и касса» и так далее. Без размещения обработка зарегистрируется, но пользователи не найдут ее в разделах — открыть ее можно будет только из общего списка.

На вкладке «Быстрый доступ» назначьте пользователей или группы, которым команда будет видна сразу. Остальные смогут добавить команду самостоятельно через настройку панели команд раздела, если у них есть на это права. Разграничивайте доступ осмысленно: обработки, массово изменяющие данные, не должны быть доступны всем сотрудникам.

Ошибки проверки безопасности и их устранение

Самая частая причина отказа — использование в коде запрещенных в облаке конструкций: чтение и запись файлов на диске сервера, создание COM-объектов, вызов внешних компонентов, обращение к реестру. Сервис выдает перечень найденных нарушений с указанием модулей.

Устранение требует доработки кода разработчиком: файловые операции заменяют на механизмы передачи файлов через хранилище значений или диалоги выбора файла на клиенте, COM-интеграции — на веб-сервисы или HTTP-запросы (где они разрешены). Если обработка получена от стороннего разработчика, запросите у него версию, адаптированную для сервиса 1С:Фреш, — многие поставщики выпускают отдельные «облачные» редакции.

Разовый запуск без регистрации

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

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

Обновление и удаление зарегистрированной обработки

Для обновления откройте карточку обработки в списке и используйте команду замены файла («Загрузить из файла» в карточке). Настройки размещения и быстрого доступа при этом сохраняются — перенастраивать их не потребуется. Новая версия файла снова пройдет проверку безопасности.

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

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

Почему кнопка «Дополнительные отчеты и обработки» не отображается?

Либо не включена соответствующая функциональная опция в разделе «Администрирование → Печатные формы, отчеты и обработки», либо у вашей учетной записи нет прав на добавление дополнительных обработок. Проверьте флажок и обратитесь к администратору абонента для выдачи прав.

Поддерживаются ли отчеты в формате .erf?

Да, внешние отчеты .erf регистрируются через тот же механизм дополнительных отчетов и обработок и проходят аналогичную проверку безопасности. Порядок добавления тот же: «Добавить из файла», заполнение карточки, настройка размещения.

Обработка не прошла проверку безопасности — что делать?

Изучите перечень нарушений в сообщении сервиса. Чаще всего это файловые операции, COM-объекты или внешние компоненты. Код должен доработать разработчик под ограничения облака; если обработка сторонняя, запросите у поставщика версию, адаптированную для 1С:Фреш.

Можно ли запускать обработку автоматически по расписанию?

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

Исчезнут ли обработки при обновлении конфигурации в облаке?

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

Чем регистрация отличается от расширения конфигурации?

Внешняя обработка — отдельный файл, который вызывается пользователем или по расписанию и не меняет поведение программы. Расширение конфигурации встраивается в прикладное решение и может изменять формы, модули и роли. Для разовых операций и отчетов достаточно обработки; для изменения логики программы используют расширения, которые в 1С:Фреш тоже проходят проверку.