Каскад инструкции: ядро 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>
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" }
]
}