git:20260428.73f4551 to git:20260828.2b87e3e

32 added, 32 removed. Audit A to A.

---

name: 1c-skd-compile

description: Компиляция схемы компоновки данных 1С (СКД) из компактного JSON-определения. Используй когда нужно создать СКД с нуля

argument-hint: "[-DefinitionFile <json> | -Value <json-string>] -OutputPath <Template.xml>"

allowed-tools:

- Bash

- Read

- Write

- Glob

---

- # /skd-compile — генерация СКД из JSON DSL

+ # /skd-compile - генерация СКД из JSON DSL

Принимает JSON-определение схемы компоновки данных → генерирует Template.xml (DataCompositionSchema).

## Параметры и команда

| Параметр | Описание |

|----------|----------|

| `DefinitionFile` | Путь к JSON-файлу с определением СКД (взаимоисключающий с Value) |

| `Value` | JSON-строка с определением СКД (взаимоисключающий с DefinitionFile) |

| `OutputPath` | Путь к выходному Template.xml |

```powershell

# Из файла

powershell.exe -NoProfile -File skills/1c-skd-compile/scripts/skd-compile.ps1 -DefinitionFile "<json>" -OutputPath "<Template.xml>"

# Из строки (без промежуточного файла)

powershell.exe -NoProfile -File skills/1c-skd-compile/scripts/skd-compile.ps1 -Value '<json-string>' -OutputPath "<Template.xml>"

```

- ## JSON DSL — краткий справочник

+ ## JSON DSL - краткий справочник

Справочник ниже. Все примеры компилируемы как есть.

### Корневая структура

```json

{

"dataSets": [...],

"calculatedFields": [...],

"totalFields": [...],

"parameters": [...],

"templates": [...],

"groupTemplates": [...],

"dataSetLinks": [...],

"settingsVariants": [...]

}

```

Умолчания: `dataSources` → авто `ИсточникДанных1/Local`; `settingsVariants` → авто "Основной" с деталями.

### Наборы данных

Тип по ключу: `query` → DataSetQuery, `objectName` → DataSetObject, `items` → DataSetUnion.

```json

{ "name": "Продажи", "query": "ВЫБРАТЬ ...", "fields": [...] }

```

- Запрос поддерживает `@file` — ссылку на внешний .sql файл вместо inline-текста: `"query": "@queries/sales.sql"`. Путь разрешается относительно JSON-файла, затем CWD.

+ Запрос поддерживает `@file` - ссылку на внешний .sql файл вместо inline-текста: `"query": "@queries/sales.sql"`. Путь разрешается относительно JSON-файла, затем CWD.

- ### Поля — shorthand и объектная форма

+ ### Поля - shorthand и объектная форма

```

- "Наименование" — просто имя

- "Количество: decimal(15,2)" — имя + тип

- "Организация: CatalogRef.Организации @dimension" — + роль

- "Служебное: string #noFilter #noOrder" — + ограничения

+ "Наименование" - просто имя

+ "Количество: decimal(15,2)" - имя + тип

+ "Организация: CatalogRef.Организации @dimension" - + роль

+ "Служебное: string #noFilter #noOrder" - + ограничения

```

- Объектная форма — когда нужен title или другие свойства:

+ Объектная форма - когда нужен title или другие свойства:

```json

{ "field": "ОстатокНаНачалоПериода", "title": "Остаток на начало периода" }

```

- `dataPath` автоматически берётся из `field`, если не указан явно.

+ `dataPath` автоматически берется из `field`, если не указан явно.

Типы: `string`, `string(N)`, `decimal(D,F)`, `boolean`, `date`, `dateTime`, `CatalogRef.X`, `DocumentRef.X`, `EnumRef.X`, `StandardPeriod`. Ссылочные типы эмитируются с inline namespace `d5p1:` (`http://v8.1c.ru/8.1/data/enterprise/current-config`). Сборка EPF со ссылочными типами требует базу с соответствующей конфигурацией.

