Администрирование · 11 мин
Как добавить внешнюю обработку в 1С:Фреш
Пошаговая инструкция по добавлению внешней обработки в 1С:Фреш: требования к файлу, публикация через сервис, проверка безопасности, типичные ошибки и их решение.
1С:Фреш — облачный сервис, в котором пользователь работает с прикладными решениями 1С через браузер или тонкий клиент, не устанавливая платформу и не администрируя сервер. В отличие от локальной базы, где внешнюю обработку можно просто открыть через меню «Файл → Открыть», в облаке действуют ограничения безопасности: произвольный файл напрямую запустить нельзя, а подключение обработок выполняется через механизм дополнительных отчетов и обработок либо через расширения конфигурации.
Причина ограничений проста: на одних серверах сервиса работают базы множества абонентов, поэтому любой исполняемый код проходит проверку. Обработка, которая пытается обратиться к файловой системе сервера, выполнить код в небезопасном режиме или обойти разграничение данных, будет отклонена. Это важно учитывать еще до того, как вы начнете подключать файл.
Ниже разобран рабочий порядок добавления внешней обработки в 1С:Фреш: какие требования предъявляются к файлу, как подключить его через стандартный механизм «Дополнительные отчеты и обработки», что делать, если этой подсистемы в конфигурации нет, и как проверить, что обработка заработала корректно.
Что нужно знать перед подключением обработки
Первое условие — ваша прикладная конфигурация должна содержать подсистему «Дополнительные отчеты и обработки» из Библиотеки стандартных подсистем. Она есть в большинстве типовых решений: «1С:Бухгалтерия 8», «1С:Управление нашей фирмой», «1С:Зарплата и управление персоналом» и других. Если конфигурация самописная и этой подсистемы в ней нет, стандартный способ подключения не сработает.
Второе условие — права. Загружать и публиковать дополнительные обработки может пользователь с правами администратора или с ролью, разрешающей добавление дополнительных отчетов и обработок. Обычный пользователь увидит список уже подключенных обработок, но не сможет добавить новую.
Третье условие касается самого файла. Обработка должна быть подготовлена в формате внешней обработки (.epf) или внешнего отчета (.erf) и содержать корректное описание в модуле объекта: функцию СведенияОВнешнейОбработке, которая сообщает системе вид обработки, назначение и команды. Обработка без такого описания может загрузиться, но часто не сможет правильно зарегистрироваться в подсистеме.
Требования к файлу обработки в облаке
Облачный режим накладывает ограничения, которых нет в локальной базе. Код обработки не должен использовать операции, запрещенные в безопасном режиме сервиса: прямую работу с файловой системой сервера, COM-объекты, запуск внешних приложений, небезопасное выполнение кода. Если обработка написана для локальной базы и активно использует такие возможности, в 1С:Фреш она либо не пройдет проверку, либо будет выдавать ошибку при выполнении.
Для типовых конфигураций рекомендуется использовать обработки, адаптированные под подсистему дополнительных отчетов и обработок. В модуле объекта должна быть функция СведенияОВнешнейОбработке, возвращающая структуру с параметрами регистрации: вид обработки (заполнение объекта, печатная форма, дополнительный отчет и т.д.), версия, назначение и таблица команд. Обработки с диска ИТС и из официальных публикаций, как правило, уже содержат это описание.
Обратите внимание на версию конфигурации. Обработка, написанная под старую редакцию программы, может обращаться к реквизитам и объектам, которых в текущей версии уже нет. Перед загрузкой в рабочую базу сервиса имеет смысл проверить обработку в тестовой зоне или хотя бы на копии данных, если такая возможность доступна в вашем тарифе.
Добавление обработки через «Дополнительные отчеты и обработки»
Основной способ подключения выглядит так. Откройте раздел «Администрирование» и найдите пункт «Печатные формы, отчеты и обработки» (в некоторых конфигурациях — «Настройки» → «Дополнительные отчеты и обработки»). Убедитесь, что флажок использования дополнительных отчетов и обработок включен, затем перейдите по ссылке «Дополнительные отчеты и обработки».
В открывшемся списке нажмите «Добавить из файла» (или «Создать» → «Загрузить из файла», в зависимости от версии библиотеки). Укажите файл обработки на локальном компьютере. Система загрузит файл, выполнит автоматическую проверку безопасности и, если проверка пройдена, заполнит карточку обработки данными из ее описания: наименование, вид, назначение.
После загрузки настройте размещение: укажите, в каких разделах программы обработка будет доступна, или к каким объектам (справочникам, документам) она привязана — для обработок заполнения и печатных форм. Затем нажмите «Записать и закрыть». В некоторых конфигурациях дополнительно требуется «опубликовать» обработку или назначить ее пользователям через быстрый доступ.
- 1Откройте «Администрирование» → «Печатные формы, отчеты и обработки» и включите механизм дополнительных отчетов и обработок
- 2Перейдите в список «Дополнительные отчеты и обработки» и нажмите «Добавить из файла»
- 3Выберите файл .epf или .erf и дождитесь автоматической проверки безопасности
- 4Проверьте и при необходимости скорректируйте наименование, вид и назначение обработки
- 5Настройте размещение: разделы интерфейса или объекты, к которым привязана команда
- 6Запишите карточку и откройте обработку из указанного раздела для проверки
Если обработка не загружается: проверка безопасности и ошибки
Самая частая ситуация — файл отклонен автоматической проверкой. Сервис анализирует код и блокирует обработки, использующие запрещенные в облаке операции: доступ к файловой системе, OLE/COM, выполнение произвольного кода, обращения к внешним ресурсам нестандартными способами. В этом случае единственный рабочий путь — доработка обработки: заменить запрещенные вызовы на разрешенные аналоги или перенести часть логики на клиентскую сторону, где это допустимо.
Вторая причина — отсутствие или ошибки в функции СведенияОВнешнейОбработке. Если подсистема не может определить вид обработки, она либо откажет в загрузке, либо создаст карточку без команд. Откройте обработку в конфигураторе локальной базы, проверьте модуль объекта и приведите описание к требованиям актуальной версии БСП.
Третья группа проблем — несовместимость с версией конфигурации. Признаки: обработка загрузилась, но при выполнении появляются ошибки вида «Поле объекта не обнаружено». Это означает, что код обращается к реквизитам, отсутствующим в вашей версии программы. Здесь поможет только адаптация обработки под текущую конфигурацию или поиск ее актуальной версии.
Альтернативные способы: расширения и сервисные механизмы
Если задача выходит за рамки разовой обработки — например, нужно изменить поведение типовых форм или добавить постоянно работающий функционал, — рассмотрите расширение конфигурации. В 1С:Фреш расширения подключаются через раздел «Администрирование» → «Печатные формы, отчеты и обработки» → «Расширения» (в конфигурациях, где этот механизм включен). Расширения также проходят проверку безопасности сервиса.
Еще один вариант — готовые расширения и обработки из каталога сервиса 1С:Фреш и из официальных источников вендора. Такие решения уже адаптированы под облачный режим и проходят аудит, что снижает риск отказа при загрузке и проблем при обновлении конфигурации.
Для разработчиков доступен сценарий публикации через менеджер сервиса: загрузка обработки как дополнительного отчета/обработки на уровне абонента. Этот путь используется реже и требует прав владельца абонента, но позволяет централизованно раздавать обработку нескольким приложениям.
Сравнение вариантов
Подходит для разовых обработок, печатных форм и заполнения объектов. Ограничение: только функции, предусмотренные БСП, без изменения типовых форм
Подходит для постоянных доработок форм и логики. Ограничение: требует навыков разработки и проходит проверку безопасности сервиса
Подходит, когда нужна проверенная функциональность без разработки. Ограничение: выбор ограничен опубликованными решениями
Проверка результата после подключения
После записи карточки обработки убедитесь, что она действительно доступна. Перейдите в раздел, который вы указали в размещении, и откройте список дополнительных обработок — обычно это пункт «Дополнительные обработки» в меню раздела или кнопка в командной панели. Обработка должна присутствовать в списке и запускаться без ошибок.
Для обработок заполнения и печатных форм проверка выполняется на конкретном объекте: откройте тестовый документ, нажмите кнопку печати или заполнения и найдите команду подключенной обработки. Выполните ее и проверьте результат на копии данных или на заведомо тестовом документе.
Если обработка доступна администратору, но не видна другим пользователям, проверьте настройки прав: в некоторых конфигурациях доступ к дополнительным обработкам регулируется профилями групп доступа, и команду нужно добавить в профиль пользователя.
Как проверить результат
Карточка записана, обработка видна в разделе, указанном в размещении
Обработки нет в списке команд раздела — не настроено размещение
Форма открывается, команда выполняется без сообщений об ошибках
Ошибка «Поле объекта не обнаружено» — несовместимость с версией конфигурации
Обработку видят все, кому она назначена
Видна только администратору — не настроены профили доступа
FAQ
Можно ли в 1С:Фреш просто открыть файл обработки через меню «Файл → Открыть»?
Нет. В облачном сервисе прямое открытие внешних файлов заблокировано из соображений безопасности. Единственный штатный путь — подключение через механизм «Дополнительные отчеты и обработки» или через расширение конфигурации.
Почему моя обработка не прошла автоматическую проверку безопасности?
Чаще всего код использует операции, запрещенные в облаке: работу с файловой системой сервера, COM-объекты, запуск внешних программ, выполнение произвольного кода. Обработку нужно доработать, заменив такие вызовы на разрешенные механизмы платформы.
Обработка загрузилась, но не появилась ни в одном разделе. Что делать?
Откройте карточку обработки в списке дополнительных отчетов и обработок и проверьте настройку размещения: должны быть выбраны разделы командного интерфейса или объекты назначения. После изменения размещения запишите карточку и обновите интерфейс.
Подойдет ли в 1С:Фреш обработка, написанная для локальной версии программы?
Не всегда. Если обработка использует только разрешенные в облаке механизмы и совместима с вашей версией конфигурации — подойдет. Если в коде есть файловые операции на сервере или обращения к устаревшим реквизитам, потребуется адаптация.
Кто может загружать внешние обработки в 1С:Фреш?
Пользователь с правами администратора приложения или с ролью, разрешающей добавление дополнительных отчетов и обработок. Обычные пользователи могут только запускать уже опубликованные обработки в рамках своих прав.
Что делать, если после обновления конфигурации обработка перестала работать?
Проверьте, не изменились ли объекты и реквизиты, к которым обращается код. Обычно требуется обновить обработку до версии, совместимой с новым релизом, или скорректировать ее код под изменения конфигурации.
Что важно запомнить
В 1С:Фреш внешняя обработка подключается только через «Дополнительные отчеты и обработки» или расширения: файл загружается из карточки, проходит проверку безопасности и публикуется с настройкой размещения. Перед загрузкой убедитесь, что код не использует запрещенные в облаке операции, обработка содержит корректное описание для БСП, а тестирование проводится на копии данных.