Требования к обработкам в 1С:Фреш

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

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

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

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

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

Основные требования

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

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

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

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

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

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

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

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

• Тестирование.
  Перед отправкой на аудит важно провести тщательное тестирование на сервере соответствующей версии 1С:Фреш, а также проверить работу в тонком и веб-клиенте под разными профилями пользователей.

Подготовка к публикации

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

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

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

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

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

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

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

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