**Синонимы типов** (русские и альтернативные): `число` = decimal, `строка` = string, `булево` = boolean, `дата` = date, `датаВремя` = dateTime, `СтандартныйПериод` = StandardPeriod, `СправочникСсылка.X` = CatalogRef.X, `ДокументСсылка.X` = DocumentRef.X, `int`/`number` = decimal, `bool` = boolean. Регистронезависимые.

Роли: `@dimension`, `@account`, `@balance`, `@period`.

Ограничения: `#noField`, `#noFilter`, `#noGroup`, `#noOrder`.

В объектной форме: `"useRestriction": { "field": true, "condition": true, "group": true, "order": true }` или `"restrict": ["noField", "noFilter"]`.

### Вычисляемые поля (calculatedFields)

- Shorthand: `"Имя [Заголовок]: тип = Выражение #noField #noFilter #noGroup #noOrder"` — все части кроме имени опциональны.

+ Shorthand: `"Имя [Заголовок]: тип = Выражение #noField #noFilter #noGroup #noOrder"` - все части кроме имени опциональны.

```json

"calculatedFields": [

"Маржа = Цена - Закупка",

"Наценка [Наценка, %]: decimal(10,2) = Маржа / Закупка * 100",

"Служебное: string = \"\" #noField #noFilter #noGroup #noOrder"

]

```

- Объектная форма — когда нужна `appearance`:

+ Объектная форма - когда нужна `appearance`:

```json

{ "name": "Маржа", "title": "Маржа", "expression": "Цена - Закупка", "type": "decimal(15,2)", "useRestriction": "#noField #noFilter" }

```

### Итоги (shorthand)

```json

"totalFields": ["Количество: Сумма", "Стоимость: Сумма(Кол * Цена)"]

```

### Параметры (shorthand + @autoDates)

```json

"parameters": [

"Период [Отчетный период]: StandardPeriod = LastMonth @autoDates"

]

```

- Shorthand: `"Имя [Заголовок]: тип = значение @флаги"`. `[Заголовок]` опциональный — добавляет `<title>` (LocalStringType).

+ Shorthand: `"Имя [Заголовок]: тип = значение @флаги"`. `[Заголовок]` опциональный - добавляет `<title>` (LocalStringType).

Флаги shorthand:

- - `@autoDates` — добавляет к параметру StandardPeriod пару дат `НачалоПериода`/`КонецПериода`, вычисляемых из него. Используй их в тексте запроса как `&НачалоПериода`/`&КонецПериода`; пользователь выбирает только сам период. По умолчанию сам параметр получает `use=Always` и `denyIncompleteValues=true` (чтобы производные даты всегда были заполнены); в объектной форме можно явно переопределить.

- - `@valueList` — `<valueListAllowed>true</valueListAllowed>` — разрешает передавать список значений

- - `@hidden` — скрытый параметр: `availableAsField=false` + исключается из `"dataParameters": "auto"`

+ - `@autoDates` - добавляет к параметру StandardPeriod пару дат `НачалоПериода`/`КонецПериода`, вычисляемых из него. Используй их в тексте запроса как `&НачалоПериода`/`&КонецПериода`; пользователь выбирает только сам период. По умолчанию сам параметр получает `use=Always` и `denyIncompleteValues=true` (чтобы производные даты всегда были заполнены); в объектной форме можно явно переопределить.

+ - `@valueList` - `<valueListAllowed>true</valueListAllowed>` - разрешает передавать список значений

+ - `@hidden` - скрытый параметр: `availableAsField=false` + исключается из `"dataParameters": "auto"`

Объектная форма: `title`, `hidden: true`, `valueListAllowed: true`, `availableAsField: false`, `denyIncompleteValues: true`, `use: "Always"`.

Список допустимых значений (availableValues):

