Модель отчёта
Что такое модель отчёта в Studio, из чего она состоит, кто её меняет и почему она может отличаться от текста спецификации.
Перед чтением
На этой странице
Модель отчёта — внутреннее описание того, что должна делать обработка или отчёт: какие источники данных брать, как их соединять, по какому полю отбирать период, как назвать макет. Её читают и меняют этапы Intent и Spec1C, по ней Studio генерирует код при сборке. Название «модель отчёта» используется и для обработок .epf.
Коротко#
- У открытого файла проекта одна модель. Вкладки Intent «Данные» и «Вывод» и редактор Spec1C — разные способы показать и изменить её.
- Текст Spec1C влияет на модель только после применения: «Ещё» → «Применить без сборки» или «Собрать».
- Модель накапливается: применение добавляет и заменяет, но не удаляет то, чего нет в новом тексте.
- Модель — это не копия формы загруженного файла. Она описывает только то, что задано в Intent и Spec1C.
Из чего состоит модель#
| Часть модели | Откуда берётся | Где видна |
|---|---|---|
| Заголовок | title в Spec1C | текст спецификации; служебный комментарий в сгенерированном коде |
| Вид формы (обычная или управляемая) | target в Spec1C; для загруженного файла — из его формы | влияет на вид генерируемого кода |
| Номер раздела | section в Spec1C | в облачной сборке не используется |
| Параметры | известные имена в params | на генерируемый код не влияют |
| Источники данных и их поля | data { } и fields | Intent «Данные» — карточки источников с флажками полей |
| Соединения | строки |> | Intent «Данные» — связь вида «Договор = Ссылка · left_join» |
| Поле периода | where или filter period on | условие МЕЖДУ в запросе |
| Просмотр метаданных | show | Инспектор |
| Списки на форме | include list | в собранный файл не выводятся |
| Запросы к регистрам | balance, turnovers | в облачной среде сборка с ними останавливается |
| Имя макета | layout: maket "…"; Intent «Вывод» → «Дополнительно» | поле «Имя макета внутри обработки» |
| Выгрузка в Excel | format: xlsx; Intent «Вывод» | флажок «Сохранить в Excel (.xlsx)» |
Точный список элементов и правила их замены — Модель спецификации.
Кто меняет модель#
Spec1C. При «Применить без сборки» и при «Собрать» (если текст изменён после применения) разобранный текст накладывается на модель. Если в тексте есть ошибка разбора, модель не меняется совсем.
Intent «Данные». Источники добавляются перетаскиванием объектов из навигатора конфигурации. В облачной среде конфигурацию загрузить нельзя, поэтому на практике вкладка показывает источники, применённые из Spec1C.
Intent «Вывод». Способ вывода, флажок выгрузки в Excel и имя макета записываются в модель сразу.
Проверка модели. «Проверить модель Spec1C», если имя макета не задано, записывает в модель имя «Макет».
Кто читает модель#
- Редактор Spec1C, когда строит текст спецификации из модели (см. Связь Intent и Spec1C).
- Проверка модели — «Ещё» → «Проверить модель Spec1C».
- Генерация кода при сборке: из модели берутся источники, поля, соединения, поле периода, вид формы и имя макета. Как это превращается в BSL — Генерация BSL и зоны генерации.
Почему модель отличается от текста#
Текст и модель расходятся в трёх случаях.
- Текст не применён. Вы изменили текст, но не нажали «Применить без сборки» или «Собрать».
- Из текста что-то удалено. Удалённый блок
data, строкаwhereили командаbalanceостаются в модели от предыдущего применения. Это наблюдалось в живой сборке: после спецификации сwhere ДатаДоговора between …сборка по спецификации безwhereвсё равно сгенерировала условие поДатаДоговора. - Конструкция не попадает в модель. Строка
rows, неизвестные параметры,КаталогВыгрузкив генерации, неподдерживаемые блоки — разбор их пропускает или хранит без влияния на код.
Чтобы модель точно совпала с текстом, заменяйте блоки, а не удаляйте их. Если нужно избавиться от прежних источников или поля периода, создайте новый файл и примените спецификацию в нём.
Модель и открытый файл#
Над редактором Spec1C может стоять баннер «МОДЕЛЬ НЕПОЛНАЯ» — например, после загрузки своего .epf или .erf. Он означает, что модель — рабочий шаблон, а не полное описание формы и кода файла. Исходники файла доступны на этапе Source как обычно. Если в модели есть источники данных, при сборке Studio попросит подтвердить генерацию кода в модуль формы.
Что из этого следует#
- Смотрите на модель, а не только на текст: число источников — в уведомлении после применения, источники и связи — на вкладке Intent «Данные».
- Изменили текст — примените его, прежде чем проверять модель или рассуждать о результате сборки.
- Удаление из текста не очищает модель; для «чистого листа» используйте новый файл.
- Модель не знает, что есть в вашей конфигурации: в облачной среде имена объектов и полей не проверяются.
- Как текст и вкладки Intent обмениваются изменениями — Связь Intent и Spec1C.
См. также
- Модель спецификации Справочник
- Связь Intent и Spec1C Понятие
- Применить спецификацию без сборки Руководство
- Генерация BSL и зоны генерации Понятие
Сверено с продуктом: 27.10.2026