cc-1c-skills/.codeassistant/skills/form-compile/references/report-form.md

Форма отчёта

Форма, подключённая к объекту-отчёту (Report). Кроме обычных свойств формы у неё есть несколько свойств в properties, связывающих форму с механизмом компоновки (СКД): куда выводится результат, где данные расшифровки, какого она типа. Все они задаются в блоке properties верхнего уровня.

"properties": {
  "reportFormType": "Main",
  "reportResult": "РезультатОтчета",
  "detailsData": "ДанныеРасшифровки"
}

Ни одно из этих свойств не обязательно — указывайте только те, что нужны конкретной форме.

Тип формы отчёта (reportFormType)

Роль формы в составе отчёта:

Значение	Назначение
Main	Основная форма отчёта (результат + настройки)
Settings	Форма настроек
Variant	Форма варианта

"reportFormType": "Main"

Привязка к компоновке

Ключ	Тип	Назначение
reportResult	string	Имя реквизита-результата формы (табличный документ, куда выводится отчёт)
detailsData	string	Имя реквизита данных расшифровки
variantAppearance	string	Имя реквизита оформления варианта

Значение каждого ключа — имя реквизита формы (а не путь к данным). Реквизит с таким именем должен присутствовать в attributes формы.

Группа пользовательских настроек (customSettingsFolder)

Группа-элемент формы, в которую генерируются пользовательские настройки компоновщика. Задаётся по имени элемента-группы:

"customSettingsFolder": "ГруппаПользовательскихНастроек"

Прочие свойства компоновки

Редкие, задавайте только при явной необходимости:

Ключ	Значения	Назначение
autoShowState	Auto, DontShow, ShowOnComposition	Автопоказ состояния формирования
reportResultViewMode	Auto	Режим просмотра результата
viewModeApplicationOnSetReportResult	Auto	Применение режима просмотра при установке результата

Реалистичный пример

Основная форма отчёта со СКД: реквизит-результат, данные расшифровки и группа пользовательских настроек.

{
  "properties": {
    "reportFormType": "Main",
    "reportResult": "РезультатОтчета",
    "detailsData": "ДанныеРасшифровки",
    "customSettingsFolder": "ГруппаПользовательскихНастроек"
  },
  "attributes": [
    { "name": "РезультатОтчета", "type": "SpreadsheetDocument" },
    { "name": "ДанныеРасшифровки", "type": "DataCompositionDetailsData" }
  ],
  "elements": [
    { "group": "vertical", "name": "ГруппаПользовательскихНастроек" },
    { "spreadsheet": "РезультатОтчета", "path": "РезультатОтчета",
      "titleLocation": "none" }
  ]
}