К статье
Практический материал

Администрирование · 10 мин

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

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

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

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

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

Что нужно знать о работе обработок в 1С:Фреш

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

Из этого следуют два практических вывода. Во-первых, обработка, которая отлично работает в локальной базе, может отказаться загружаться во Фреш, если использует запрещенные возможности. Во-вторых, «скачивание» обработки означает либо её подключение к приложению через типовой механизм БСП (библиотеки стандартных подсистем), либо выгрузку файла из справочника дополнительных обработок на локальный компьютер.

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

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

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

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

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

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

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

Каталог доступен с сайта сервиса и из интерфейса самого приложения. Порядок действий: найдите нужное решение по названию или задаче, откройте его карточку, ознакомьтесь с условиями (часть разработок платная) и нажмите кнопку подключения. Решение будет установлено в ваше приложение автоматически — отдельно скачивать файл на компьютер не требуется.

Сравнение источников обработок

Каталог разработок 1С:Фреш

Решения проверены и совместимы с сервисом; подключаются в пару кликов, но выбор ограничен опубликованным ассортиментом.

Свой файл .epf

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

Разработка на заказ

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

Как выгрузить (скачать) обработку из Фреша на компьютер

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

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

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

Почему обработка не загружается: проверка безопасности

Самая частая проблема при загрузке собственного .epf во Фреш — отказ автоматической проверки. Сервис анализирует код и блокирует обработки, которые обращаются к файловой системе, используют COM-соединения, OLE, внешние компоненты, запуск внешних приложений или попытки выйти за пределы безопасного режима.

Типичные причины отказа при загрузке
01
Обработка читает или пишет файлы напрямую (НайтиФайлы, ТекстовыйДокумент с указанием пути) — в безопасном режиме это запрещено, нужно передавать данные через диалоги выбора файла.
02
Используются COM-объекты или внешние компоненты — во Фреше они недоступны, обработку придется переписывать.
03
Код обращается к привилегированным операциям без необходимости — проверка отклонит такой файл.
04
Загружается отчет (.erf) вместо обработки (.epf) или наоборот — проверьте тип файла и назначение.

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

Проверка результата и типичные ошибки

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

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

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

Обработка в списке дополнительных
Норма

Видна, статус «Используется», открывается форма

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

Отсутствует в списке или помечена как отключенная

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

Выполняется основное действие, нет сообщений о безопасном режиме

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

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

Выгруженный файл
Норма

Файл .epf открывается в локальной базе через «Файл → Открыть»

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

Файл нулевого размера или не открывается — повторите выгрузку

Права пользователей
Норма

Обработка доступна тем сотрудникам, которым назначена

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

Пользователи не видят обработку — проверьте размещение и права

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

Маршрут решения

Как выбрать действие

Нужна готовая проверенная обработка под типовую задачуИщите решение в каталоге разработок 1С:Фреш и подключайте оттуда
Есть свой файл .epf от локальной базыЗагружайте через «Дополнительные отчеты и обработки» и будьте готовы к доработке под безопасный режим
Нужно перенести обработку из Фреша в локальную базуОткройте карточку обработки и выполните «Выгрузить в файл»
Обработка отклонена проверкой безопасностиАдаптируйте код под ограничения сервиса или подберите аналог в каталоге

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

Можно ли во Фреше открыть обработку через «Файл → Открыть»?

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

Почему кнопка «Добавить из файла» недоступна?

Чаще всего в настройках абонента запрещена загрузка собственных обработок либо у вашей учетной записи нет соответствующих прав. Обратитесь к владельцу абонента — он может включить опцию в Менеджере сервиса.

Обработка из локальной базы не загружается во Фреш. Что делать?

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

Как скачать обработку, установленную из каталога разработок?

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

Сохранятся ли подключенные обработки при обновлении приложения?

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

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

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

Итог

Что важно запомнить

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