```json

{

"name": "ПорядокОкругления",

"type": "EnumRef.Округления",

"value": "Перечисление.Округления.Окр1_00",

"use": "Always",

"denyIncompleteValues": true,

"availableValues": [

{"value": "Перечисление.Округления.Окр1_00", "presentation": "руб. коп"},

{"value": "Перечисление.Округления.Окр1", "presentation": "руб."},

{"value": "Перечисление.Округления.Окр1000", "presentation": "тыс. руб"}

]

}

```

В варианте настроек `"dataParameters": "auto"` выводит все не-hidden параметры с `userSettingID`. Значения по умолчанию наследуются и остаются активными; параметры без значения по умолчанию отключаются (пользователь включит их в настройках).

- ### Фильтры — shorthand

+ ### Фильтры - shorthand

```json

"filter": [

"Организация = _ @off @user",

"Дата >= 2024-01-01T00:00:00",

"Статус filled"

]

```

Формат: `"Поле оператор значение @флаги"`. Значение `_` = пустое (placeholder). Флаги: `@off` (use=false), `@user` (userSettingID=auto), `@quickAccess`, `@normal`, `@inaccessible`.

В объектной форме доступны: `viewMode`, `userSettingID`, `userSettingPresentation`.

Группы фильтров (Or/And/Not):

```json

{ "group": "Or", "items": [

{ "group": "And", "items": [

{ "field": "Статус", "op": "=", "value": "Активен" },

{ "field": "Сумма", "op": ">", "value": 1000 }

]},

{ "field": "Количество", "op": "filled" }

]}

```

- ### Параметры данных — shorthand

+ ### Параметры данных - shorthand

```json

"dataParameters": [

"Период = LastMonth @user",

"Организация @off @user"

]

```

Формат: `"Имя [= значение] @флаги"`. Для StandardPeriod варианты (LastMonth, ThisYear и т.д.) распознаются автоматически.

- ### Структура — string shorthand

+ ### Структура - string shorthand

```json

"structure": "Организация > details"

"structure": "Организация > Номенклатура > details"

```

`>` разделяет уровни группировки. `details` (или `детали`) = детальные записи. `selection` и `order` по умолчанию `["Auto"]` на каждом уровне.

- Объектная форма — для сложных случаев (именованные группировки, selection/filter на уровне группировки, таблицы, диаграммы):

+ Объектная форма - для сложных случаев (именованные группировки, selection/filter на уровне группировки, таблицы, диаграммы):

```json

"structure": [

{

"name": "ПоОрганизациям",

"groupFields": ["Организация"],

"selection": ["Организация", "Сумма", "Auto"],

"children": [{ "groupFields": [] }]

}

]

```

- `type` по умолчанию `"group"` (можно не указывать). `groupFields` — алиас для `groupBy`. Поддержка `name`, `selection`, `order`, `filter`, `outputParameters`, рекурсивных `children`.

+ `type` по умолчанию `"group"` (можно не указывать). `groupFields` - алиас для `groupBy`. Поддержка `name`, `selection`, `order`, `filter`, `outputParameters`, рекурсивных `children`.

### Варианты настроек

```json

"settingsVariants": [{

"name": "Основной",

"title": "Продажи по организациям",

"settings": {

"selection": ["Номенклатура", "Количество", "Auto"],

"filter": ["Организация = _ @off @user"],

"order": ["Количество desc", "Auto"],

"conditionalAppearance": [

{

"filter": ["Просрочено = true"],

"appearance": { "ЦветТекста": "style:ПросроченныеДанныеЦвет" },

"presentation": "Выделять просроченные",

"viewMode": "Normal",

"userSettingID": "auto"

}

- "outputParameters": { "Заголовок": "Мой отчёт" },

+ "outputParameters": { "Заголовок": "Мой отчет" },

"dataParameters": ["Период = LastMonth @user"],

"structure": "Организация > details"

}

}]

```

### Условное оформление (conditionalAppearance)

