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

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

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

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

Что нужно знать перед добавлением обработки

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

Из этого следуют практические требования к файлу обработки (расширение .epf):

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

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

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

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

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

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

Пошаговое подключение обработки

Подключение выполняется в режиме 1С:Предприятие через веб-клиент или тонкий клиент. Потребуются права администратора или права на добавление дополнительных отчетов и обработок.

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

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

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

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

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

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

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

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

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

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

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

Команда в интерфейсе

Норма

Команда видна в указанном разделе или форме объекта

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

Команды нет — проверьте размещение и быстрый доступ

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

Норма

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

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

Ошибка о запрещённой операции — код несовместим с безопасным режимом

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

Норма

Данные изменены или отчет сформирован корректно

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

Часть данных не обработана или появились дубли — нужна доработка кода

Типичные ошибки и их устранение

Чаще всего сервис отклоняет загрузку из-за несоответствия требованиям безопасности. Текст отказа обычно содержит указание на проблему: запрещённый вызов, отсутствие сведений о внешней обработке или неподдерживаемый вид.

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

Альтернативы: расширения конфигурации и готовые решения

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

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

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

Нужна разовая операция: заполнение, печатная форма, дополнительный отчетИспользуйте внешнюю обработку через «Дополнительные отчеты и обработки»

Нужно изменить формы, добавить реквизиты или ролиСоздайте или закажите расширение конфигурации

Задача типовая и массоваяПроверьте готовые решения в каталоге сервиса — возможно, обработка уже опубликована и проверена

Обработка отклонена проверкой безопасностиПередайте текст отказа разработчику для адаптации кода под безопасный режим

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

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

Почему сервис отклонил мою обработку при загрузке?

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

Можно ли добавить обработку, которая работает в локальной базе 1С?

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

Кто может добавлять обработки в 1С:Фреш?

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

Как обновить уже подключенную обработку на новую версию?

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

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

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

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

Проверьте три вещи: заполнено ли размещение (разделы или объекты назначения), настроен ли быстрый доступ для конкретного пользователя и обновил ли пользователь сеанс после изменения настроек. Чаще всего причина — пустой список размещения или отсутствие пользователя в списке быстрого доступа.