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

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

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

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

Какие способы подключения доступны в 1С:Фреш

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

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

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

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

Дополнительные отчеты и обработки (.epf)

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

Расширение конфигурации (.cfe)

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

Прямое открытие файла

В 1С:Фреш обычно недоступно или работает с жесткими ограничениями безопасного режима.

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

Убедитесь, что у вашей учетной записи есть права на добавление дополнительных отчетов и обработок. Обычно это роль «Добавление и изменение дополнительных отчетов и обработок» или полные права администратора. Без этих прав кнопка «Создать» в списке обработок будет недоступна.

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

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

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

Пошаговая загрузка обработки через «Дополнительные отчеты и обработки»

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

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

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

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

Почему сервис может отклонить файл

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

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

Ограничения облачного режима, о которых нужно знать

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

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

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

Как проверить, что обработка работает правильно

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

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

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

Обработка в списке

Норма

Видна в «Дополнительные обработки» нужного раздела и открывается без ошибок

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

Отсутствует в списке или при открытии сообщение об ошибке

Выполнение основной операции

Норма

Операция завершается, данные появляются в базе и совпадают с источником

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

Ошибки выполнения, частичная загрузка, неверные данные

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

Норма

Рядовые пользователи видят обработку в разрешенных разделах

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

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

Работа после обновления релиза

Норма

Обработка запускается и выполняет операции как раньше

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

После обновления появляются ошибки о ненайденных объектах

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

Часто задаваемые вопросы

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

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

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

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

Обработка работала в локальной 1С, но в Фреше выдает ошибки файлового доступа. Что делать?

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

Кто может загружать обработки, если у меня нет кнопки «Создать»?

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

Нужно ли заново загружать обработки после обновления конфигурации?

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

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

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