```json

"conditionalAppearance": [

{

"selection": ["Поле1"],

"filter": ["Поле1 notFilled"],

"appearance": { "Текст": "Не указано", "ЦветТекста": "style:XXX" },

"presentation": "Описание",

"viewMode": "Normal",

"userSettingID": "auto"

}

]

```

Типы значений appearance: `style:XXX`/`web:XXX`/`win:XXX` → Color, `true`/`false` → Boolean, параметр `Формат`/`Текст`/`Заголовок` → LocalStringType, прочее → String.

Типы значений фильтра: `Перечисление.*`/`Справочник.*`/`ПланСчетов.*`/`Документ.*` → DesignTimeValue (автодетект).

OrGroup в фильтре: `{"group": "Or", "items": ["условие1", "условие2"]}`.

Folder в selection: `{"folder": "Поступление", "items": ["ПолеА", "ПолеБ"]}` → SelectedItemFolder с lwsTitle и placement=Auto.

### Итоги с привязкой к группировкам

```json

"totalFields": [

{ "dataPath": "Кол", "expression": "Сумма(Кол)", "group": ["Группа1", "Группа1 Иерархия", "ОбщийИтог"] }

]

```

- ### Шаблоны вывода — компактный DSL

+ ### Шаблоны вывода - компактный DSL

- Вместо raw XML (`template`) — табличное описание через `rows` + именованный стиль `style`:

+ Вместо raw XML (`template`) - табличное описание через `rows` + именованный стиль `style`:

```json

"templates": [

{

"name": "Макет1",

"style": "header",

"widths": [36, 33, 16, 17],

"minHeight": 24.75,

"rows": [

["Виды кассы", "Валюта", "Остаток на начало\nпериода", "Остаток на\nконец периода"],

["|", "|", "|", "|"],

["К1", "К2", "К3", "К4"]

]

{

"name": "Макет2",

"style": "data",

"widths": [36, 33, 16, 17],

"rows": [["{ВидКассы}", "{Валюта}", "{Остаток}", "{ОстатокКонец}"]],

"parameters": [

{ "name": "ВидКассы", "expression": "Представление(Счет)" },

{ "name": "Остаток", "expression": "ОстатокНаНачалоПериода" }

]

}

]

```

- Синтаксис ячеек: `"текст"` — статика, `"{Имя}"` — параметр, `"|"` — объединение с ячейкой выше, `">"` — объединение с ячейкой слева, `null` — пустая.

+ Синтаксис ячеек: `"текст"` - статика, `"{Имя}"` - параметр, `"|"` - объединение с ячейкой выше, `">"` - объединение с ячейкой слева, `null` - пустая.

Двухуровневая шапка с горизонтальным объединением:

```json

"rows": [

["Вид актива", "Остаток начало", "Поступление", ">", ">", ">", "Выбытие", ">", ">", "Остаток конец"],

["|", "|", "из произв.", "из п/ф", "со сч.40", "прочее", "Реализ.", "отгруж.", "прочее", "|"],

["К1", "К2", "К3", "К4", "К5", "К6", "К7", "К8", "К9", "К10"]

]

```

- Встроенные стили: `header` (фон, центр, перенос), `data` (фон группы), `subheader` (без фона, центр), `total` (без фона). Все — Arial 10, рамки Solid 1px, цвета через стили платформы.

+ Встроенные стили: `header` (фон, центр, перенос), `data` (фон группы), `subheader` (без фона, центр), `total` (без фона). Все - Arial 10, рамки Solid 1px, цвета через стили платформы.

- Пользовательские стили: файл `skd-styles.json` рядом с JSON-определением, в текущей директории, или в `presets/skills/skd/skd-styles.json` (поиск вверх от OutputPath). Первый найденный файл побеждает. Все допустимые ключи и формат цветов — в `examples/skd-styles.json`.

