Files
cc-1c-skills/.claude/skills/form-compile/references/report-form.md
T
Nick ShirokovandClaude Opus 4.8 09d7097476 feat(form-compile): авторские references + индекс, корректность наборов значений
Каскад инструкции: ядро SKILL.md покрывает большинство задач, для редких/нишевых
конструкций — 12 тематических файлов в references/ (по индексу в SKILL.md).
Контракт references: только «как собрать DSL для задачи» — без механики эмиссии,
синонимов, авторезолва и forgiving (это тихая помощь модели); ссылки только внутри
навыка; область строго по элементу-владельцу.

Корректность ядра (наборы значений выверены по корпусу + доменно, forgiving/legacy
исключены из авторских):
- group расцеплён: ориентация (vertical/horizontalIfPossible/alwaysHorizontal) +
  отдельный ключ behavior (collapsible/popup) — popup-группы стали выразимы;
- titleLocation: полный набор none/left/right/top/bottom/auto;
- commandBarLocation += Bottom; searchStringLocation += Bottom/CommandBar/PullFromTop;
- общее свойство tooltip; events: null → авто-имя обработчика; правило уникальности имён.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 13:16:22 +03:00

3.9 KiB

Форма отчёта

Форма, подключённая к объекту-отчёту (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" }
  ]
}