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

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

Разберём, какие обработки вообще можно подключить в 1С:Фреш, как подготовить файл, как добавить его в базу и как проверить, что всё работает. Отдельно рассмотрим типичные ошибки: чаще всего установка блокируется из-за небезопасного режима или несоответствия требованиям аудита сервиса.

Какие обработки можно установить в 1С:Фреш

Облачный сервис работает в модели сервиса, и все подключаемые расширения проходят автоматическую проверку. Условно обработки делятся на три группы. Первая — обработки из официального каталога сервиса (1С:ФрешМаркет): они уже проверены и устанавливаются в пару кликов. Вторая — собственные внешние обработки формата .epf, которые вы разработали сами или получили от стороннего разработчика. Третья — обработки, не проходящие аудит: их установить не получится в принципе.

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

Подготовка файла обработки перед установкой

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

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

Установка обработки через «Дополнительные отчеты и обработки»

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

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

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

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

Установка из каталога расширений и обработок сервиса

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

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

Сравнение вариантов

Свой файл .epf

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

Каталог решений сервиса

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

Расширение конфигурации

Подходит, когда нужно изменить поведение типовых объектов, а не добавить отдельную команду. Устанавливается через «Расширения конфигурации» с теми же ограничениями безопасного режима.

Проверка результата после установки

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

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

Контрольные точки

Как проверить результат

Команда в разделе

Норма

Команда обработки отображается в указанных разделах у нужных пользователей

Тревожный признак

Команда видна только администратору или отсутствует вовсе

Запуск обработки

Норма

Обработка открывается и выполняет сценарий без сообщений об ошибках

Тревожный признак

Ошибка «нарушение прав доступа» или «операция не разрешена в безопасном режиме»

Результат работы

Норма

Данные созданы или изменены корректно, отчёт формируется

Тревожный признак

Обработка отрабатывает молча, но данные не меняются

Типичные ошибки и ограничения

Самая частая проблема — отказ в установке из-за нарушений безопасного режима. В сообщении об ошибке сервис перечисляет конкретные строки и операции: обычно это работа с файлами через «НайтиФайлы», COMОбъект, запуск внешних приложений или использование метода «Выполнить» с произвольным кодом. Решение одно — переписать проблемные участки под безопасный режим.

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

Обновление и удаление обработки

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

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

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

Почему сервис отклоняет мой файл обработки?

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

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

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

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

Обработка — отдельный инструмент, который запускается пользователем и не меняет типовые объекты. Расширение изменяет поведение самой конфигурации: формы, модули, роли. Если нужно добавить кнопку в типовой документ — это расширение; если нужен отдельный инструмент загрузки данных — обработка.

Нужны ли права администратора для установки?

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

Что делать, если обработка работает, но очень медленно?

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