+ Пользовательские стили: файл `skd-styles.json` рядом с JSON-определением, в текущей директории, или в `presets/skills/skd/skd-styles.json` (поиск вверх от OutputPath). Первый найденный файл побеждает. Все допустимые ключи и формат цветов - в `examples/skd-styles.json`.

- Raw XML (`"template": "<...>"`) остаётся как fallback. Детект: если есть `rows` — DSL, иначе — raw.

+ Raw XML (`"template": "<...>"`) остается как fallback. Детект: если есть `rows` - DSL, иначе - raw.

### Расшифровка (drilldown) в параметрах шаблона

Ключ `drilldown` в параметре шаблона автоматически генерирует `DetailsAreaTemplateParameter` и привязку `Расшифровка` в appearance ячеек:

```json

"parameters": [

{ "name": "Сырье", "expression": "ПоступлениеСырья", "drilldown": "ПоступлениеСырья" }

]

```

Генерирует: `ExpressionAreaTemplateParameter` (обычный) + `DetailsAreaTemplateParameter` с именем `Расшифровка_ПоступлениеСырья`, `fieldExpression` по полю `ИмяРесурса`, `mainAction=DrillDown`. Ячейки `{Сырье}` автоматически получают appearance `Расшифровка = Расшифровка_ПоступлениеСырья`.

### Привязки макетов к группировкам

```json

"groupTemplates": [

{ "groupName": "ДанныеОтчета", "templateType": "GroupHeader", "template": "Макет1" },

{ "groupField": "Счет", "templateType": "Header", "template": "Макет2" },

{ "groupField": "Счет", "templateType": "OverallHeader", "template": "Макет3" }

]

```

- `groupField` — привязка к полю группировки, `groupName` — к именованной группировке в структуре варианта.

+ `groupField` - привязка к полю группировки, `groupName` - к именованной группировке в структуре варианта.

`templateType`: `Header` (строки данных) → `<groupTemplate>`, `OverallHeader` (итоги) → `<groupTemplate>`, `GroupHeader` (шапка) → `<groupHeaderTemplate>`.

## Примеры

### Минимальный

```json

{

"dataSets": [{

"query": "ВЫБРАТЬ Номенклатура.Наименование КАК Наименование ИЗ Справочник.Номенклатура КАК Номенклатура",

"fields": ["Наименование"]

}]

}

```

### С запросом из внешнего файла (@file)

```json

{

"dataSets": [{

"query": "@queries/sales.sql",

"fields": ["Номенклатура: СправочникСсылка.Номенклатура @dimension", "Количество: число(15,3)", "Сумма: число(15,2)"]

}]

}

```

### С ресурсами, параметрами и @autoDates

```json

{

"dataSets": [{

"query": "ВЫБРАТЬ Продажи.Номенклатура, Продажи.Количество, Продажи.Сумма ИЗ РегистрНакопления.Продажи КАК Продажи",

"fields": ["Номенклатура: СправочникСсылка.Номенклатура @dimension", "Количество: число(15,3)", "Сумма: число(15,2)"]

}],

"totalFields": ["Количество: Сумма", "Сумма: Сумма"],

"parameters": ["Период: СтандартныйПериод = LastMonth @autoDates"],

"settingsVariants": [{

"name": "Основной",

"settings": {

"selection": ["Номенклатура", "Количество", "Сумма", "Auto"],

"filter": ["Организация = _ @off @user"],

"dataParameters": ["Период = LastMonth @user"],

"structure": "Организация > details"

}

}]

}

```

## Верификация

```

- /skd-validate <OutputPath> — валидация структуры XML

- /skd-info <OutputPath> — визуальная сводка

- /skd-info <OutputPath> -Mode variant -Name 1 — проверка варианта настроек

+ /skd-validate <OutputPath> - валидация структуры XML

+ /skd-info <OutputPath> - визуальная сводка

+ /skd-info <OutputPath> -Mode variant -Name 1 - проверка варианта настроек

```