Smart1Spec Документация
Studio
ПонятиеИзучающий Spec1CАналитик

Модель отчёта

Что такое модель отчёта в Studio, из чего она состоит, кто её меняет и почему она может отличаться от текста спецификации.

На этой странице

Модель отчёта — внутреннее описание того, что должна делать обработка или отчёт: какие источники данных брать, как их соединять, по какому полю отбирать период, как назвать макет. Её читают и меняют этапы Intent и Spec1C, по ней Studio генерирует код при сборке. Название «модель отчёта» используется и для обработок .epf.

Коротко#

  • У открытого файла проекта одна модель. Вкладки Intent «Данные» и «Вывод» и редактор Spec1C — разные способы показать и изменить её.
  • Текст Spec1C влияет на модель только после применения: «Ещё» → «Применить без сборки» или «Собрать».
  • Модель накапливается: применение добавляет и заменяет, но не удаляет то, чего нет в новом тексте.
  • Модель — это не копия формы загруженного файла. Она описывает только то, что задано в Intent и Spec1C.

Из чего состоит модель#

Часть моделиОткуда берётсяГде видна
Заголовокtitle в Spec1Cтекст спецификации; служебный комментарий в сгенерированном коде
Вид формы (обычная или управляемая)target в Spec1C; для загруженного файла — из его формывлияет на вид генерируемого кода
Номер разделаsection в Spec1Cв облачной сборке не используется
Параметрыизвестные имена в paramsна генерируемый код не влияют
Источники данных и их поляdata { } и fieldsIntent «Данные» — карточки источников с флажками полей
Соединениястроки |>Intent «Данные» — связь вида «Договор = Ссылка · left_join»
Поле периодаwhere или filter period onусловие МЕЖДУ в запросе
Просмотр метаданныхshowИнспектор
Списки на формеinclude listв собранный файл не выводятся
Запросы к регистрамbalance, turnoversв облачной среде сборка с ними останавливается
Имя макетаlayout: maket "…"; Intent «Вывод» → «Дополнительно»поле «Имя макета внутри обработки»
Выгрузка в Excelformat: xlsx; Intent «Вывод»флажок «Сохранить в Excel (.xlsx)»

Точный список элементов и правила их замены — Модель спецификации.

Кто меняет модель#

Spec1C. При «Применить без сборки» и при «Собрать» (если текст изменён после применения) разобранный текст накладывается на модель. Если в тексте есть ошибка разбора, модель не меняется совсем.

Intent «Данные». Источники добавляются перетаскиванием объектов из навигатора конфигурации. В облачной среде конфигурацию загрузить нельзя, поэтому на практике вкладка показывает источники, применённые из Spec1C.

Intent «Вывод». Способ вывода, флажок выгрузки в Excel и имя макета записываются в модель сразу.

Проверка модели. «Проверить модель Spec1C», если имя макета не задано, записывает в модель имя «Макет».

Кто читает модель#

  • Редактор Spec1C, когда строит текст спецификации из модели (см. Связь Intent и Spec1C).
  • Проверка модели — «Ещё» → «Проверить модель Spec1C».
  • Генерация кода при сборке: из модели берутся источники, поля, соединения, поле периода, вид формы и имя макета. Как это превращается в BSL — Генерация BSL и зоны генерации.

Почему модель отличается от текста#

Текст и модель расходятся в трёх случаях.

  1. Текст не применён. Вы изменили текст, но не нажали «Применить без сборки» или «Собрать».
  2. Из текста что-то удалено. Удалённый блок data, строка where или команда balance остаются в модели от предыдущего применения. Это наблюдалось в живой сборке: после спецификации с where ДатаДоговора between … сборка по спецификации без where всё равно сгенерировала условие по ДатаДоговора.
  3. Конструкция не попадает в модель. Строка rows, неизвестные параметры, КаталогВыгрузки в генерации, неподдерживаемые блоки — разбор их пропускает или хранит без влияния на код.

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

Модель и открытый файл#

Над редактором Spec1C может стоять баннер «МОДЕЛЬ НЕПОЛНАЯ» — например, после загрузки своего .epf или .erf. Он означает, что модель — рабочий шаблон, а не полное описание формы и кода файла. Исходники файла доступны на этапе Source как обычно. Если в модели есть источники данных, при сборке Studio попросит подтвердить генерацию кода в модуль формы.

Что из этого следует#

  • Смотрите на модель, а не только на текст: число источников — в уведомлении после применения, источники и связи — на вкладке Intent «Данные».
  • Изменили текст — примените его, прежде чем проверять модель или рассуждать о результате сборки.
  • Удаление из текста не очищает модель; для «чистого листа» используйте новый файл.
  • Модель не знает, что есть в вашей конфигурации: в облачной среде имена объектов и полей не проверяются.
  • Как текст и вкладки Intent обмениваются изменениями — Связь Intent и Spec1C.

См. также

Сверено с продуктом: 27.10.2026

Нашли неточность? Напишите на [email protected] и укажите адрес страницы.

Smart1Spec · документация описывает текущую версию сервиса.