1C Skills: сборка отчёта ERF и схемы компоновки данных

Как создать внешний отчёт ERF и СКД с помощью 1C Skills: запрос, поля, параметры, варианты, сборка и проверка на тестовых данных.

Article

Внешний отчёт состоит не только из файла .erf. Внутри находится схема компоновки данных, запрос, параметры, варианты и форма. 1C Skills разделяет эти уровни, чтобы ИИ-агент менял каждый осознанно.

Начать с набора данных

Создай отчёт по просроченной задолженности покупателей. Поля: контрагент, договор, документ, срок оплаты, сумма и дни просрочки. Параметры: организация и дата. Группировки по контрагенту и общий итог.

query-optimization помогает составить запрос 1С, а skd-compile превращает компактное описание в XML схемы. Не начинайте с оформления: сначала запрос должен возвращать правильные строки.

Цикл работы со СКД

Для нового отчёта erf-init создаёт каркас, схема добавляется как макет, затем erf-validate и erf-build формируют готовый файл.

Проверка запроса

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

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

От исходников к релизу

Храните XML отчёта и СКД в Git, а ERF собирайте из конкретного коммита. В релиз прикладывайте готовый файл и описание параметров. Тогда агент может изменить запрос, review показывает смысловой diff, а пользователь получает привычный отчёт.

Критерий готовности — не успешная сборка, а совпадение результата с контрольными данными и понятная расшифровка итогов.

Статьи по теме