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

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

Как работают внешние отчеты и обработки в 1С:Фреш

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

• .epf — для обработок,
• .erf — для отчетов.

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

Чем отличается добавление обработок в 1С:Фреш от локальных версий

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

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

Основные требования к дополнительным обработкам в 1С:Фреш

Дополнительные отчеты и обработки должны соответствовать требованиям подсистемы «ДополнительныеОтчетыИОбработки» библиотеки стандартных подсистем (БСП) и следовать стандартам разработки для 1С:Предприятия 8.

• Безопасный режим.
  • Все новые обработки должны работать только в безопасном режиме. Для этого установите значение «Истина» в параметре «ПараметрыРегистрации.БезопасныйРежим» функции «СведенияОВнешнейОбработке()».

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

Обратите внимание! Использование COM-объектов в сервисе 1С:Фреш недопустимо, поскольку его серверы работают под управлением Linux.

• Аудит  и прозрачность кода.
  • Не используйте средства, затрудняющие анализ исходных текстов, таких как обфускация либо установка паролей на модули.
  • Код должен быть открытым для проверки при аудите.
• Ресурсоемкость. Установлены строгие ограничения на использование ресурсов:
  • Время выполнения серверного вызова: не более 2400 секунд.
  • Объем используемой памяти: не более 4 ГБ.
    Превышение этих лимитов может привести к прерыванию выполнения обработки.
• Работоспособность и совместимость.
  • Обработки должны корректно работать в тонком и веб-клиенте. Если функциональность доступна только в тонком клиенте, обработка должна уведомить пользователя, а не завершаться с ошибкой.
• Актуальность версии.
  • При разработке вашей обработки необходимо использовать последнюю версию конфигурации, для которой она предназначается.
• Передача данных.
  • Если обработка должна передавать данные в другие системы вне сервиса, то каждая такая операция должна получать разрешение от пользователя.
• Тестирование.
  • Перед отправкой на аудит важно провести тщательное тестирование на сервере соответствующей версии 1С:Фреш, а также проверить работу в тонком и веб-клиенте под разными профилями пользователей.

Методические  рекомендации

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

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

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

Подготовка обработок к отправке на аудит

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

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

Если ошибки не обнаружены, сохраните сгенерированный дистрибутив и передайте его обслуживающей организации. Партнер 1С загрузит обработку в сервис и отправит на аудит.

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

• Свяжитесь с обслуживающей компанией.

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

• Где найти контакты?

Если вы недавно подключили тестовую подписку, откройте личный кабинет в 1С:Фреш. В разделе «Поддержка» вы найдете контактные данные обслуживающей компании.

Процесс установки одобренных расширений

После успешного прохождения аудита ваша доработка станет доступной в разделе «Адаптация». Чтобы установить расширение, следуйте этим шагам:

• Перейдите в раздел «Адаптация».

• Выберите необходимый файл и нажмите кнопку «Установить».

Через 5 минут доработка будет установлена и готова к использованию.

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

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