mirror of
https://github.com/Nikolay-Shirokov/cc-1c-skills.git
synced 2026-06-10 16:14:54 +03:00
Merge branch 'dev'
This commit is contained in:
Nick Shirokov
@@ -1,4 +1,6 @@
|
||||
param(
|
||||
# epf-add-form v1.0 — Add managed form to 1C processor
|
||||
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
|
||||
param(
|
||||
[Parameter(Mandatory)]
|
||||
[string]$ProcessorName,
|
||||
|
||||
|
||||
@@ -1,4 +1,6 @@
|
||||
param(
|
||||
# epf-add-help v1.0 — Add built-in help to 1C processor
|
||||
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
|
||||
param(
|
||||
[Parameter(Mandatory)]
|
||||
[string]$ProcessorName,
|
||||
|
||||
|
||||
@@ -25,7 +25,7 @@ allowed-tools:
|
||||
|---------------|:------------:|-----------------|--------------------------------------------------|
|
||||
| ProcessorName | да | — | Имя обработки |
|
||||
| TemplateName | да | — | Имя макета |
|
||||
| TemplateType | да | — | Тип: HTML, Text, SpreadsheetDocument, BinaryData |
|
||||
| TemplateType | да | — | Тип: HTML, Text, SpreadsheetDocument, BinaryData, DataCompositionSchema |
|
||||
| Synonym | нет | = TemplateName | Синоним макета |
|
||||
| SrcDir | нет | `src` | Каталог исходников |
|
||||
|
||||
@@ -45,6 +45,7 @@ pwsh -NoProfile -File .claude/skills/epf-add-template/scripts/add-template.ps1 -
|
||||
| Text, текстовый документ, текст | TextDocument | `.txt` | Пустой файл |
|
||||
| SpreadsheetDocument, табличный документ, MXL | SpreadsheetDocument | `.xml` | Минимальный spreadsheet |
|
||||
| BinaryData, двоичные данные | BinaryData | `.bin` | Пустой файл |
|
||||
| DataCompositionSchema, СКД, схема компоновки | DataCompositionSchema | `.xml` | Минимальная DCS-схема |
|
||||
|
||||
## Конвенция именования
|
||||
|
||||
|
||||
@@ -1,4 +1,6 @@
|
||||
param(
|
||||
# epf-add-template v1.0 — Add template to 1C processor
|
||||
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
|
||||
param(
|
||||
[Parameter(Mandatory)]
|
||||
[string]$ProcessorName,
|
||||
|
||||
@@ -6,7 +8,7 @@
|
||||
[string]$TemplateName,
|
||||
|
||||
[Parameter(Mandatory)]
|
||||
[ValidateSet("HTML", "Text", "SpreadsheetDocument", "BinaryData")]
|
||||
[ValidateSet("HTML", "Text", "SpreadsheetDocument", "BinaryData", "DataCompositionSchema")]
|
||||
[string]$TemplateType,
|
||||
|
||||
[string]$Synonym = $TemplateName,
|
||||
@@ -23,6 +25,7 @@ $typeMap = @{
|
||||
"Text" = @{ TemplateType = "TextDocument"; Ext = ".txt" }
|
||||
"SpreadsheetDocument" = @{ TemplateType = "SpreadsheetDocument"; Ext = ".xml" }
|
||||
"BinaryData" = @{ TemplateType = "BinaryData"; Ext = ".bin" }
|
||||
"DataCompositionSchema" = @{ TemplateType = "DataCompositionSchema"; Ext = ".xml" }
|
||||
}
|
||||
|
||||
$tmpl = $typeMap[$TemplateType]
|
||||
@@ -111,6 +114,25 @@ switch ($TemplateType) {
|
||||
"BinaryData" {
|
||||
[System.IO.File]::WriteAllBytes($templateFilePath, @())
|
||||
}
|
||||
"DataCompositionSchema" {
|
||||
$content = @"
|
||||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<DataCompositionSchema xmlns="http://v8.1c.ru/8.1/data-composition-system/schema"
|
||||
xmlns:dcscom="http://v8.1c.ru/8.1/data-composition-system/common"
|
||||
xmlns:dcscor="http://v8.1c.ru/8.1/data-composition-system/core"
|
||||
xmlns:dcsset="http://v8.1c.ru/8.1/data-composition-system/settings"
|
||||
xmlns:v8="http://v8.1c.ru/8.1/data/core"
|
||||
xmlns:v8ui="http://v8.1c.ru/8.1/data/ui"
|
||||
xmlns:xs="http://www.w3.org/2001/XMLSchema"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
|
||||
<dataSource>
|
||||
<name>ИсточникДанных1</name>
|
||||
<dataSourceType>Local</dataSourceType>
|
||||
</dataSource>
|
||||
</DataCompositionSchema>
|
||||
"@
|
||||
[System.IO.File]::WriteAllText($templateFilePath, $content, $encBom)
|
||||
}
|
||||
}
|
||||
|
||||
# --- 3. Модификация корневого XML ---
|
||||
|
||||
@@ -1,4 +1,6 @@
|
||||
param(
|
||||
# epf-init v1.0 — Init 1C external data processor scaffold
|
||||
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
|
||||
param(
|
||||
[Parameter(Mandatory)]
|
||||
[string]$Name,
|
||||
|
||||
|
||||
@@ -1,4 +1,6 @@
|
||||
param(
|
||||
# epf-remove-form v1.0 — Remove form from 1C processor
|
||||
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
|
||||
param(
|
||||
[Parameter(Mandatory)]
|
||||
[string]$ProcessorName,
|
||||
|
||||
|
||||
@@ -1,4 +1,6 @@
|
||||
param(
|
||||
# epf-remove-template v1.0 — Remove template from 1C processor
|
||||
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
|
||||
param(
|
||||
[Parameter(Mandatory)]
|
||||
[string]$ProcessorName,
|
||||
|
||||
|
||||
@@ -1,4 +1,6 @@
|
||||
param(
|
||||
# form-add v1.0 — Add managed form to 1C config object
|
||||
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
|
||||
param(
|
||||
[Parameter(Mandatory)]
|
||||
[string]$ObjectPath,
|
||||
|
||||
|
||||
@@ -1,4 +1,6 @@
|
||||
param(
|
||||
# form-compile v1.0 — Compile 1C managed form from JSON
|
||||
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
|
||||
param(
|
||||
[Parameter(Mandatory)]
|
||||
[string]$JsonPath,
|
||||
|
||||
|
||||
@@ -1,4 +1,6 @@
|
||||
param(
|
||||
# form-edit v1.0 — Edit 1C managed form elements
|
||||
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
|
||||
param(
|
||||
[Parameter(Mandatory)]
|
||||
[string]$FormPath,
|
||||
|
||||
|
||||
@@ -1,4 +1,6 @@
|
||||
param(
|
||||
# form-info v1.0 — Analyze 1C managed form structure
|
||||
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
|
||||
param(
|
||||
[Parameter(Mandatory=$true)]
|
||||
[string]$FormPath,
|
||||
[int]$Limit = 150,
|
||||
|
||||
@@ -1,4 +1,6 @@
|
||||
param(
|
||||
# form-validate v1.0 — Validate 1C managed form
|
||||
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
|
||||
param(
|
||||
[Parameter(Mandatory)]
|
||||
[string]$FormPath,
|
||||
|
||||
|
||||
@@ -1,4 +1,6 @@
|
||||
param(
|
||||
# mxl-compile v1.0 — Compile 1C spreadsheet from JSON
|
||||
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
|
||||
param(
|
||||
[Parameter(Mandatory)]
|
||||
[string]$JsonPath,
|
||||
|
||||
|
||||
@@ -1,4 +1,6 @@
|
||||
param(
|
||||
# mxl-decompile v1.0 — Decompile 1C spreadsheet to JSON
|
||||
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
|
||||
param(
|
||||
[Parameter(Mandatory)]
|
||||
[string]$TemplatePath,
|
||||
|
||||
|
||||
@@ -1,4 +1,6 @@
|
||||
param(
|
||||
# mxl-info v1.0 — Analyze 1C spreadsheet structure
|
||||
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
|
||||
param(
|
||||
[string]$TemplatePath,
|
||||
[string]$ProcessorName,
|
||||
[string]$TemplateName,
|
||||
|
||||
@@ -1,4 +1,6 @@
|
||||
param(
|
||||
# mxl-validate v1.0 — Validate 1C spreadsheet
|
||||
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
|
||||
param(
|
||||
[string]$TemplatePath,
|
||||
[string]$ProcessorName,
|
||||
[string]$TemplateName,
|
||||
|
||||
@@ -1,4 +1,6 @@
|
||||
param(
|
||||
# role-compile v1.0 — Compile 1C role from JSON
|
||||
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
|
||||
param(
|
||||
[Parameter(Mandatory)]
|
||||
[string]$JsonPath,
|
||||
|
||||
|
||||
@@ -1,4 +1,6 @@
|
||||
param(
|
||||
# role-info v1.0 — Analyze 1C role rights
|
||||
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
|
||||
param(
|
||||
[Parameter(Mandatory=$true)][string]$RightsPath,
|
||||
[switch]$ShowDenied,
|
||||
[int]$Limit = 150,
|
||||
|
||||
@@ -1,4 +1,6 @@
|
||||
param(
|
||||
# role-validate v1.0 — Validate 1C role structure
|
||||
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
|
||||
param(
|
||||
[Parameter(Mandatory)]
|
||||
[string]$RightsPath,
|
||||
|
||||
|
||||
@@ -0,0 +1,225 @@
|
||||
---
|
||||
name: skd-compile
|
||||
description: Компиляция схемы компоновки данных 1С (СКД) — Template.xml из компактного JSON-определения
|
||||
argument-hint: <JsonPath> <OutputPath>
|
||||
allowed-tools:
|
||||
- Bash
|
||||
- Read
|
||||
- Write
|
||||
- Glob
|
||||
---
|
||||
|
||||
# /skd-compile — генерация СКД из JSON DSL
|
||||
|
||||
Принимает JSON-определение схемы компоновки данных → генерирует Template.xml (DataCompositionSchema).
|
||||
|
||||
## Параметры и команда
|
||||
|
||||
| Параметр | Описание |
|
||||
|----------|----------|
|
||||
| `JsonPath` | Путь к JSON-определению СКД |
|
||||
| `OutputPath` | Путь к выходному Template.xml |
|
||||
|
||||
```powershell
|
||||
powershell.exe -NoProfile -File .claude\skills\skd-compile\scripts\skd-compile.ps1 -JsonPath "<json>" -OutputPath "<Template.xml>"
|
||||
```
|
||||
|
||||
## JSON DSL — краткий справочник
|
||||
|
||||
Полная спецификация: `docs/skd-dsl-spec.md`.
|
||||
|
||||
### Корневая структура
|
||||
|
||||
```json
|
||||
{
|
||||
"dataSets": [...],
|
||||
"calculatedFields": [...],
|
||||
"totalFields": [...],
|
||||
"parameters": [...],
|
||||
"dataSetLinks": [...],
|
||||
"settingsVariants": [...]
|
||||
}
|
||||
```
|
||||
|
||||
Умолчания: `dataSources` → авто `ИсточникДанных1/Local`; `settingsVariants` → авто "Основной" с деталями.
|
||||
|
||||
### Наборы данных
|
||||
|
||||
Тип по ключу: `query` → DataSetQuery, `objectName` → DataSetObject, `items` → DataSetUnion.
|
||||
|
||||
```json
|
||||
{ "name": "Продажи", "query": "ВЫБРАТЬ ...", "fields": [...] }
|
||||
```
|
||||
|
||||
### Поля — shorthand
|
||||
|
||||
```
|
||||
"Наименование" — просто имя
|
||||
"Количество: decimal(15,2)" — имя + тип
|
||||
"Организация: CatalogRef.Организации @dimension" — + роль
|
||||
"Служебное: string #noFilter #noOrder" — + ограничения
|
||||
```
|
||||
|
||||
Типы: `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`.
|
||||
|
||||
### Итоги (shorthand)
|
||||
|
||||
```json
|
||||
"totalFields": ["Количество: Сумма", "Стоимость: Сумма(Кол * Цена)"]
|
||||
```
|
||||
|
||||
### Параметры (shorthand + @autoDates)
|
||||
|
||||
```json
|
||||
"parameters": [
|
||||
"Период: StandardPeriod = LastMonth @autoDates"
|
||||
]
|
||||
```
|
||||
|
||||
`@autoDates` — автоматически генерирует параметры `ДатаНачала` и `ДатаОкончания` с выражениями `&Период.ДатаНачала` / `&Период.ДатаОкончания` и `availableAsField=false`. Заменяет 5 строк на 1.
|
||||
|
||||
### Фильтры — 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
|
||||
|
||||
```json
|
||||
"dataParameters": [
|
||||
"Период = LastMonth @user",
|
||||
"Организация @off @user"
|
||||
]
|
||||
```
|
||||
|
||||
Формат: `"Имя [= значение] @флаги"`. Для StandardPeriod варианты (LastMonth, ThisYear и т.д.) распознаются автоматически.
|
||||
|
||||
### Структура — string shorthand
|
||||
|
||||
```json
|
||||
"structure": "Организация > details"
|
||||
"structure": "Организация > Номенклатура > details"
|
||||
```
|
||||
|
||||
`>` разделяет уровни группировки. `details` (или `детали`) = детальные записи. `selection` и `order` по умолчанию `["Auto"]` на каждом уровне.
|
||||
|
||||
Для сложных случаев (таблицы, диаграммы, фильтры на уровне группировки) используется объектная форма.
|
||||
|
||||
### Варианты настроек
|
||||
|
||||
```json
|
||||
"settingsVariants": [{
|
||||
"name": "Основной",
|
||||
"settings": {
|
||||
"selection": ["Номенклатура", "Количество", "Auto"],
|
||||
"filter": ["Организация = _ @off @user"],
|
||||
"order": ["Количество desc", "Auto"],
|
||||
"conditionalAppearance": [
|
||||
{
|
||||
"filter": ["Просрочено = true"],
|
||||
"appearance": { "ЦветТекста": "style:ПросроченныеДанныеЦвет" },
|
||||
"presentation": "Выделять просроченные",
|
||||
"viewMode": "Normal",
|
||||
"userSettingID": "auto"
|
||||
}
|
||||
],
|
||||
"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.
|
||||
|
||||
### Итоги с привязкой к группировкам
|
||||
|
||||
```json
|
||||
"totalFields": [
|
||||
{ "dataPath": "Кол", "expression": "Сумма(Кол)", "group": ["Группа1", "Группа1 Иерархия", "ОбщийИтог"] }
|
||||
]
|
||||
```
|
||||
|
||||
## Примеры
|
||||
|
||||
### Минимальный
|
||||
|
||||
```json
|
||||
{
|
||||
"dataSets": [{
|
||||
"query": "ВЫБРАТЬ Номенклатура.Наименование КАК Наименование ИЗ Справочник.Номенклатура КАК Номенклатура",
|
||||
"fields": ["Наименование"]
|
||||
}]
|
||||
}
|
||||
```
|
||||
|
||||
### С ресурсами, параметрами и @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 — проверка варианта настроек
|
||||
```
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,217 @@
|
||||
---
|
||||
name: skd-edit
|
||||
description: Точечное редактирование схемы компоновки данных 1С (СКД) — добавление/удаление полей, итогов, фильтров, параметров, вычисляемых полей
|
||||
argument-hint: <TemplatePath> -Operation <op> -Value <value>
|
||||
allowed-tools:
|
||||
- Bash
|
||||
- Read
|
||||
- Write
|
||||
- Glob
|
||||
---
|
||||
|
||||
# /skd-edit — точечное редактирование СКД (Template.xml)
|
||||
|
||||
Атомарные операции модификации существующей схемы компоновки данных: добавление, удаление и модификация полей, итогов, фильтров, параметров, настроек варианта, управление структурой, замена запроса.
|
||||
|
||||
## Параметры и команда
|
||||
|
||||
| Параметр | Описание |
|
||||
|----------|----------|
|
||||
| `TemplatePath` | Путь к Template.xml (или к папке — автодополнение Ext/Template.xml) |
|
||||
| `Operation` | Операция (см. список ниже) |
|
||||
| `Value` | Значение операции (shorthand-строка или текст запроса) |
|
||||
| `DataSet` | (опц.) Имя набора данных (умолч. первый) |
|
||||
| `Variant` | (опц.) Имя варианта настроек (умолч. первый) |
|
||||
| `NoSelection` | (опц.) Не добавлять поле в selection варианта |
|
||||
|
||||
```powershell
|
||||
powershell.exe -NoProfile -File .claude\skills\skd-edit\scripts\skd-edit.ps1 -TemplatePath "<path>" -Operation <op> -Value "<value>"
|
||||
```
|
||||
|
||||
## Пакетный режим (batch)
|
||||
|
||||
Несколько значений в одном вызове через разделитель `;;`:
|
||||
|
||||
```powershell
|
||||
-Operation add-field -Value "Цена: decimal(15,2) ;; Количество: decimal(15,3) ;; Сумма: decimal(15,2)"
|
||||
```
|
||||
|
||||
Работает для всех операций кроме `set-query`, `set-structure` и `add-dataSet`.
|
||||
|
||||
## Операции
|
||||
|
||||
### add-field — добавить поле в набор данных
|
||||
|
||||
Shorthand: `"Имя [Заголовок]: тип @роль #ограничение"`.
|
||||
|
||||
```
|
||||
"Цена: decimal(15,2)"
|
||||
"Организация [Орг-ция]: CatalogRef.Организации @dimension"
|
||||
"Служебное: string #noFilter #noOrder"
|
||||
```
|
||||
|
||||
Поле добавляется в набор и в selection варианта (если нет `-NoSelection`). Дубликат dataPath — предупреждение, пропуск.
|
||||
|
||||
### add-total — добавить итог
|
||||
|
||||
```
|
||||
"Цена: Среднее"
|
||||
"Стоимость: Сумма(Кол * Цена)"
|
||||
```
|
||||
|
||||
### add-calculated-field — добавить вычисляемое поле
|
||||
|
||||
Shorthand: `"Имя [Заголовок]: тип = Выражение"`.
|
||||
|
||||
```
|
||||
"Маржа = Продажа - Закупка"
|
||||
"Наценка [Наценка, %]: decimal(10,2) = Маржа / Закупка * 100"
|
||||
```
|
||||
|
||||
Также добавляется в selection варианта.
|
||||
|
||||
### add-parameter — добавить параметр
|
||||
|
||||
```
|
||||
"Период: StandardPeriod = LastMonth @autoDates"
|
||||
"Организация: CatalogRef.Организации"
|
||||
```
|
||||
|
||||
`@autoDates` генерирует `ДатаНачала` и `ДатаОкончания` автоматически.
|
||||
|
||||
### add-filter — добавить фильтр в вариант
|
||||
|
||||
Shorthand: `"Поле оператор значение @флаги"`. Флаги: `@off`, `@user`, `@quickAccess`, `@normal`, `@inaccessible`.
|
||||
|
||||
```
|
||||
"Номенклатура = _ @off @user"
|
||||
"Дата >= 2024-01-01T00:00:00"
|
||||
"Статус filled"
|
||||
```
|
||||
|
||||
### add-dataParameter — добавить параметр данных в вариант
|
||||
|
||||
Shorthand: `"Имя [= значение] @флаги"`.
|
||||
|
||||
```
|
||||
"Период = LastMonth @user"
|
||||
"Организация @off @user"
|
||||
```
|
||||
|
||||
### add-order — добавить сортировку
|
||||
|
||||
Shorthand: `"Поле [desc]"`. По умолчанию asc. `Auto` — авто-элемент.
|
||||
|
||||
```
|
||||
"Количество desc"
|
||||
"Auto"
|
||||
```
|
||||
|
||||
### add-selection — добавить элемент выборки
|
||||
|
||||
```
|
||||
"Номенклатура"
|
||||
"Auto"
|
||||
```
|
||||
|
||||
### add-dataSetLink — добавить связь наборов данных
|
||||
|
||||
Shorthand: `"Источник > Приёмник on ВырИсточника = ВырПриёмника [param Имя]"`.
|
||||
|
||||
```
|
||||
"Набор1 > Набор2 on Поле1 = Поле2"
|
||||
"Набор1 > Набор2 on Поле1 = Поле2 [param Связь]"
|
||||
```
|
||||
|
||||
### add-dataSet — добавить набор данных
|
||||
|
||||
Shorthand: `"Имя: ТЕКСТ_ЗАПРОСА"` или `"ТЕКСТ_ЗАПРОСА"` (авто-имя `НаборДанныхN`).
|
||||
|
||||
```
|
||||
"Доп: ВЫБРАТЬ 1 КАК Тест"
|
||||
"ВЫБРАТЬ Ссылка ИЗ Справочник.Номенклатура"
|
||||
```
|
||||
|
||||
`dataSource` берётся из первого существующего. Дубликат имени — предупреждение, пропуск. Не поддерживает пакетный режим (запрос может содержать `;;`).
|
||||
|
||||
### add-variant — добавить вариант настроек
|
||||
|
||||
Shorthand: `"Имя [Представление]"`. Представление опционально, по умолчанию = имя.
|
||||
|
||||
```
|
||||
"Детальный"
|
||||
"Детальный [Детальный отчёт]"
|
||||
```
|
||||
|
||||
Создаёт вариант с Auto selection + detail group. Дубликат имени — предупреждение, пропуск.
|
||||
|
||||
### add-conditionalAppearance — добавить условное оформление
|
||||
|
||||
Shorthand: `"Параметр = значение [when условие] [for Поле1, Поле2]"`. Блок `when` — синтаксис `add-filter` (Поле оператор значение).
|
||||
|
||||
```
|
||||
"ЦветТекста = web:Red when Сумма < 0"
|
||||
"ЦветФона = web:LightGreen when Статус = Одобрен for Статус"
|
||||
"МинимальнаяШирина = 50 for Организация"
|
||||
"Формат = ЧДЦ=2 for Цена, Сумма"
|
||||
```
|
||||
|
||||
Типы значений (автодетект): `web:*`/`style:*`/`win:*` → цвет, `true`/`false` → boolean, иначе строка.
|
||||
|
||||
### set-query — заменить текст запроса
|
||||
|
||||
Не поддерживает пакетный режим. Value — полный текст запроса.
|
||||
|
||||
### set-outputParameter — установить параметр вывода
|
||||
|
||||
```
|
||||
"Заголовок = Мой отчёт"
|
||||
"ВыводитьЗаголовок = true"
|
||||
```
|
||||
|
||||
Если параметр уже существует — заменяет значение.
|
||||
|
||||
### set-structure — установить структуру варианта
|
||||
|
||||
Shorthand: `"Поле1 > Поле2 > details"`. `details`/`детали` — детальные записи. Заменяет всю структуру. Не поддерживает пакетный режим.
|
||||
|
||||
```
|
||||
"Организация > Номенклатура > details"
|
||||
"details"
|
||||
```
|
||||
|
||||
### modify-field — изменить существующее поле
|
||||
|
||||
Тот же shorthand что и `add-field`. Находит по dataPath, объединяет свойства (непустые переопределяют), сохраняет позицию.
|
||||
|
||||
```
|
||||
"Цена [Цена USD]: decimal(10,4) @dimension"
|
||||
```
|
||||
|
||||
### modify-filter — изменить существующий фильтр
|
||||
|
||||
Тот же shorthand что и `add-filter`. Находит по полю, обновляет оператор/значение/флаги.
|
||||
|
||||
### modify-dataParameter — изменить параметр данных
|
||||
|
||||
Тот же shorthand что и `add-dataParameter`. Находит по имени, обновляет значение/флаги.
|
||||
|
||||
### remove-* и clear-*
|
||||
|
||||
| Операция | Value | Действие |
|
||||
|----------|-------|----------|
|
||||
| `remove-field` | dataPath | Удаляет поле из набора + из selection варианта |
|
||||
| `remove-total` | dataPath | Удаляет итог |
|
||||
| `remove-calculated-field` | dataPath | Удаляет вычисляемое поле + из selection |
|
||||
| `remove-parameter` | name | Удаляет параметр |
|
||||
| `remove-filter` | поле | Удаляет первый фильтр с указанным полем |
|
||||
| `clear-selection` | `*` | Очищает все элементы selection |
|
||||
| `clear-order` | `*` | Очищает все элементы order |
|
||||
| `clear-filter` | `*` | Очищает все элементы filter |
|
||||
|
||||
## Верификация
|
||||
|
||||
```
|
||||
/skd-validate <TemplatePath> — валидация структуры после редактирования
|
||||
/skd-info <TemplatePath> — визуальная сводка
|
||||
```
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,74 @@
|
||||
---
|
||||
name: skd-info
|
||||
description: Анализ структуры схемы компоновки данных 1С (СКД) — наборы, поля, параметры, варианты
|
||||
argument-hint: <TemplatePath> [-Mode overview|query|fields|links|calculated|resources|params|variant|templates|trace] [-Name <dataset|variant|field|group>]
|
||||
allowed-tools:
|
||||
- Bash
|
||||
- Read
|
||||
- Glob
|
||||
---
|
||||
|
||||
# /skd-info — Анализ схемы компоновки данных
|
||||
|
||||
Читает Template.xml схемы компоновки данных (СКД) и выводит компактную сводку. Заменяет необходимость читать тысячи строк XML.
|
||||
|
||||
## Параметры и команда
|
||||
|
||||
| Параметр | Описание |
|
||||
|----------|----------|
|
||||
| `TemplatePath` | Путь к Template.xml или каталогу макета (авто-резолв в `Ext/Template.xml`) |
|
||||
| `Mode` | Режим анализа (по умолчанию `overview`) |
|
||||
| `Name` | Имя набора (query), поля (fields/calculated/resources/trace), варианта (variant) или группировки/поля (templates) |
|
||||
| `Batch` | Номер пакета запроса, 0 = все (только query) |
|
||||
| `Limit` / `Offset` | Пагинация (по умолчанию 150 строк) |
|
||||
| `OutFile` | Записать результат в файл (UTF-8 BOM) |
|
||||
|
||||
```powershell
|
||||
powershell.exe -NoProfile -File .claude\skills\skd-info\scripts\skd-info.ps1 -TemplatePath "<путь>"
|
||||
```
|
||||
|
||||
С указанием режима:
|
||||
```powershell
|
||||
... -Mode query -Name НоменклатураСЦенами
|
||||
... -Mode query -Name ДанныеТ13 -Batch 3
|
||||
... -Mode fields -Name КадастроваяСтоимость
|
||||
... -Mode calculated -Name КоэффициентКи
|
||||
... -Mode resources -Name СуммаНалога
|
||||
... -Mode trace -Name "Коэффициент Ки"
|
||||
... -Mode variant -Name 1
|
||||
... -Mode templates
|
||||
... -Mode templates -Name ВидНалоговойБазы
|
||||
```
|
||||
|
||||
## Режимы
|
||||
|
||||
| Режим | Без `-Name` | С `-Name` |
|
||||
|-------|-------------|-----------|
|
||||
| `overview` | Навигационная карта схемы + подсказки Next | — |
|
||||
| `query` | — | Текст запроса набора (с оглавлением батчей) |
|
||||
| `fields` | Карта: имена полей по наборам | Деталь поля: набор, тип, роль, формат |
|
||||
| `links` | Все связи наборов | — |
|
||||
| `calculated` | Карта: имена вычисляемых полей | Выражение + заголовок + ограничения |
|
||||
| `resources` | Карта: имена ресурсов (`*` = групповые формулы) | Формулы агрегации по группировкам |
|
||||
| `params` | Таблица параметров: тип, значение, видимость | — |
|
||||
| `variant` | Список вариантов | Структура группировок + фильтры + вывод |
|
||||
| `templates` | Карта привязок шаблонов (field/group) | Содержимое шаблона: строки, ячейки, выражения |
|
||||
| `trace` | — | Полная цепочка: набор → вычисление → ресурс |
|
||||
|
||||
Паттерн: без `-Name` — карта/индекс, с `-Name` — деталь конкретного элемента.
|
||||
|
||||
## Типичный workflow
|
||||
|
||||
1. `overview` — понять структуру, увидеть подсказки
|
||||
2. `trace -Name <поле>` — узнать как считается колонка отчёта (от заголовка до запроса за один вызов)
|
||||
3. `query -Name <набор>` — посмотреть текст SQL-запроса
|
||||
4. `variant -Name <N>` — посмотреть группировки и фильтры варианта
|
||||
|
||||
Подробные примеры вывода каждого режима — в `modes-reference.md`.
|
||||
|
||||
## Верификация
|
||||
|
||||
```
|
||||
/skd-info <path> — overview (точка входа)
|
||||
/skd-info <path> -Mode trace -Name <field> — трассировка поля
|
||||
```
|
||||
@@ -0,0 +1,246 @@
|
||||
# /skd-info — полная справка по режимам
|
||||
|
||||
Компактное описание — в [SKILL.md](SKILL.md).
|
||||
|
||||
## overview (по умолчанию) — карта схемы
|
||||
|
||||
Компактная навигационная карта (10-25 строк). Показывает структуру и подсказывает следующие шаги:
|
||||
|
||||
```
|
||||
=== DCS: ОсновнаяСхемаКомпоновкиДанных (362 lines) ===
|
||||
|
||||
Sources: ИсточникДанных1 (Local)
|
||||
|
||||
Datasets:
|
||||
[Query] НоменклатураСЦенами 7 fields, query 40 lines
|
||||
Calculated: 1
|
||||
Resources: 1
|
||||
Templates: 1 templates, 1 group bindings
|
||||
Params: (none)
|
||||
|
||||
Variants:
|
||||
[1] НоменклатураИЦены "Номенклатура и цены" Table(detail) 3 filters
|
||||
[2] НоменклатураБезЦен "Номенклатура без цен" Group(detail) 2 filters
|
||||
|
||||
Next:
|
||||
-Mode query query text
|
||||
-Mode fields field tables by dataset
|
||||
-Mode calculated calculated field expressions
|
||||
-Mode resources resource aggregation
|
||||
-Mode variant -Name <N> variant structure (1..2)
|
||||
```
|
||||
|
||||
Для DataSetUnion — дерево наборов + связи:
|
||||
```
|
||||
Datasets:
|
||||
[Union] РасчетНалогаНаИмущество 52 fields
|
||||
├─ [Query] РасчетНалогаНаИмущество 51 fields, query 181 lines
|
||||
├─ [Query] ДанныеПоКадастровой 29 fields, query 40 lines
|
||||
├─ [Query] ДанныеПоСреднегодовой 34 fields, query 41 lines
|
||||
Links: РасчетНалогаНаИмущество -> СостояниеОС (2 fields)
|
||||
```
|
||||
|
||||
Параметры разделяются на видимые/скрытые:
|
||||
```
|
||||
Params: 18 (7 visible, 11 hidden): Период, Ответственный, ...
|
||||
```
|
||||
|
||||
## query — текст запроса
|
||||
|
||||
`-Name <набор>` — имя DataSet (обязателен если наборов > 1).
|
||||
|
||||
Извлекает raw-текст запроса с деэкранированием XML (`&`→`&`, `>`→`>`). Для пакетных запросов — оглавление батчей:
|
||||
|
||||
```
|
||||
=== Query: ДанныеТ13 (334 lines, 13 batches) ===
|
||||
Batch 1: lines 1-8 → ПОМЕСТИТЬ Представления_Периоды
|
||||
Batch 2: lines 9-26 → ПОМЕСТИТЬ Представления_СотрудникиОрганизации
|
||||
...
|
||||
--- Batch 1 ---
|
||||
ВЫБРАТЬ
|
||||
ДАТАВРЕМЯ(1, 1, 1) КАК Период
|
||||
ПОМЕСТИТЬ Представления_Периоды
|
||||
...
|
||||
```
|
||||
|
||||
Фильтр по номеру батча: `-Batch 3` покажет только 3-й пакет.
|
||||
|
||||
## fields — поля наборов данных
|
||||
|
||||
Без `-Name` — карта: имена полей по наборам:
|
||||
```
|
||||
=== Fields map ===
|
||||
СостояниеОС [Query] (3): Организация, ОсновноеСредство, ДатаСостояния
|
||||
РасчетНалогаНаИмущество [Union] (52): ДоляСтоимостиЧислитель, ...
|
||||
РасчетНалогаНаИмущество [Query] (51): КадастроваяСтоимость, ...
|
||||
```
|
||||
|
||||
С `-Name <поле>` — детали конкретного поля:
|
||||
```
|
||||
=== Field: ДатаСостояния "Дата ввода в эксплуатацию" ===
|
||||
|
||||
Dataset: СостояниеОС [Query]
|
||||
Format: ДФ=dd.MM.yyyy
|
||||
```
|
||||
|
||||
Показывает: dataset, title, type, role, useRestriction, format, presentationExpression.
|
||||
|
||||
## links — связи наборов данных
|
||||
|
||||
```
|
||||
=== Links (4) ===
|
||||
|
||||
РасчетНалогаНаИмущество -> СостояниеОС :
|
||||
Организация -> Организация
|
||||
ОсновноеСредство -> ОсновноеСредство
|
||||
```
|
||||
|
||||
Группирует по парам наборов. Показывает поля связи и параметры.
|
||||
|
||||
## calculated — вычисляемые поля
|
||||
|
||||
Без `-Name` — карта: имена и заголовки:
|
||||
```
|
||||
=== Calculated fields (23) ===
|
||||
ДоляСтоимости "Доля стоимости"
|
||||
КоэффициентКи "Коэффициент Ки"
|
||||
...
|
||||
```
|
||||
|
||||
С `-Name <поле>` — полное выражение:
|
||||
```
|
||||
=== Calculated: ДоляСтоимости ===
|
||||
|
||||
Expression:
|
||||
ВЫБОР КОГДА ... ТОГДА "1" ИНАЧЕ ... КОНЕЦ
|
||||
Title: Доля стоимости
|
||||
Restrict: condition
|
||||
```
|
||||
|
||||
## resources — ресурсы (итоги по группировкам)
|
||||
|
||||
Без `-Name` — карта: имена полей, `*` = есть формулы по группировкам:
|
||||
```
|
||||
=== Resources (51) ===
|
||||
НалоговаяБаза
|
||||
КоэффициентКи *
|
||||
...
|
||||
* = has group-level formulas
|
||||
```
|
||||
|
||||
С `-Name <поле>` — формулы агрегации:
|
||||
```
|
||||
=== Resource: ДатаСостояния ===
|
||||
|
||||
[ОсновноеСредство] ЕстьNull(ДатаСостояния, "")
|
||||
```
|
||||
|
||||
## params — параметры схемы
|
||||
|
||||
```
|
||||
=== Parameters (16) ===
|
||||
Name Type Default Visible Expression
|
||||
Период StandardPeriod LastMonth yes -
|
||||
НачалоПериода DateTime - hidden &Период.ДатаНачала
|
||||
Организация CatalogRef.Организации null yes -
|
||||
```
|
||||
|
||||
## variant — варианты отчёта
|
||||
|
||||
Без `-Name` — список вариантов:
|
||||
```
|
||||
=== Variants (2) ===
|
||||
[1] НоменклатураИЦены "Номенклатура и цены" Table(detail) 3 filters
|
||||
[2] НоменклатураБезЦен "Номенклатура без цен" Group(detail) 2 filters
|
||||
```
|
||||
|
||||
С `-Name <N|имя>` — структура конкретного варианта:
|
||||
```
|
||||
=== Variant [1]: НоменклатураИЦены "Номенклатура и цены" ===
|
||||
|
||||
Structure:
|
||||
Table "Таблица"
|
||||
├── Columns: [ТипЦен Items]
|
||||
│ Selection: Auto, Цена
|
||||
└── Rows: [Номенклатура Items]
|
||||
Selection: Номенклатура, УИД, Auto
|
||||
|
||||
Filter:
|
||||
[ ] Номенклатура InHierarchy [user]
|
||||
[ ] ТипЦен Equal
|
||||
[x] ВАрхиве = false "Исключая скрытые товары"
|
||||
|
||||
DataParams: КлючВарианта="НоменклатураИЦены"
|
||||
Output: style=ЧерноБелый groups=Separately totalsH=None totalsV=None
|
||||
```
|
||||
|
||||
## templates — привязки шаблонов вывода
|
||||
|
||||
Три типа привязок: `fieldTemplate` (к полю), `groupTemplate` (к группировке, Header/Footer), `groupHeaderTemplate` (заголовок группы).
|
||||
|
||||
Без `-Name` — карта привязок:
|
||||
```
|
||||
=== Templates (70 defined: 49 field, 37 group) ===
|
||||
|
||||
Field bindings (49): (all trivial)
|
||||
ОстаточнаяСтоимостьНа0101, ОстаточнаяСтоимостьНа0102, ...
|
||||
|
||||
Group bindings (37):
|
||||
ВидНалоговойБазы
|
||||
Header -> Макет3 (1 rows, 1 params)
|
||||
СреднегодоваяСтоимость2019
|
||||
Footer -> Макет50 (1 rows) spacer
|
||||
GroupHeader -> Макет40 (3 rows)
|
||||
```
|
||||
|
||||
С `-Name <группировка|поле>` — содержимое шаблонов:
|
||||
```
|
||||
=== Templates: СреднегодоваяСтоимость2019 ===
|
||||
|
||||
Footer -> Макет50 [1 rows, 1 cells]:
|
||||
Row 1: (empty)
|
||||
|
||||
GroupHeader -> Макет40 [3 rows, 78 cells]:
|
||||
Row 1: "№ п/п" | "###Группировки1###" | "Инв. номер" | ...
|
||||
Row 2: "01.01" | "01.02" | ... | "31.12"
|
||||
Row 3: "1" | "2" | ... | "26"
|
||||
```
|
||||
|
||||
Для field-привязок:
|
||||
```
|
||||
=== Field template: ОстаточнаяСтоимостьНа0101 -> Макет4 ===
|
||||
[1 rows, 1 cells]
|
||||
Row 1: {ОстаточнаяСтоимостьНа0101}
|
||||
(all params trivial)
|
||||
```
|
||||
|
||||
**Тривиальность выражений**: `Поле = Поле` и `Поле = Представление(Поле)` считаются тривиальными и НЕ выводятся. Показываются только нетривиальные — когда выражение содержит другое поле, вызов метода, пустую строку и т.д.
|
||||
|
||||
## trace — трассировка поля от заголовка до запроса
|
||||
|
||||
Ищет поле по dataPath ИЛИ заголовку (включая подстроку) и показывает полную цепочку происхождения за один вызов:
|
||||
|
||||
```
|
||||
=== Trace: КоэффициентКи "Коэффициент Ки" ===
|
||||
|
||||
Dataset: (schema-level only, not in dataset fields)
|
||||
|
||||
Calculated:
|
||||
ВЫБОР КОГДА ... ТОГДА 0 ИНАЧЕ ... КОНЕЦ
|
||||
Operands:
|
||||
КоличествоМесяцевИспользования -> РасчетНалогаНаИмущество [Query]
|
||||
КоличествоМесяцевВладения -> РасчетНалогаНаИмущество [Query]
|
||||
|
||||
Resource:
|
||||
[ОсновноеСредство] Сумма(КоэффициентКи)
|
||||
```
|
||||
|
||||
Типичный сценарий: пользователь видит колонку "Коэффициент Ки" в отчёте и спрашивает как она считается. Один вызов `trace` показывает: формулу вычисления, откуда берутся операнды, как агрегируется в ресурс.
|
||||
|
||||
## Что не выводится
|
||||
|
||||
- XML namespace-декларации
|
||||
- Обёртки v8:item/v8:lang/v8:content (извлекаем чистый текст)
|
||||
- userSettingID (GUID-ы пользовательских настроек)
|
||||
- Дефолтные periodAdditionBegin/End = 0001-01-01
|
||||
- viewMode
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,74 @@
|
||||
---
|
||||
name: skd-validate
|
||||
description: Валидация структурной корректности схемы компоновки данных 1С (СКД) — Template.xml
|
||||
argument-hint: <TemplatePath> [-MaxErrors 20]
|
||||
allowed-tools:
|
||||
- Bash
|
||||
- Read
|
||||
- Glob
|
||||
---
|
||||
|
||||
# /skd-validate — валидация СКД (DataCompositionSchema)
|
||||
|
||||
Проверяет структурную корректность Template.xml схемы компоновки данных. Выявляет ошибки формата, битые ссылки, дубликаты имён.
|
||||
|
||||
## Параметры и команда
|
||||
|
||||
| Параметр | Описание |
|
||||
|----------|----------|
|
||||
| `TemplatePath` | Путь к Template.xml или каталогу макета (авто-резолв в `Ext/Template.xml`) |
|
||||
| `MaxErrors` | Макс. ошибок до остановки (по умолчанию 20) |
|
||||
| `OutFile` | Записать результат в файл |
|
||||
|
||||
```powershell
|
||||
powershell.exe -NoProfile -File .claude\skills\skd-validate\scripts\skd-validate.ps1 -TemplatePath "<путь>"
|
||||
```
|
||||
|
||||
## Проверки (~30)
|
||||
|
||||
| Группа | Что проверяется |
|
||||
|--------|-----------------|
|
||||
| **Root** | XML parse, корневой элемент `DataCompositionSchema`, default namespace, ns-префиксы |
|
||||
| **DataSource** | Наличие, name не пуст, type валиден (Local/External), уникальность имён |
|
||||
| **DataSet** | Наличие, xsi:type валиден, name не пуст, уникальность, ссылка на dataSource, query не пуст |
|
||||
| **Fields** | dataPath не пуст, field не пуст, уникальность dataPath в наборе |
|
||||
| **Links** | source/dest ссылаются на существующие наборы, expressions не пусты |
|
||||
| **CalcFields** | dataPath не пуст, expression не пуст, уникальность, коллизии с полями наборов |
|
||||
| **TotalFields** | dataPath не пуст, expression не пуст |
|
||||
| **Parameters** | name не пуст, уникальность |
|
||||
| **Templates** | name не пуст, уникальность |
|
||||
| **GroupTemplates** | template ссылается на существующий template, templateType валиден |
|
||||
| **Variants** | Наличие, name не пуст, settings element присутствует |
|
||||
| **Settings** | selection/filter/order ссылаются на известные поля, comparisonType валиден, structure items типизированы |
|
||||
|
||||
## Коды выхода
|
||||
|
||||
| Код | Значение |
|
||||
|-----|----------|
|
||||
| 0 | Ошибок нет (могут быть предупреждения) |
|
||||
| 1 | Есть ошибки |
|
||||
|
||||
## Пример вывода
|
||||
|
||||
```
|
||||
=== Validation: Template.xml ===
|
||||
|
||||
[OK] XML parsed successfully
|
||||
[OK] Root element: DataCompositionSchema
|
||||
[OK] Default namespace correct
|
||||
[OK] 1 dataSource(s) found, names unique
|
||||
[OK] 1 dataSet(s) found, names unique
|
||||
[OK] DataSet "НаборДанных1": 2 fields, dataPath unique
|
||||
[OK] 1 totalField(s): dataPath and expression present
|
||||
[OK] 1 settingsVariant(s) found
|
||||
|
||||
=== Result: 0 errors, 0 warnings ===
|
||||
```
|
||||
|
||||
## Верификация
|
||||
|
||||
```
|
||||
/skd-compile <JsonPath> <OutputPath> — генерация XML
|
||||
/skd-validate <OutputPath> — проверка результата
|
||||
/skd-info <OutputPath> — визуальная сводка
|
||||
```
|
||||
@@ -0,0 +1,719 @@
|
||||
# skd-validate v1.0 — Validate 1C DCS structure
|
||||
# Source: https://github.com/Nikolay-Shirokov/cc-1c-skills
|
||||
param(
|
||||
[Parameter(Mandatory)]
|
||||
[string]$TemplatePath,
|
||||
|
||||
[int]$MaxErrors = 20,
|
||||
|
||||
[string]$OutFile
|
||||
)
|
||||
|
||||
$ErrorActionPreference = "Stop"
|
||||
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
||||
|
||||
# --- Resolve path ---
|
||||
|
||||
if (-not $TemplatePath.EndsWith(".xml")) {
|
||||
$candidate = Join-Path (Join-Path $TemplatePath "Ext") "Template.xml"
|
||||
if (Test-Path $candidate) {
|
||||
$TemplatePath = $candidate
|
||||
}
|
||||
}
|
||||
|
||||
if (-not (Test-Path $TemplatePath)) {
|
||||
Write-Error "File not found: $TemplatePath"
|
||||
exit 1
|
||||
}
|
||||
|
||||
$resolvedPath = (Resolve-Path $TemplatePath).Path
|
||||
$fileName = [System.IO.Path]::GetFileName($resolvedPath)
|
||||
|
||||
# --- Output infrastructure ---
|
||||
|
||||
$script:errors = 0
|
||||
$script:warnings = 0
|
||||
$script:stopped = $false
|
||||
$script:output = New-Object System.Text.StringBuilder 4096
|
||||
|
||||
function Out-Line {
|
||||
param([string]$msg)
|
||||
$script:output.AppendLine($msg) | Out-Null
|
||||
}
|
||||
|
||||
function Report-OK {
|
||||
param([string]$msg)
|
||||
Out-Line "[OK] $msg"
|
||||
}
|
||||
|
||||
function Report-Error {
|
||||
param([string]$msg)
|
||||
$script:errors++
|
||||
Out-Line "[ERROR] $msg"
|
||||
if ($script:errors -ge $MaxErrors) {
|
||||
$script:stopped = $true
|
||||
}
|
||||
}
|
||||
|
||||
function Report-Warn {
|
||||
param([string]$msg)
|
||||
$script:warnings++
|
||||
Out-Line "[WARN] $msg"
|
||||
}
|
||||
|
||||
$finalize = {
|
||||
Out-Line ""
|
||||
Out-Line "=== Result: $($script:errors) errors, $($script:warnings) warnings ==="
|
||||
|
||||
$result = $script:output.ToString()
|
||||
Write-Host $result
|
||||
|
||||
if ($OutFile) {
|
||||
$utf8Bom = New-Object System.Text.UTF8Encoding $true
|
||||
[System.IO.File]::WriteAllText($OutFile, $result, $utf8Bom)
|
||||
Write-Host "Written to: $OutFile"
|
||||
}
|
||||
}
|
||||
|
||||
Out-Line "=== Validation: $fileName ==="
|
||||
Out-Line ""
|
||||
|
||||
# --- 1. Parse XML ---
|
||||
|
||||
$xmlDoc = $null
|
||||
try {
|
||||
$xmlDoc = New-Object System.Xml.XmlDocument
|
||||
$xmlDoc.PreserveWhitespace = $false
|
||||
$xmlDoc.Load($resolvedPath)
|
||||
Report-OK "XML parsed successfully"
|
||||
} catch {
|
||||
Report-Error "XML parse failed: $($_.Exception.Message)"
|
||||
# Cannot continue
|
||||
$result = $script:output.ToString()
|
||||
Write-Host $result
|
||||
if ($OutFile) {
|
||||
$utf8Bom = New-Object System.Text.UTF8Encoding $true
|
||||
[System.IO.File]::WriteAllText($OutFile, $result, $utf8Bom)
|
||||
}
|
||||
exit 1
|
||||
}
|
||||
|
||||
# --- 2. Register namespaces ---
|
||||
|
||||
$ns = New-Object System.Xml.XmlNamespaceManager($xmlDoc.NameTable)
|
||||
$ns.AddNamespace("s", "http://v8.1c.ru/8.1/data-composition-system/schema")
|
||||
$ns.AddNamespace("dcscom", "http://v8.1c.ru/8.1/data-composition-system/common")
|
||||
$ns.AddNamespace("dcscor", "http://v8.1c.ru/8.1/data-composition-system/core")
|
||||
$ns.AddNamespace("dcsset", "http://v8.1c.ru/8.1/data-composition-system/settings")
|
||||
$ns.AddNamespace("v8", "http://v8.1c.ru/8.1/data/core")
|
||||
$ns.AddNamespace("v8ui", "http://v8.1c.ru/8.1/data/ui")
|
||||
$ns.AddNamespace("xs", "http://www.w3.org/2001/XMLSchema")
|
||||
$ns.AddNamespace("xsi", "http://www.w3.org/2001/XMLSchema-instance")
|
||||
$ns.AddNamespace("dcsat", "http://v8.1c.ru/8.1/data-composition-system/area-template")
|
||||
|
||||
$root = $xmlDoc.DocumentElement
|
||||
|
||||
# --- 3. Root element checks ---
|
||||
|
||||
if ($root.LocalName -ne "DataCompositionSchema") {
|
||||
Report-Error "Root element is '$($root.LocalName)', expected 'DataCompositionSchema'"
|
||||
} else {
|
||||
Report-OK "Root element: DataCompositionSchema"
|
||||
}
|
||||
|
||||
$expectedNs = "http://v8.1c.ru/8.1/data-composition-system/schema"
|
||||
if ($root.NamespaceURI -ne $expectedNs) {
|
||||
Report-Error "Default namespace is '$($root.NamespaceURI)', expected '$expectedNs'"
|
||||
} else {
|
||||
Report-OK "Default namespace correct"
|
||||
}
|
||||
|
||||
if ($script:stopped) { & $finalize; exit 1 }
|
||||
|
||||
# --- 4. Collect inventories ---
|
||||
|
||||
# DataSources
|
||||
$dataSourceNodes = $root.SelectNodes("s:dataSource", $ns)
|
||||
$dataSourceNames = @{}
|
||||
foreach ($dsn in $dataSourceNodes) {
|
||||
$name = $dsn.SelectSingleNode("s:name", $ns)
|
||||
if ($name) { $dataSourceNames[$name.InnerText] = $true }
|
||||
}
|
||||
|
||||
# DataSets (recursive for unions)
|
||||
$dataSetNodes = $root.SelectNodes("s:dataSet", $ns)
|
||||
$dataSetNames = @{}
|
||||
$allFieldPaths = @{} # Global: dataPath → dataSet name
|
||||
|
||||
function Collect-DataSetFields {
|
||||
param($dsNode, [string]$dsName)
|
||||
|
||||
$fields = $dsNode.SelectNodes("s:field", $ns)
|
||||
$localPaths = @{}
|
||||
foreach ($f in $fields) {
|
||||
$dp = $f.SelectSingleNode("s:dataPath", $ns)
|
||||
if ($dp) {
|
||||
$path = $dp.InnerText
|
||||
$localPaths[$path] = $true
|
||||
$allFieldPaths[$path] = $dsName
|
||||
}
|
||||
}
|
||||
|
||||
# Union items
|
||||
$items = $dsNode.SelectNodes("s:item", $ns)
|
||||
foreach ($item in $items) {
|
||||
$itemName = $item.SelectSingleNode("s:name", $ns)
|
||||
if ($itemName) {
|
||||
Collect-DataSetFields -dsNode $item -dsName $itemName.InnerText
|
||||
}
|
||||
}
|
||||
|
||||
return $localPaths
|
||||
}
|
||||
|
||||
$dataSetFieldMap = @{} # dsName → hashtable of dataPath
|
||||
foreach ($ds in $dataSetNodes) {
|
||||
$nameNode = $ds.SelectSingleNode("s:name", $ns)
|
||||
if ($nameNode) {
|
||||
$dsName = $nameNode.InnerText
|
||||
$dataSetNames[$dsName] = $true
|
||||
$dataSetFieldMap[$dsName] = Collect-DataSetFields -dsNode $ds -dsName $dsName
|
||||
}
|
||||
}
|
||||
|
||||
# CalculatedFields
|
||||
$calcFieldNodes = $root.SelectNodes("s:calculatedField", $ns)
|
||||
$calcFieldPaths = @{}
|
||||
foreach ($cf in $calcFieldNodes) {
|
||||
$dp = $cf.SelectSingleNode("s:dataPath", $ns)
|
||||
if ($dp) { $calcFieldPaths[$dp.InnerText] = $true }
|
||||
}
|
||||
|
||||
# TotalFields
|
||||
$totalFieldNodes = $root.SelectNodes("s:totalField", $ns)
|
||||
|
||||
# Parameters
|
||||
$paramNodes = $root.SelectNodes("s:parameter", $ns)
|
||||
$paramNames = @{}
|
||||
foreach ($p in $paramNodes) {
|
||||
$nameNode = $p.SelectSingleNode("s:name", $ns)
|
||||
if ($nameNode) { $paramNames[$nameNode.InnerText] = $true }
|
||||
}
|
||||
|
||||
# Templates
|
||||
$templateNodes = $root.SelectNodes("s:template", $ns)
|
||||
$templateNames = @{}
|
||||
foreach ($t in $templateNodes) {
|
||||
$nameNode = $t.SelectSingleNode("s:name", $ns)
|
||||
if ($nameNode) { $templateNames[$nameNode.InnerText] = $true }
|
||||
}
|
||||
|
||||
# GroupTemplates
|
||||
$groupTemplateNodes = $root.SelectNodes("s:groupTemplate", $ns)
|
||||
|
||||
# SettingsVariants
|
||||
$variantNodes = $root.SelectNodes("s:settingsVariant", $ns)
|
||||
|
||||
# Known fields = dataset fields + calculated fields
|
||||
$knownFields = @{}
|
||||
foreach ($key in $allFieldPaths.Keys) { $knownFields[$key] = $true }
|
||||
foreach ($key in $calcFieldPaths.Keys) { $knownFields[$key] = $true }
|
||||
|
||||
# --- 5. DataSource checks ---
|
||||
|
||||
if ($dataSourceNodes.Count -eq 0) {
|
||||
Report-Warn "No dataSource elements found (settings-only DCS?)"
|
||||
} else {
|
||||
$dsNamesSeen = @{}
|
||||
$dsOk = $true
|
||||
foreach ($dsn in $dataSourceNodes) {
|
||||
$name = $dsn.SelectSingleNode("s:name", $ns)
|
||||
$type = $dsn.SelectSingleNode("s:dataSourceType", $ns)
|
||||
if (-not $name -or -not $name.InnerText) {
|
||||
Report-Error "DataSource has empty name"
|
||||
$dsOk = $false
|
||||
} elseif ($dsNamesSeen.ContainsKey($name.InnerText)) {
|
||||
Report-Error "Duplicate dataSource name: $($name.InnerText)"
|
||||
$dsOk = $false
|
||||
} else {
|
||||
$dsNamesSeen[$name.InnerText] = $true
|
||||
}
|
||||
if ($type) {
|
||||
$tv = $type.InnerText
|
||||
if ($tv -ne "Local" -and $tv -ne "External") {
|
||||
Report-Warn "DataSource '$($name.InnerText)' has unusual type: $tv"
|
||||
}
|
||||
}
|
||||
}
|
||||
if ($dsOk) {
|
||||
Report-OK "$($dataSourceNodes.Count) dataSource(s) found, names unique"
|
||||
}
|
||||
}
|
||||
|
||||
if ($script:stopped) { & $finalize; exit 1 }
|
||||
|
||||
# --- 6. DataSet checks ---
|
||||
|
||||
$validDsTypes = @("DataSetQuery", "DataSetObject", "DataSetUnion")
|
||||
|
||||
if ($dataSetNodes.Count -eq 0) {
|
||||
Report-Warn "No dataSet elements found (settings-only DCS?)"
|
||||
} else {
|
||||
$dsNamesSeen = @{}
|
||||
$dsOk = $true
|
||||
foreach ($ds in $dataSetNodes) {
|
||||
$xsiType = $ds.GetAttribute("type", "http://www.w3.org/2001/XMLSchema-instance")
|
||||
$nameNode = $ds.SelectSingleNode("s:name", $ns)
|
||||
$dsName = if ($nameNode) { $nameNode.InnerText } else { "(unnamed)" }
|
||||
|
||||
if (-not $nameNode -or -not $nameNode.InnerText) {
|
||||
Report-Error "DataSet has empty name"
|
||||
$dsOk = $false
|
||||
} elseif ($dsNamesSeen.ContainsKey($dsName)) {
|
||||
Report-Error "Duplicate dataSet name: $dsName"
|
||||
$dsOk = $false
|
||||
} else {
|
||||
$dsNamesSeen[$dsName] = $true
|
||||
}
|
||||
|
||||
if (-not $xsiType) {
|
||||
Report-Error "DataSet '$dsName' missing xsi:type"
|
||||
$dsOk = $false
|
||||
} elseif ($validDsTypes -notcontains $xsiType) {
|
||||
Report-Warn "DataSet '$dsName' has unusual xsi:type: $xsiType"
|
||||
}
|
||||
|
||||
# Check dataSource reference
|
||||
if ($xsiType -ne "DataSetUnion") {
|
||||
$srcNode = $ds.SelectSingleNode("s:dataSource", $ns)
|
||||
if ($srcNode -and $srcNode.InnerText) {
|
||||
if (-not $dataSourceNames.ContainsKey($srcNode.InnerText)) {
|
||||
Report-Error "DataSet '$dsName' references unknown dataSource: $($srcNode.InnerText)"
|
||||
$dsOk = $false
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
# Check query not empty for Query type
|
||||
if ($xsiType -eq "DataSetQuery") {
|
||||
$queryNode = $ds.SelectSingleNode("s:query", $ns)
|
||||
if (-not $queryNode -or -not $queryNode.InnerText.Trim()) {
|
||||
Report-Warn "DataSet '$dsName' (Query) has empty query"
|
||||
}
|
||||
}
|
||||
|
||||
# Check objectName for Object type
|
||||
if ($xsiType -eq "DataSetObject") {
|
||||
$objNode = $ds.SelectSingleNode("s:objectName", $ns)
|
||||
if (-not $objNode -or -not $objNode.InnerText.Trim()) {
|
||||
Report-Error "DataSet '$dsName' (Object) has empty objectName"
|
||||
$dsOk = $false
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
if ($dsOk) {
|
||||
Report-OK "$($dataSetNodes.Count) dataSet(s) found, names unique"
|
||||
}
|
||||
}
|
||||
|
||||
if ($script:stopped) { & $finalize; exit 1 }
|
||||
|
||||
# --- 7. Field checks ---
|
||||
|
||||
function Check-DataSetFields {
|
||||
param($dsNode, [string]$dsName)
|
||||
|
||||
$fields = $dsNode.SelectNodes("s:field", $ns)
|
||||
if ($fields.Count -eq 0) { return }
|
||||
|
||||
$pathsSeen = @{}
|
||||
$fieldOk = $true
|
||||
|
||||
foreach ($f in $fields) {
|
||||
$dp = $f.SelectSingleNode("s:dataPath", $ns)
|
||||
$fn = $f.SelectSingleNode("s:field", $ns)
|
||||
|
||||
if (-not $dp -or -not $dp.InnerText) {
|
||||
Report-Error "DataSet '$dsName': field has empty dataPath"
|
||||
$fieldOk = $false
|
||||
continue
|
||||
}
|
||||
|
||||
$path = $dp.InnerText
|
||||
if ($pathsSeen.ContainsKey($path)) {
|
||||
Report-Warn "DataSet '$dsName': duplicate dataPath '$path'"
|
||||
} else {
|
||||
$pathsSeen[$path] = $true
|
||||
}
|
||||
|
||||
if (-not $fn -or -not $fn.InnerText) {
|
||||
Report-Warn "DataSet '$dsName': field '$path' has empty <field> element"
|
||||
}
|
||||
}
|
||||
|
||||
if ($fieldOk) {
|
||||
Report-OK "DataSet `"$dsName`": $($fields.Count) fields, dataPath unique"
|
||||
}
|
||||
|
||||
# Check union items recursively
|
||||
$items = $dsNode.SelectNodes("s:item", $ns)
|
||||
foreach ($item in $items) {
|
||||
$itemName = $item.SelectSingleNode("s:name", $ns)
|
||||
$iName = if ($itemName) { $itemName.InnerText } else { "(unnamed item)" }
|
||||
Check-DataSetFields -dsNode $item -dsName $iName
|
||||
}
|
||||
}
|
||||
|
||||
foreach ($ds in $dataSetNodes) {
|
||||
$nameNode = $ds.SelectSingleNode("s:name", $ns)
|
||||
$dsName = if ($nameNode) { $nameNode.InnerText } else { "(unnamed)" }
|
||||
Check-DataSetFields -dsNode $ds -dsName $dsName
|
||||
}
|
||||
|
||||
if ($script:stopped) { & $finalize; exit 1 }
|
||||
|
||||
# --- 8. DataSetLink checks ---
|
||||
|
||||
$linkNodes = $root.SelectNodes("s:dataSetLink", $ns)
|
||||
if ($linkNodes.Count -gt 0) {
|
||||
$linkOk = $true
|
||||
foreach ($link in $linkNodes) {
|
||||
$src = $link.SelectSingleNode("s:sourceDataSet", $ns)
|
||||
$dst = $link.SelectSingleNode("s:destinationDataSet", $ns)
|
||||
$srcExpr = $link.SelectSingleNode("s:sourceExpression", $ns)
|
||||
$dstExpr = $link.SelectSingleNode("s:destinationExpression", $ns)
|
||||
|
||||
if ($src -and $src.InnerText -and -not $dataSetNames.ContainsKey($src.InnerText)) {
|
||||
Report-Error "DataSetLink: sourceDataSet '$($src.InnerText)' not found"
|
||||
$linkOk = $false
|
||||
}
|
||||
if ($dst -and $dst.InnerText -and -not $dataSetNames.ContainsKey($dst.InnerText)) {
|
||||
Report-Error "DataSetLink: destinationDataSet '$($dst.InnerText)' not found"
|
||||
$linkOk = $false
|
||||
}
|
||||
if (-not $srcExpr -or -not $srcExpr.InnerText.Trim()) {
|
||||
Report-Error "DataSetLink: empty sourceExpression"
|
||||
$linkOk = $false
|
||||
}
|
||||
if (-not $dstExpr -or -not $dstExpr.InnerText.Trim()) {
|
||||
Report-Error "DataSetLink: empty destinationExpression"
|
||||
$linkOk = $false
|
||||
}
|
||||
}
|
||||
if ($linkOk) {
|
||||
Report-OK "$($linkNodes.Count) dataSetLink(s): references valid"
|
||||
}
|
||||
}
|
||||
|
||||
if ($script:stopped) { & $finalize; exit 1 }
|
||||
|
||||
# --- 9. CalculatedField checks ---
|
||||
|
||||
if ($calcFieldNodes.Count -gt 0) {
|
||||
$cfOk = $true
|
||||
$cfSeen = @{}
|
||||
foreach ($cf in $calcFieldNodes) {
|
||||
$dp = $cf.SelectSingleNode("s:dataPath", $ns)
|
||||
$expr = $cf.SelectSingleNode("s:expression", $ns)
|
||||
|
||||
if (-not $dp -or -not $dp.InnerText) {
|
||||
Report-Error "CalculatedField has empty dataPath"
|
||||
$cfOk = $false
|
||||
continue
|
||||
}
|
||||
|
||||
$path = $dp.InnerText
|
||||
if ($cfSeen.ContainsKey($path)) {
|
||||
Report-Error "Duplicate calculatedField dataPath: $path"
|
||||
$cfOk = $false
|
||||
} else {
|
||||
$cfSeen[$path] = $true
|
||||
}
|
||||
|
||||
if (-not $expr -or -not $expr.InnerText.Trim()) {
|
||||
Report-Error "CalculatedField '$path' has empty expression"
|
||||
$cfOk = $false
|
||||
}
|
||||
|
||||
# Warn if collides with a dataset field
|
||||
if ($allFieldPaths.ContainsKey($path)) {
|
||||
Report-Warn "CalculatedField '$path' shadows dataSet field in '$($allFieldPaths[$path])'"
|
||||
}
|
||||
}
|
||||
|
||||
if ($cfOk) {
|
||||
Report-OK "$($calcFieldNodes.Count) calculatedField(s): dataPath and expression valid"
|
||||
}
|
||||
}
|
||||
|
||||
if ($script:stopped) { & $finalize; exit 1 }
|
||||
|
||||
# --- 10. TotalField checks ---
|
||||
|
||||
if ($totalFieldNodes.Count -gt 0) {
|
||||
$tfOk = $true
|
||||
foreach ($tf in $totalFieldNodes) {
|
||||
$dp = $tf.SelectSingleNode("s:dataPath", $ns)
|
||||
$expr = $tf.SelectSingleNode("s:expression", $ns)
|
||||
|
||||
if (-not $dp -or -not $dp.InnerText) {
|
||||
Report-Error "TotalField has empty dataPath"
|
||||
$tfOk = $false
|
||||
continue
|
||||
}
|
||||
|
||||
if (-not $expr -or -not $expr.InnerText.Trim()) {
|
||||
Report-Error "TotalField '$($dp.InnerText)' has empty expression"
|
||||
$tfOk = $false
|
||||
}
|
||||
}
|
||||
|
||||
if ($tfOk) {
|
||||
Report-OK "$($totalFieldNodes.Count) totalField(s): dataPath and expression present"
|
||||
}
|
||||
}
|
||||
|
||||
if ($script:stopped) { & $finalize; exit 1 }
|
||||
|
||||
# --- 11. Parameter checks ---
|
||||
|
||||
if ($paramNodes.Count -gt 0) {
|
||||
$paramOk = $true
|
||||
$paramSeen = @{}
|
||||
foreach ($p in $paramNodes) {
|
||||
$nameNode = $p.SelectSingleNode("s:name", $ns)
|
||||
if (-not $nameNode -or -not $nameNode.InnerText) {
|
||||
Report-Error "Parameter has empty name"
|
||||
$paramOk = $false
|
||||
continue
|
||||
}
|
||||
$pName = $nameNode.InnerText
|
||||
if ($paramSeen.ContainsKey($pName)) {
|
||||
Report-Error "Duplicate parameter name: $pName"
|
||||
$paramOk = $false
|
||||
} else {
|
||||
$paramSeen[$pName] = $true
|
||||
}
|
||||
}
|
||||
if ($paramOk) {
|
||||
Report-OK "$($paramNodes.Count) parameter(s): names unique"
|
||||
}
|
||||
}
|
||||
|
||||
if ($script:stopped) { & $finalize; exit 1 }
|
||||
|
||||
# --- 12. Template checks ---
|
||||
|
||||
if ($templateNodes.Count -gt 0) {
|
||||
$tplOk = $true
|
||||
$tplSeen = @{}
|
||||
foreach ($t in $templateNodes) {
|
||||
$nameNode = $t.SelectSingleNode("s:name", $ns)
|
||||
if (-not $nameNode -or -not $nameNode.InnerText) {
|
||||
Report-Error "Template has empty name"
|
||||
$tplOk = $false
|
||||
continue
|
||||
}
|
||||
$tName = $nameNode.InnerText
|
||||
if ($tplSeen.ContainsKey($tName)) {
|
||||
Report-Error "Duplicate template name: $tName"
|
||||
$tplOk = $false
|
||||
} else {
|
||||
$tplSeen[$tName] = $true
|
||||
}
|
||||
}
|
||||
if ($tplOk) {
|
||||
Report-OK "$($templateNodes.Count) template(s): names unique"
|
||||
}
|
||||
}
|
||||
|
||||
# --- 13. GroupTemplate checks ---
|
||||
|
||||
if ($groupTemplateNodes.Count -gt 0) {
|
||||
$gtOk = $true
|
||||
$validTplTypes = @("Header", "Footer", "Overall", "OverallHeader", "OverallFooter")
|
||||
foreach ($gt in $groupTemplateNodes) {
|
||||
$tplRef = $gt.SelectSingleNode("s:template", $ns)
|
||||
$tplType = $gt.SelectSingleNode("s:templateType", $ns)
|
||||
|
||||
if ($tplRef -and $tplRef.InnerText -and -not $templateNames.ContainsKey($tplRef.InnerText)) {
|
||||
Report-Error "GroupTemplate references unknown template: $($tplRef.InnerText)"
|
||||
$gtOk = $false
|
||||
}
|
||||
if ($tplType -and $validTplTypes -notcontains $tplType.InnerText) {
|
||||
Report-Warn "GroupTemplate has unusual templateType: $($tplType.InnerText)"
|
||||
}
|
||||
}
|
||||
if ($gtOk) {
|
||||
Report-OK "$($groupTemplateNodes.Count) groupTemplate(s): references valid"
|
||||
}
|
||||
}
|
||||
|
||||
if ($script:stopped) { & $finalize; exit 1 }
|
||||
|
||||
# --- 14. Settings helper functions ---
|
||||
|
||||
$validComparisonTypes = @(
|
||||
"Equal","NotEqual","Greater","GreaterOrEqual","Less","LessOrEqual",
|
||||
"InList","NotInList","InHierarchy","InListByHierarchy",
|
||||
"Contains","NotContains","BeginsWith","NotBeginsWith",
|
||||
"Filled","NotFilled"
|
||||
)
|
||||
|
||||
$validStructureTypes = @(
|
||||
"dcsset:StructureItemGroup",
|
||||
"dcsset:StructureItemTable",
|
||||
"dcsset:StructureItemChart",
|
||||
"dcsset:StructureItemNestedObject"
|
||||
)
|
||||
|
||||
function Check-FilterItems {
|
||||
param($parentNode, [string]$variantName)
|
||||
|
||||
$filterItems = $parentNode.SelectNodes("dcsset:filter/dcsset:item", $ns)
|
||||
foreach ($fi in $filterItems) {
|
||||
if ($script:stopped) { return }
|
||||
$xsiType = $fi.GetAttribute("type", "http://www.w3.org/2001/XMLSchema-instance")
|
||||
if ($xsiType -eq "dcsset:FilterItemComparison") {
|
||||
$compType = $fi.SelectSingleNode("dcsset:comparisonType", $ns)
|
||||
if ($compType -and $validComparisonTypes -notcontains $compType.InnerText) {
|
||||
Report-Error "Variant '$variantName' filter: invalid comparisonType '$($compType.InnerText)'"
|
||||
}
|
||||
} elseif ($xsiType -eq "dcsset:FilterItemGroup") {
|
||||
$groupType = $fi.SelectSingleNode("dcsset:groupType", $ns)
|
||||
if ($groupType) {
|
||||
$validGroupTypes = @("AndGroup","OrGroup","NotGroup")
|
||||
if ($validGroupTypes -notcontains $groupType.InnerText) {
|
||||
Report-Warn "Variant '$variantName' filter group: unusual groupType '$($groupType.InnerText)'"
|
||||
}
|
||||
}
|
||||
# Recurse into nested items
|
||||
$nestedItems = $fi.SelectNodes("dcsset:item", $ns)
|
||||
foreach ($ni in $nestedItems) {
|
||||
$niType = $ni.GetAttribute("type", "http://www.w3.org/2001/XMLSchema-instance")
|
||||
if ($niType -eq "dcsset:FilterItemComparison") {
|
||||
$compType = $ni.SelectSingleNode("dcsset:comparisonType", $ns)
|
||||
if ($compType -and $validComparisonTypes -notcontains $compType.InnerText) {
|
||||
Report-Error "Variant '$variantName' filter: invalid comparisonType '$($compType.InnerText)'"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
function Check-StructureItem {
|
||||
param($itemNode, [string]$variantName)
|
||||
|
||||
if ($script:stopped) { return }
|
||||
|
||||
$xsiType = $itemNode.GetAttribute("type", "http://www.w3.org/2001/XMLSchema-instance")
|
||||
if (-not $xsiType) {
|
||||
Report-Error "Variant '$variantName': structure item missing xsi:type"
|
||||
return
|
||||
}
|
||||
if ($validStructureTypes -notcontains $xsiType) {
|
||||
Report-Warn "Variant '$variantName': unusual structure item type '$xsiType'"
|
||||
}
|
||||
|
||||
# Recurse into nested items (groups can contain groups)
|
||||
$nestedItems = $itemNode.SelectNodes("dcsset:item", $ns)
|
||||
foreach ($ni in $nestedItems) {
|
||||
Check-StructureItem -itemNode $ni -variantName $variantName
|
||||
}
|
||||
|
||||
# Check column/row in tables
|
||||
if ($xsiType -eq "dcsset:StructureItemTable") {
|
||||
$columns = $itemNode.SelectNodes("dcsset:column", $ns)
|
||||
$rows = $itemNode.SelectNodes("dcsset:row", $ns)
|
||||
if ($columns.Count -eq 0) {
|
||||
Report-Warn "Variant '$variantName': table has no columns"
|
||||
}
|
||||
if ($rows.Count -eq 0) {
|
||||
Report-Warn "Variant '$variantName': table has no rows"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
function Check-Settings {
|
||||
param($settingsNode, [string]$variantName)
|
||||
|
||||
if ($script:stopped) { return }
|
||||
|
||||
# Selection
|
||||
$selItems = $settingsNode.SelectNodes("dcsset:selection/dcsset:item", $ns)
|
||||
foreach ($si in $selItems) {
|
||||
$xsiType = $si.GetAttribute("type", "http://www.w3.org/2001/XMLSchema-instance")
|
||||
if ($xsiType -eq "dcsset:SelectedItemField") {
|
||||
$field = $si.SelectSingleNode("dcsset:field", $ns)
|
||||
if ($field -and $field.InnerText -and $field.InnerText -ne "SystemFields.Number") {
|
||||
$basePath = ($field.InnerText -split '\.')[0]
|
||||
if (-not $knownFields.ContainsKey($field.InnerText) -and -not $knownFields.ContainsKey($basePath)) {
|
||||
# Soft check — autoFillFields may add fields not listed explicitly
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
# Filter
|
||||
Check-FilterItems -parentNode $settingsNode -variantName $variantName
|
||||
|
||||
# Order
|
||||
$orderItems = $settingsNode.SelectNodes("dcsset:order/dcsset:item", $ns)
|
||||
foreach ($oi in $orderItems) {
|
||||
$xsiType = $oi.GetAttribute("type", "http://www.w3.org/2001/XMLSchema-instance")
|
||||
if ($xsiType -eq "dcsset:OrderItemField") {
|
||||
$orderType = $oi.SelectSingleNode("dcsset:orderType", $ns)
|
||||
if ($orderType -and $orderType.InnerText -ne "Asc" -and $orderType.InnerText -ne "Desc") {
|
||||
Report-Warn "Variant '$variantName' order: invalid orderType '$($orderType.InnerText)'"
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
# Structure items
|
||||
$structItems = $settingsNode.SelectNodes("dcsset:item", $ns)
|
||||
foreach ($si in $structItems) {
|
||||
Check-StructureItem -itemNode $si -variantName $variantName
|
||||
}
|
||||
}
|
||||
|
||||
# --- 15. SettingsVariant checks ---
|
||||
|
||||
if ($variantNodes.Count -eq 0) {
|
||||
Report-Warn "No settingsVariant elements found"
|
||||
} else {
|
||||
$vOk = $true
|
||||
$vIdx = 0
|
||||
foreach ($v in $variantNodes) {
|
||||
$vIdx++
|
||||
$vName = $v.SelectSingleNode("dcsset:name", $ns)
|
||||
if (-not $vName -or -not $vName.InnerText) {
|
||||
Report-Error "SettingsVariant #$vIdx has empty name"
|
||||
$vOk = $false
|
||||
}
|
||||
|
||||
$settings = $v.SelectSingleNode("dcsset:settings", $ns)
|
||||
if (-not $settings) {
|
||||
Report-Error "SettingsVariant '$($vName.InnerText)' has no settings element"
|
||||
$vOk = $false
|
||||
continue
|
||||
}
|
||||
|
||||
# Check settings internals
|
||||
Check-Settings -settingsNode $settings -variantName "$($vName.InnerText)"
|
||||
}
|
||||
|
||||
if ($vOk) {
|
||||
Report-OK "$($variantNodes.Count) settingsVariant(s) found"
|
||||
}
|
||||
}
|
||||
|
||||
# --- Final output ---
|
||||
|
||||
& $finalize
|
||||
|
||||
if ($script:errors -gt 0) {
|
||||
exit 1
|
||||
}
|
||||
exit 0
|
||||
@@ -0,0 +1,21 @@
|
||||
MIT License
|
||||
|
||||
Copyright (c) 2025-2026 Nick Shirokov
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
||||
@@ -1,5 +1,7 @@
|
||||
# 1C Skills for Claude Code
|
||||
|
||||
> **Work in progress** — проект в стадии активной разработки. Набор навыков и операций расширяется.
|
||||
|
||||
Набор [Claude Code Skills](https://docs.anthropic.com/en/docs/claude-code/skills) для работы с артефактами 1С:Предприятия 8.3. Позволяет создавать и модифицировать обработки, макеты печатных форм и другие объекты из XML-исходников, не запоминая детали формата.
|
||||
|
||||
## Быстрый старт
|
||||
@@ -23,6 +25,7 @@
|
||||
| Табличный документ (MXL) | 4 навыка `/mxl-*` | Анализ, создание, компиляция макетов печатных форм | [Подробнее](docs/mxl-guide.md) |
|
||||
| Управляемые формы (Form) | 6 навыков `/form-*` | Создание, анализ, генерация, модификация, валидация управляемых форм | [Подробнее](docs/form-guide.md) |
|
||||
| Роли (Role) | 3 навыка `/role-*` | Анализ прав роли, создание из JSON DSL, валидация | [Подробнее](docs/role-guide.md) |
|
||||
| Схема компоновки (СКД) | 4 навыка `/skd-*` | Анализ, генерация из JSON DSL, точечное редактирование, валидация схем компоновки данных | [Подробнее](docs/skd-guide.md) |
|
||||
| Утилиты | `/img-grid` | Наложение сетки на изображение для определения пропорций колонок | — |
|
||||
|
||||
## Требования
|
||||
@@ -41,6 +44,8 @@
|
||||
- [Form DSL](docs/form-dsl-spec.md) — JSON-формат описания формы для `/form-compile`
|
||||
- [Роли (Rights.xml)](docs/1c-role-spec.md) — XML-формат прав роли, типы объектов, RLS
|
||||
- [Role DSL](docs/role-dsl-spec.md) — JSON-формат описания ролей для `/role-compile`
|
||||
- [Схема компоновки данных (DCS)](docs/1c-dcs-spec.md) — XML-формат DataCompositionSchema, 930 схем проанализировано
|
||||
- [SKD DSL](docs/skd-dsl-spec.md) — JSON-формат описания СКД для `/skd-compile`
|
||||
|
||||
## Структура репозитория
|
||||
|
||||
@@ -69,12 +74,17 @@
|
||||
├── role-info/ # Анализ прав роли
|
||||
├── role-compile/ # Создание роли из JSON DSL
|
||||
├── role-validate/ # Валидация роли
|
||||
├── skd-info/ # Анализ схемы компоновки данных
|
||||
├── skd-compile/ # Компиляция СКД из JSON DSL
|
||||
├── skd-edit/ # Точечное редактирование СКД (25 операций)
|
||||
├── skd-validate/ # Валидация СКД
|
||||
└── img-grid/ # Сетка для анализа изображений
|
||||
docs/
|
||||
├── epf-guide.md # Гайд: внешние обработки
|
||||
├── mxl-guide.md # Гайд: табличный документ
|
||||
├── form-guide.md # Гайд: управляемые формы
|
||||
├── role-guide.md # Гайд: роли
|
||||
├── skd-guide.md # Гайд: схема компоновки данных
|
||||
├── 1c-xml-format-spec.md # Спецификация XML-формата
|
||||
├── 1c-form-spec.md # Спецификация управляемых форм
|
||||
├── 1c-help-spec.md # Спецификация встроенной справки
|
||||
@@ -82,5 +92,8 @@ docs/
|
||||
├── 1c-spreadsheet-spec.md # Спецификация табличного документа
|
||||
├── mxl-dsl-spec.md # Спецификация MXL DSL
|
||||
├── form-dsl-spec.md # Спецификация Form DSL
|
||||
└── 1c-role-spec.md # Спецификация ролей (Rights.xml)
|
||||
├── 1c-role-spec.md # Спецификация ролей (Rights.xml)
|
||||
├── 1c-dcs-spec.md # Спецификация СКД (DataCompositionSchema)
|
||||
├── skd-dsl-spec.md # Спецификация SKD DSL
|
||||
└── role-dsl-spec.md # Спецификация Role DSL
|
||||
```
|
||||
|
||||
+34
-4
@@ -299,7 +299,8 @@ DataCompositionSchema
|
||||
| `dcscom:accountTypeExpression` | Выражение для определения типа счёта |
|
||||
| `dcscom:balance` | Поле является остатком |
|
||||
| `dcscom:balanceGroup` | Группа остатка |
|
||||
| `dcscom:period` | Поле — период |
|
||||
| `dcscom:periodNumber` | Номер периода (обычно `1`) |
|
||||
| `dcscom:periodType` | Тип периода (`Main`, `Additional`) |
|
||||
|
||||
### 4.7. Тип значения (valueType)
|
||||
|
||||
@@ -313,7 +314,15 @@ DataCompositionSchema
|
||||
</valueType>
|
||||
```
|
||||
|
||||
Типы: `xs:string`, `xs:dateTime`, `xs:decimal`, `xs:boolean`, ссылочные (`d4p1:CatalogRef.Номенклатура`).
|
||||
Типы: `xs:string`, `xs:dateTime`, `xs:decimal`, `xs:boolean`, ссылочные типы конфигурации.
|
||||
|
||||
Ссылочные типы объявляются с inline namespace на элементе `<v8:Type>`:
|
||||
|
||||
```xml
|
||||
<v8:Type xmlns:d5p1="http://v8.1c.ru/8.1/data/enterprise/current-config">d5p1:CatalogRef.Номенклатура</v8:Type>
|
||||
```
|
||||
|
||||
Префикс (`d5p1`, `d4p1` и т.д.) — автогенерируемый, суть в URI `http://v8.1c.ru/8.1/data/enterprise/current-config`. Поддерживаются: `CatalogRef`, `DocumentRef`, `EnumRef`, `ChartOfAccountsRef`, `ChartOfCharacteristicTypesRef` и др.
|
||||
|
||||
Квалификаторы:
|
||||
- `v8:StringQualifiers` → `v8:Length`, `v8:AllowedLength` (Fixed/Variable)
|
||||
@@ -446,7 +455,28 @@ DataCompositionSchema
|
||||
|---|---|---|
|
||||
| `dataPath` | да | Путь к полю |
|
||||
| `expression` | да | Агрегатная функция: `Сумма(...)`, `Количество(...)`, `Максимум(...)`, `Минимум(...)`, `Среднее(...)` |
|
||||
| `group` | нет | Для какой группировки считать итоги |
|
||||
| `group` | нет | Имя группировки, для которой считать итоги. Без `group` — для всех группировок |
|
||||
|
||||
### Разные формулы для разных группировок
|
||||
|
||||
Одно поле может иметь несколько записей `totalField` с разными формулами для разных группировок:
|
||||
|
||||
```xml
|
||||
<!-- Для группировки "ОбъектМетаданных" — агрегация самого поля -->
|
||||
<totalField>
|
||||
<dataPath>ПравоИнтерактивное</dataPath>
|
||||
<expression>Максимум(ПравоИнтерактивное)</expression>
|
||||
<group>ОбъектМетаданных</group>
|
||||
</totalField>
|
||||
<!-- Для группировки "Отчет" — агрегация другого поля -->
|
||||
<totalField>
|
||||
<dataPath>ПравоИнтерактивное</dataPath>
|
||||
<expression>Максимум(ПравоОтчета)</expression>
|
||||
<group>Отчет</group>
|
||||
</totalField>
|
||||
```
|
||||
|
||||
Это позволяет вычислять ресурс по-разному в зависимости от контекста группировки.
|
||||
|
||||
---
|
||||
|
||||
@@ -494,7 +524,7 @@ DataCompositionSchema
|
||||
| Дата | `xs:dateTime` | `0001-01-01T00:00:00` |
|
||||
| Строка | `xs:string` | `Т13` |
|
||||
| Стандартный период | `v8:StandardPeriod` | `<v8:variant>LastMonth</v8:variant>` |
|
||||
| Ссылка | `d4p1:CatalogRef.ИмяСправочника` | `xsi:nil="true"` |
|
||||
| Ссылка | `d5p1:CatalogRef.ИмяСправочника` (с `xmlns:d5p1="http://v8.1c.ru/8.1/data/enterprise/current-config"`) | `xsi:nil="true"` |
|
||||
| null | — | `xsi:nil="true"` |
|
||||
|
||||
Стандартные варианты периодов (`v8:StandardPeriodVariant`): `Custom`, `Today`, `ThisWeek`, `ThisMonth`, `ThisQuarter`, `ThisYear`, `LastMonth`, `LastQuarter`, `LastYear` и др.
|
||||
|
||||
@@ -0,0 +1,790 @@
|
||||
# JSON DSL для схемы компоновки данных (СКД)
|
||||
|
||||
Компактный JSON-формат для описания `DataCompositionSchema` (Template.xml).
|
||||
Компилируется навыком `/skd-compile` в XML, валидируется `/skd-validate`.
|
||||
|
||||
---
|
||||
|
||||
## 1. Корневая структура
|
||||
|
||||
```json
|
||||
{
|
||||
"dataSources": [...],
|
||||
"dataSets": [...],
|
||||
"dataSetLinks": [...],
|
||||
"calculatedFields": [...],
|
||||
"totalFields": [...],
|
||||
"parameters": [...],
|
||||
"templates": [...],
|
||||
"groupTemplates": [...],
|
||||
"settingsVariants": [...]
|
||||
}
|
||||
```
|
||||
|
||||
**Умолчания:**
|
||||
- `dataSources` опущен → авто-создаётся `{ "name": "ИсточникДанных1", "type": "Local" }`
|
||||
- `source` в наборе опущен → первый dataSource
|
||||
- `name` набора опущен → "НаборДанных1", "НаборДанных2"...
|
||||
- `settingsVariants` опущен → один вариант "Основной" с детальной группировкой и `selection: ["Auto"]`
|
||||
|
||||
---
|
||||
|
||||
## 2. Источники данных (dataSources)
|
||||
|
||||
```json
|
||||
"dataSources": [
|
||||
{ "name": "ИсточникДанных1", "type": "Local" }
|
||||
]
|
||||
```
|
||||
|
||||
| Поле | Обязат. | Умолчание | XML-маппинг |
|
||||
|------|---------|-----------|-------------|
|
||||
| `name` | да | — | `<name>` |
|
||||
| `type` | нет | `"Local"` | `<dataSourceType>` |
|
||||
|
||||
Значения `type`: `"Local"`, `"External"`.
|
||||
|
||||
---
|
||||
|
||||
## 3. Наборы данных (dataSets)
|
||||
|
||||
Тип определяется по ключу-дискриминатору:
|
||||
|
||||
| Ключ | Тип | xsi:type |
|
||||
|------|-----|----------|
|
||||
| `query` | Запрос | `DataSetQuery` |
|
||||
| `objectName` | Объект | `DataSetObject` |
|
||||
| `items` | Объединение | `DataSetUnion` |
|
||||
|
||||
### DataSetQuery (самый частый)
|
||||
|
||||
```json
|
||||
{ "name": "Продажи", "query": "ВЫБРАТЬ ...", "fields": [...], "autoFillFields": false }
|
||||
```
|
||||
|
||||
### DataSetObject
|
||||
|
||||
```json
|
||||
{ "name": "ТаблицаПроверки", "objectName": "ТаблицаПроверки", "fields": [...] }
|
||||
```
|
||||
|
||||
### DataSetUnion
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "Объединение",
|
||||
"items": [
|
||||
{ "name": "Набор1", "query": "...", "fields": [...] },
|
||||
{ "name": "Набор2", "query": "...", "fields": [...] }
|
||||
],
|
||||
"fields": [...]
|
||||
}
|
||||
```
|
||||
|
||||
| Поле | Обязат. | Описание |
|
||||
|------|---------|----------|
|
||||
| `name` | нет | Авто: "НаборДанных1"... |
|
||||
| `source` | нет | Имя dataSource (авто: первый) |
|
||||
| `query` | да* | Текст запроса (DataSetQuery) |
|
||||
| `objectName` | да* | Имя объекта (DataSetObject) |
|
||||
| `items` | да* | Вложенные наборы (DataSetUnion) |
|
||||
| `fields` | нет | Массив полей |
|
||||
| `autoFillFields` | нет | `false` — отключить автозаполнение (по умолчанию не выводится = true) |
|
||||
|
||||
---
|
||||
|
||||
## 4. Поля — shorthand и объектная форма
|
||||
|
||||
### Shorthand-строка
|
||||
|
||||
```
|
||||
"<dataPath>[: <type>] [@role...] [#restrict...]"
|
||||
```
|
||||
|
||||
Примеры:
|
||||
|
||||
```json
|
||||
"fields": [
|
||||
"Наименование",
|
||||
"Количество: decimal(15,2)",
|
||||
"Организация: CatalogRef.Организации @dimension",
|
||||
"Служебное: string #noFilter #noOrder",
|
||||
"Счёт: CatalogRef.Хозрасчетный @account",
|
||||
"Сумма: decimal(15,2) @balance"
|
||||
]
|
||||
```
|
||||
|
||||
### Объектная форма
|
||||
|
||||
```json
|
||||
{
|
||||
"dataPath": "Сумма",
|
||||
"field": "Сумма",
|
||||
"title": "Сумма продаж",
|
||||
"type": "decimal(15,2)",
|
||||
"role": { "dimension": true },
|
||||
"restrict": ["noFilter", "noGroup"],
|
||||
"attrRestrict": ["noFilter"],
|
||||
"appearance": { "Формат": "ЧДЦ=2" },
|
||||
"presentationExpression": "Формат(Сумма, \"ЧДЦ=2\")"
|
||||
}
|
||||
```
|
||||
|
||||
### Парсинг shorthand
|
||||
|
||||
1. Разделить по пробелам; найти `@`-роли и `#`-ограничения
|
||||
2. Остаток до первого `:` — `dataPath` (и `field` по умолчанию)
|
||||
3. После `:` до `@`/`#` — тип
|
||||
|
||||
### Типы
|
||||
|
||||
| DSL | XML v8:Type | Квалификатор |
|
||||
|-----|-------------|--------------|
|
||||
| `string` | `xs:string` | Length=0, AllowedLength=Variable |
|
||||
| `string(N)` | `xs:string` | Length=N, AllowedLength=Variable |
|
||||
| `decimal(D,F)` | `xs:decimal` | Digits=D, FractionDigits=F, AllowedSign=Any |
|
||||
| `decimal(D,F,nonneg)` | `xs:decimal` | Digits=D, FractionDigits=F, AllowedSign=Nonnegative |
|
||||
| `boolean` | `xs:boolean` | — |
|
||||
| `date` | `xs:dateTime` | DateFractions=Date |
|
||||
| `dateTime` | `xs:dateTime` | DateFractions=DateTime |
|
||||
| `CatalogRef.XXX` | `d5p1:CatalogRef.XXX` | inline xmlns:d5p1 |
|
||||
| `DocumentRef.XXX` | `d5p1:DocumentRef.XXX` | inline xmlns:d5p1 |
|
||||
| `EnumRef.XXX` | `d5p1:EnumRef.XXX` | inline xmlns:d5p1 |
|
||||
| `ChartOfAccountsRef.XXX` | `d5p1:ChartOfAccountsRef.XXX` | inline xmlns:d5p1 |
|
||||
| `StandardPeriod` | `v8:StandardPeriod` | — |
|
||||
|
||||
> **Ссылочные типы** (`CatalogRef.XXX`, `DocumentRef.XXX` и др.) эмитируются с inline namespace declaration: `<v8:Type xmlns:d5p1="http://v8.1c.ru/8.1/data/enterprise/current-config">d5p1:CatalogRef.XXX</v8:Type>`. Использование префикса `cfg:` вместо `d5p1:` с объявлением namespace приводит к ошибке XDTO. Сборка EPF со ссылочными типами требует базу с соответствующей конфигурацией (не пустую).
|
||||
|
||||
### Синонимы типов
|
||||
|
||||
Все имена типов регистронезависимые. Поддерживаются русские и альтернативные имена:
|
||||
|
||||
| Синоним | Канонический тип |
|
||||
|---------|-----------------|
|
||||
| `число`, `Число` | `decimal` |
|
||||
| `строка`, `Строка` | `string` |
|
||||
| `булево`, `Булево`, `bool` | `boolean` |
|
||||
| `дата`, `Дата` | `date` |
|
||||
| `датаВремя`, `ДатаВремя` | `dateTime` |
|
||||
| `СтандартныйПериод` | `StandardPeriod` |
|
||||
| `int`, `integer`, `number`, `num` | `decimal` |
|
||||
| `СправочникСсылка.XXX` | `CatalogRef.XXX` |
|
||||
| `ДокументСсылка.XXX` | `DocumentRef.XXX` |
|
||||
| `ПеречислениеСсылка.XXX` | `EnumRef.XXX` |
|
||||
| `ПланСчетовСсылка.XXX` | `ChartOfAccountsRef.XXX` |
|
||||
| `ПланВидовХарактеристикСсылка.XXX` | `ChartOfCharacteristicTypesRef.XXX` |
|
||||
|
||||
Параметризованные: `число(15,2)` → `decimal(15,2)`, `строка(100)` → `string(100)`.
|
||||
|
||||
### Роли
|
||||
|
||||
| DSL shorthand | Объектная форма | XML |
|
||||
|---------------|----------------|-----|
|
||||
| `@dimension` | `"role": "dimension"` или `{"dimension": true}` | `<dcscom:dimension>true</dcscom:dimension>` |
|
||||
| `@account` | `"role": "account"` или `{"account": true}` | `<dcscom:account>true</dcscom:account>` |
|
||||
| `@balance` | `"role": "balance"` или `{"balance": true}` | `<dcscom:balance>true</dcscom:balance>` |
|
||||
| `@period` | `"role": "period"` или `{"period": true}` | `<dcscom:periodNumber>1</dcscom:periodNumber>` + `<dcscom:periodType>Main</dcscom:periodType>` |
|
||||
|
||||
Объектная форма с доп. полями:
|
||||
```json
|
||||
"role": {
|
||||
"account": true,
|
||||
"accountTypeExpression": "Счёт.ВидСчёта",
|
||||
"balanceGroup": "/Остатки"
|
||||
}
|
||||
```
|
||||
|
||||
### Ограничения
|
||||
|
||||
| DSL shorthand | Объектная форма | XML useRestriction |
|
||||
|---------------|----------------|-----|
|
||||
| `#noField` | `"noField"` | `<field>true</field>` |
|
||||
| `#noFilter` / `#noCondition` | `"noFilter"` | `<condition>true</condition>` |
|
||||
| `#noGroup` | `"noGroup"` | `<group>true</group>` |
|
||||
| `#noOrder` | `"noOrder"` | `<order>true</order>` |
|
||||
|
||||
### Оформление (appearance)
|
||||
|
||||
```json
|
||||
"appearance": {
|
||||
"Формат": "ЧДЦ=2",
|
||||
"ГоризонтальноеПоложение": "Center"
|
||||
}
|
||||
```
|
||||
|
||||
Маппинг на XML:
|
||||
```xml
|
||||
<appearance>
|
||||
<dcscor:item xsi:type="dcsset:SettingsParameterValue">
|
||||
<dcscor:parameter>Формат</dcscor:parameter>
|
||||
<dcscor:value xsi:type="xs:string">ЧДЦ=2</dcscor:value>
|
||||
</dcscor:item>
|
||||
</appearance>
|
||||
```
|
||||
|
||||
Значения `ГоризонтальноеПоложение` → `xsi:type="v8ui:HorizontalAlign"`.
|
||||
|
||||
---
|
||||
|
||||
## 5. Итоговые поля (totalFields)
|
||||
|
||||
### Shorthand
|
||||
|
||||
```
|
||||
"<dataPath>: <Функция>"
|
||||
"<dataPath>: <Функция>(<выражение>)"
|
||||
```
|
||||
|
||||
Примеры:
|
||||
|
||||
```json
|
||||
"totalFields": [
|
||||
"Количество: Сумма",
|
||||
"Цена: Максимум",
|
||||
"Стоимость: Сумма(Кол * Цена)"
|
||||
]
|
||||
```
|
||||
|
||||
**Парсинг:** `"A: Func"` → `dataPath=A`, `expression=Func(A)`. `"A: Func(expr)"` → `dataPath=A`, `expression=Func(expr)`.
|
||||
|
||||
Функции (русские): `Сумма`, `Количество`, `Максимум`, `Минимум`, `Среднее`.
|
||||
|
||||
### Объектная форма
|
||||
|
||||
```json
|
||||
{ "dataPath": "X", "expression": "Максимум(X)", "group": "Группа1" }
|
||||
```
|
||||
|
||||
### Привязка к группировкам (group)
|
||||
|
||||
В объектной форме поле `group` может быть строкой или массивом строк. Каждая строка задаёт имя группировки, для которой вычисляется итог:
|
||||
|
||||
```json
|
||||
"totalFields": [
|
||||
{ "dataPath": "Кол", "expression": "Сумма(Кол)", "group": ["ГруппаПользователей", "ГруппаПользователей Иерархия", "ОбщийИтог"] }
|
||||
]
|
||||
```
|
||||
|
||||
XML-маппинг — по `<group>` на каждый элемент:
|
||||
```xml
|
||||
<totalField>
|
||||
<dataPath>Кол</dataPath>
|
||||
<expression>Сумма(Кол)</expression>
|
||||
<group>ГруппаПользователей</group>
|
||||
<group>ГруппаПользователей Иерархия</group>
|
||||
<group>ОбщийИтог</group>
|
||||
</totalField>
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 6. Параметры (parameters)
|
||||
|
||||
### Shorthand
|
||||
|
||||
```
|
||||
"<name>: <type> [= <default>] [@autoDates]"
|
||||
```
|
||||
|
||||
Примеры:
|
||||
|
||||
```json
|
||||
"parameters": [
|
||||
"Период: StandardPeriod = LastMonth @autoDates",
|
||||
"Организация: CatalogRef.Организации",
|
||||
"ДатаОтчета: date"
|
||||
]
|
||||
```
|
||||
|
||||
**Парсинг:** `"A: T = V"` → `name=A`, `type=T`, `value=V`. Значение `LastMonth` и другие варианты периодов → `v8:StandardPeriod` с `v8:variant`.
|
||||
|
||||
### @autoDates
|
||||
|
||||
Флаг `@autoDates` в shorthand параметра автоматически генерирует два дополнительных параметра:
|
||||
- `ДатаНачала` (date, expression=`&<Имя>.ДатаНачала`, availableAsField=false)
|
||||
- `ДатаОкончания` (date, expression=`&<Имя>.ДатаОкончания`, availableAsField=false)
|
||||
|
||||
Заменяет типовой бойлерплейт из 5 строк на 1:
|
||||
|
||||
```json
|
||||
// Было:
|
||||
"parameters": [
|
||||
"Период: StandardPeriod = LastMonth",
|
||||
{ "name": "ДатаНачала", "type": "date", "expression": "&Период.ДатаНачала", "availableAsField": false },
|
||||
{ "name": "ДатаОкончания", "type": "date", "expression": "&Период.ДатаОкончания", "availableAsField": false }
|
||||
]
|
||||
|
||||
// Стало:
|
||||
"parameters": ["Период: StandardPeriod = LastMonth @autoDates"]
|
||||
```
|
||||
|
||||
### Объектная форма
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "ДатаНач",
|
||||
"title": "Дата начала",
|
||||
"type": "date",
|
||||
"value": "0001-01-01T00:00:00",
|
||||
"expression": "&Период.ДатаНачала",
|
||||
"availableAsField": false,
|
||||
"useRestriction": true,
|
||||
"use": "Always"
|
||||
}
|
||||
```
|
||||
|
||||
| Поле | Описание |
|
||||
|------|----------|
|
||||
| `name` | Имя параметра |
|
||||
| `title` | Заголовок (умолч. = name) |
|
||||
| `type` | Тип (см. таблицу типов) |
|
||||
| `value` | Значение по умолчанию |
|
||||
| `expression` | Выражение для вычисления |
|
||||
| `availableAsField` | `false` — скрыть из полей |
|
||||
| `useRestriction` | `true` — скрыть от пользователя |
|
||||
| `use` | `"Always"`, `"Auto"` |
|
||||
|
||||
### Значения параметров по типу
|
||||
|
||||
| Тип | value | XML |
|
||||
|-----|-------|-----|
|
||||
| `StandardPeriod` | `"LastMonth"`, `"ThisYear"` и др. | `<v8:variant xsi:type="v8:StandardPeriodVariant">LastMonth</v8:variant>` |
|
||||
| `date` | `"0001-01-01T00:00:00"` | `xsi:type="xs:dateTime"` |
|
||||
| `string` | `"текст"` | `xsi:type="xs:string"` |
|
||||
| `boolean` | `true`/`false` | `xsi:type="xs:boolean"` |
|
||||
|
||||
Стандартные варианты периодов: `Custom`, `Today`, `ThisWeek`, `ThisMonth`, `ThisQuarter`, `ThisYear`, `LastMonth`, `LastQuarter`, `LastYear`.
|
||||
|
||||
---
|
||||
|
||||
## 7. Вычисляемые поля (calculatedFields)
|
||||
|
||||
### Shorthand
|
||||
|
||||
```
|
||||
"<dataPath> = <expression>"
|
||||
```
|
||||
|
||||
```json
|
||||
"calculatedFields": [
|
||||
"УИД = Строка(Ссылка.УникальныйИдентификатор())",
|
||||
"Итого = Количество * Цена"
|
||||
]
|
||||
```
|
||||
|
||||
### Объектная форма
|
||||
|
||||
```json
|
||||
{
|
||||
"dataPath": "Итого",
|
||||
"expression": "Количество * Цена",
|
||||
"title": "Итого",
|
||||
"type": "decimal(15,2)",
|
||||
"restrict": ["noGroup"],
|
||||
"appearance": { "Формат": "ЧДЦ=2" }
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 8. Связи наборов (dataSetLinks)
|
||||
|
||||
Только объектная форма:
|
||||
|
||||
```json
|
||||
"dataSetLinks": [
|
||||
{
|
||||
"source": "Периоды",
|
||||
"dest": "Данные",
|
||||
"sourceExpr": "Месяц",
|
||||
"destExpr": "Месяц",
|
||||
"parameter": "НачалоМесяца"
|
||||
}
|
||||
]
|
||||
```
|
||||
|
||||
| Поле | XML |
|
||||
|------|-----|
|
||||
| `source` | `<sourceDataSet>` |
|
||||
| `dest` | `<destinationDataSet>` |
|
||||
| `sourceExpr` | `<sourceExpression>` |
|
||||
| `destExpr` | `<destinationExpression>` |
|
||||
| `parameter` | `<parameter>` (опц.) |
|
||||
|
||||
---
|
||||
|
||||
## 9. Варианты настроек (settingsVariants)
|
||||
|
||||
```json
|
||||
"settingsVariants": [{
|
||||
"name": "Основной",
|
||||
"presentation": "Основной вариант",
|
||||
"settings": {
|
||||
"selection": [...],
|
||||
"filter": [...],
|
||||
"order": [...],
|
||||
"conditionalAppearance": [...],
|
||||
"outputParameters": {...},
|
||||
"dataParameters": [...],
|
||||
"structure": [...]
|
||||
}
|
||||
}]
|
||||
```
|
||||
|
||||
### selection
|
||||
|
||||
```json
|
||||
"selection": [
|
||||
"Наименование",
|
||||
{ "field": "Количество", "title": "Кол-во" },
|
||||
"Auto"
|
||||
]
|
||||
```
|
||||
|
||||
- Строка → `SelectedItemField`
|
||||
- `"Auto"` → `SelectedItemAuto` (только на уровне группировок; на верхнем уровне settings игнорируется)
|
||||
- Объект с `field`/`title` → `SelectedItemField` с `lwsTitle`
|
||||
|
||||
### filter
|
||||
|
||||
#### Shorthand-строка
|
||||
|
||||
```json
|
||||
"filter": [
|
||||
"Организация = _ @off @user",
|
||||
"Дата >= 2024-01-01T00:00:00",
|
||||
"Статус filled",
|
||||
"Количество > 0"
|
||||
]
|
||||
```
|
||||
|
||||
Формат: `"<Поле> <оператор> [<значение>] [@off] [@user] [@quickAccess] [@normal] [@inaccessible]"`.
|
||||
|
||||
- Значение `_` — пустое (placeholder, не выводится в XML)
|
||||
- `@off` → `use=false`
|
||||
- `@user` → `userSettingID=auto` (генерировать GUID)
|
||||
- `@quickAccess` → `viewMode=QuickAccess`
|
||||
- `@normal` → `viewMode=Normal`
|
||||
- `@inaccessible` → `viewMode=Inaccessible`
|
||||
- Типы значений автоопределяются: `true`/`false` → boolean, `2024-01-01T00:00:00` → dateTime, числа → decimal, прочее → string
|
||||
|
||||
#### Объектная форма
|
||||
|
||||
```json
|
||||
"filter": [
|
||||
{ "field": "Организация", "op": "=", "use": false, "userSettingID": "auto" },
|
||||
{ "field": "Дата", "op": ">=", "value": "0001-01-01T00:00:00", "valueType": "xs:dateTime" },
|
||||
{ "group": "Or", "items": [
|
||||
{ "field": "Статус", "op": "=", "value": true, "valueType": "xs:boolean" },
|
||||
{ "field": "Пометка", "op": "filled" }
|
||||
]}
|
||||
]
|
||||
```
|
||||
|
||||
| Поле | Описание |
|
||||
|------|----------|
|
||||
| `field` | Имя поля |
|
||||
| `op` | Оператор (см. таблицу) |
|
||||
| `value` | Правая часть (опц.) |
|
||||
| `valueType` | xsi:type для значения (опц.) |
|
||||
| `use` | Включён (`true` по умолчанию) |
|
||||
| `presentation` | Текст подсказки |
|
||||
| `viewMode` | `"Normal"`, `"QuickAccess"`, `"Inaccessible"` |
|
||||
| `userSettingID` | `"auto"` → генерировать GUID |
|
||||
| `userSettingPresentation` | Отображаемое имя настройки (LocalStringType) |
|
||||
|
||||
Операторы:
|
||||
|
||||
| DSL | XML comparisonType |
|
||||
|-----|--------------------|
|
||||
| `=` | `Equal` |
|
||||
| `<>` | `NotEqual` |
|
||||
| `>` | `Greater` |
|
||||
| `>=` | `GreaterOrEqual` |
|
||||
| `<` | `Less` |
|
||||
| `<=` | `LessOrEqual` |
|
||||
| `in` | `InList` |
|
||||
| `notIn` | `NotInList` |
|
||||
| `inHierarchy` | `InHierarchy` |
|
||||
| `contains` | `Contains` |
|
||||
| `notContains` | `NotContains` |
|
||||
| `beginsWith` | `BeginsWith` |
|
||||
| `filled` | `Filled` |
|
||||
| `notFilled` | `NotFilled` |
|
||||
|
||||
Группа условий: `{ "group": "And"|"Or"|"Not", "items": [...] }` → `FilterItemGroup` с `groupType`.
|
||||
|
||||
### order
|
||||
|
||||
```json
|
||||
"order": ["Количество desc", "Наименование", "Auto"]
|
||||
```
|
||||
|
||||
- `"Field"` → `OrderItemField`, `orderType=Asc`
|
||||
- `"Field desc"` → `OrderItemField`, `orderType=Desc`
|
||||
- `"Field asc"` → `OrderItemField`, `orderType=Asc`
|
||||
- `"Auto"` → `OrderItemAuto` (только на уровне группировок; на верхнем уровне settings игнорируется)
|
||||
|
||||
### conditionalAppearance
|
||||
|
||||
Условное оформление — массив правил, каждое задаёт набор полей (selection), условия (filter), параметры оформления (appearance) и мета-атрибуты.
|
||||
|
||||
```json
|
||||
"conditionalAppearance": [
|
||||
{
|
||||
"selection": ["Сумма"],
|
||||
"filter": ["Сумма > 1000"],
|
||||
"appearance": { "ЦветТекста": "style:ПросроченныеДанныеЦвет" },
|
||||
"presentation": "Выделять крупные суммы",
|
||||
"viewMode": "Normal",
|
||||
"userSettingID": "auto"
|
||||
},
|
||||
{
|
||||
"filter": ["Статус notFilled"],
|
||||
"appearance": { "Текст": "Не указано", "ЦветТекста": "web:Gray" },
|
||||
"presentation": "Скрывать пустые статусы"
|
||||
}
|
||||
]
|
||||
```
|
||||
|
||||
| Поле | Описание |
|
||||
|------|----------|
|
||||
| `selection` | Массив полей, к которым применяется. Пусто/опущено = все поля |
|
||||
| `filter` | Условия (shorthand-строки или объекты, как в settings filter) |
|
||||
| `appearance` | Объект `{ "Параметр": "Значение" }` |
|
||||
| `presentation` | Описание правила |
|
||||
| `use` | Включено (`true` по умолчанию) |
|
||||
| `viewMode` | `"Normal"`, `"QuickAccess"`, `"Inaccessible"` |
|
||||
| `userSettingID` | `"auto"` → генерировать GUID |
|
||||
|
||||
**Типы значений appearance** определяются автоматически:
|
||||
- `style:XXX`, `web:XXX`, `win:XXX` → `v8ui:Color`
|
||||
- `true`/`false` → `xs:boolean`
|
||||
- Параметр `Текст` или `Заголовок` → `v8:LocalStringType`
|
||||
- Прочее → `xs:string`
|
||||
|
||||
Поддержка `use=false` на уровне параметра:
|
||||
```json
|
||||
"appearance": {
|
||||
"ЦветФона": { "value": "web:LightGray", "use": false }
|
||||
}
|
||||
```
|
||||
|
||||
### outputParameters
|
||||
|
||||
```json
|
||||
"outputParameters": {
|
||||
"Заголовок": "Мой отчёт",
|
||||
"ВыводитьЗаголовок": "Output",
|
||||
"МакетОформления": "ОформлениеОтчетовЧерноБелый"
|
||||
}
|
||||
```
|
||||
|
||||
Ключ → `dcscor:parameter`, значение → `dcscor:value`.
|
||||
|
||||
Типы значений определяются автоматически:
|
||||
- `"Заголовок"` → `v8:LocalStringType`
|
||||
- `"ВыводитьЗаголовок"`, `"ВыводитьПараметрыДанных"`, `"ВыводитьОтбор"` → `dcsset:DataCompositionTextOutputType`
|
||||
- `"РасположениеПолейГруппировки"` → `dcsset:DataCompositionGroupFieldsPlacement`
|
||||
- `"РасположениеРеквизитов"` → `dcsset:DataCompositionAttributesPlacement`
|
||||
- `"ГоризонтальноеРасположениеОбщихИтогов"`, `"ВертикальноеРасположениеОбщихИтогов"` → `dcscor:DataCompositionTotalPlacement`
|
||||
- Прочие → `xs:string`
|
||||
|
||||
### dataParameters
|
||||
|
||||
#### Shorthand-строка
|
||||
|
||||
```json
|
||||
"dataParameters": [
|
||||
"Период = LastMonth @user",
|
||||
"Организация @off @user"
|
||||
]
|
||||
```
|
||||
|
||||
Формат: `"<Имя> [= <значение>] [@off] [@user] [@quickAccess] [@normal] [@inaccessible]"`.
|
||||
|
||||
- Значения-варианты периодов (`LastMonth`, `ThisYear` и др.) автоматически оборачиваются в `v8:StandardPeriod`
|
||||
- `@off` → `use=false`, `@user` → `userSettingID=auto`
|
||||
|
||||
#### Объектная форма
|
||||
|
||||
```json
|
||||
"dataParameters": [
|
||||
{ "parameter": "Период", "value": { "variant": "LastMonth" }, "userSettingID": "auto" },
|
||||
{ "parameter": "Организация", "use": false, "viewMode": "Normal", "userSettingID": "auto", "userSettingPresentation": "Организация отчёта" }
|
||||
]
|
||||
```
|
||||
|
||||
| Поле | Описание |
|
||||
|------|----------|
|
||||
| `parameter` | Имя параметра |
|
||||
| `value` | Значение (объект `{ "variant": "LastMonth" }` для StandardPeriod, или скаляр) |
|
||||
| `use` | Включён (`true` по умолчанию) |
|
||||
| `viewMode` | `"Normal"`, `"QuickAccess"`, `"Inaccessible"` |
|
||||
| `userSettingID` | `"auto"` → генерировать GUID |
|
||||
| `userSettingPresentation` | Отображаемое имя настройки (LocalStringType) |
|
||||
|
||||
### structure
|
||||
|
||||
#### String shorthand (рекомендуется для типичных случаев)
|
||||
|
||||
```json
|
||||
"structure": "Организация > details"
|
||||
"structure": "Организация > Номенклатура > details"
|
||||
"structure": "Период > Организация > Номенклатура > details"
|
||||
```
|
||||
|
||||
`>` разделяет уровни вложенности. Каждый сегмент — группировка по указанному полю. `details` (или `детали`) — детальные записи (пустой `groupBy`). Для каждого уровня `selection` и `order` автоматически `["Auto"]`.
|
||||
|
||||
#### Массив объектов
|
||||
|
||||
```json
|
||||
"structure": [
|
||||
{
|
||||
"type": "group",
|
||||
"groupBy": ["Организация"],
|
||||
"children": [
|
||||
{ "type": "group" }
|
||||
]
|
||||
}
|
||||
]
|
||||
```
|
||||
|
||||
**Умолчания:** `selection` и `order` по умолчанию `["Auto"]` на каждом уровне (в группировках, строках/колонках таблиц, точках/сериях диаграмм). Указывать явно нужно только если требуется другой набор полей.
|
||||
|
||||
#### Группировка (group)
|
||||
|
||||
| Поле | Описание |
|
||||
|------|----------|
|
||||
| `type` | `"group"` |
|
||||
| `name` | Имя группировки (опц.) |
|
||||
| `groupBy` | Массив полей. Пусто/опущено = детальные записи |
|
||||
| `groupType` | `"Items"` (умолч.), `"Hierarchy"`, `"HierarchyOnly"` |
|
||||
| `selection` | Выборка (умолч. `["Auto"]`) |
|
||||
| `filter` | Отборы (как в settings) |
|
||||
| `order` | Сортировка (умолч. `["Auto"]`) |
|
||||
| `outputParameters` | Параметры вывода (как в settings) |
|
||||
| `children` | Вложенные элементы структуры |
|
||||
|
||||
Пустой `groupBy` (или `[]`) = детальные записи (без `groupItems` в XML).
|
||||
|
||||
#### Таблица (table)
|
||||
|
||||
```json
|
||||
{
|
||||
"type": "table",
|
||||
"name": "Таблица",
|
||||
"rows": [
|
||||
{ "groupBy": ["Номенклатура"], "selection": ["Auto"], "order": ["Auto"] }
|
||||
],
|
||||
"columns": [
|
||||
{ "groupBy": ["Период"], "selection": ["Auto"], "order": ["Auto"] }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
#### Диаграмма (chart)
|
||||
|
||||
```json
|
||||
{
|
||||
"type": "chart",
|
||||
"points": { "groupBy": ["Организация"], "order": ["Auto"] },
|
||||
"series": { "groupBy": ["Месяц"], "order": ["Auto"] },
|
||||
"selection": ["Сумма"]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 10. Макеты и привязки (templates, groupTemplates)
|
||||
|
||||
Редко используются. Поддерживаются в объектной форме, близкой к XML.
|
||||
|
||||
### templates
|
||||
|
||||
```json
|
||||
"templates": [
|
||||
{
|
||||
"name": "Макет1",
|
||||
"template": "<raw XML dcsat:AreaTemplate>",
|
||||
"parameters": [
|
||||
{ "name": "ТипЦены", "expression": "Представление(ТипЦен)" }
|
||||
]
|
||||
}
|
||||
]
|
||||
```
|
||||
|
||||
### groupTemplates
|
||||
|
||||
```json
|
||||
"groupTemplates": [
|
||||
{ "groupField": "ТипЦен", "templateType": "Header", "template": "Макет1" }
|
||||
]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 11. Полный пример — минимальный
|
||||
|
||||
```json
|
||||
{
|
||||
"dataSets": [
|
||||
{
|
||||
"name": "НаборДанных1",
|
||||
"query": "ВЫБРАТЬ\n\tНоменклатура.Наименование КАК Наименование,\n\tКОЛИЧЕСТВО(1) КАК Количество\nИЗ\n\tСправочник.Номенклатура КАК Номенклатура\nСГРУППИРОВАТЬ ПО\n\tНоменклатура.Наименование",
|
||||
"fields": [
|
||||
{ "dataPath": "Наименование", "title": "Наименование" },
|
||||
"Количество"
|
||||
]
|
||||
}
|
||||
],
|
||||
"totalFields": ["Количество: Сумма"],
|
||||
"settingsVariants": [{
|
||||
"name": "Основной",
|
||||
"settings": {
|
||||
"selection": ["Наименование", "Количество"],
|
||||
"structure": [{ "type": "group" }]
|
||||
}
|
||||
}]
|
||||
}
|
||||
```
|
||||
|
||||
## 12. Полный пример — средний (с shorthand v2)
|
||||
|
||||
```json
|
||||
{
|
||||
"dataSets": [
|
||||
{
|
||||
"name": "Продажи",
|
||||
"query": "ВЫБРАТЬ\n\tПродажи.Организация,\n\tПродажи.Номенклатура,\n\tПродажи.Количество,\n\tПродажи.Сумма\nИЗ\n\tРегистрНакопления.Продажи КАК Продажи\n{ГДЕ\n\tПродажи.Период >= &ДатаНачала\n\tИ Продажи.Период < &ДатаОкончания}",
|
||||
"fields": [
|
||||
"Организация: СправочникСсылка.Организации @dimension",
|
||||
"Номенклатура: СправочникСсылка.Номенклатура @dimension",
|
||||
"Количество: число(15,3)",
|
||||
"Сумма: число(15,2)"
|
||||
]
|
||||
}
|
||||
],
|
||||
"totalFields": ["Количество: Сумма", "Сумма: Сумма"],
|
||||
"parameters": [
|
||||
"Период: СтандартныйПериод = LastMonth @autoDates"
|
||||
],
|
||||
"settingsVariants": [{
|
||||
"name": "Основной",
|
||||
"presentation": "Продажи по организациям",
|
||||
"settings": {
|
||||
"selection": ["Номенклатура", "Количество", "Сумма", "Auto"],
|
||||
"filter": ["Организация = _ @off @user"],
|
||||
"order": ["Сумма desc", "Auto"],
|
||||
"outputParameters": {
|
||||
"Заголовок": "Анализ продаж",
|
||||
"ВыводитьЗаголовок": "Output"
|
||||
},
|
||||
"dataParameters": ["Период = LastMonth @user"],
|
||||
"structure": "Организация > details"
|
||||
}
|
||||
}]
|
||||
}
|
||||
```
|
||||
|
||||
**Сравнение с v1:** средний пример сократился с 58 до 33 строк (−43%). Основная экономия: `@autoDates` (−4 строки), structure shorthand (−9 строк), filter/dataParam shorthand (−4 строки).
|
||||
@@ -0,0 +1,177 @@
|
||||
# Схема компоновки данных (СКД)
|
||||
|
||||
Навыки группы `/skd-*` позволяют анализировать, создавать, редактировать и проверять схемы компоновки данных 1С — XML-файлы DataCompositionSchema (Template.xml).
|
||||
|
||||
## Навыки
|
||||
|
||||
| Навык | Параметры | Описание |
|
||||
|-------|-----------|----------|
|
||||
| `/skd-info` | `<TemplatePath> [-Mode] [-Name]` | Анализ структуры СКД: наборы, поля, параметры, ресурсы, варианты (10 режимов) |
|
||||
| `/skd-compile` | `<JsonPath> <OutputPath>` | Генерация Template.xml из JSON DSL: наборы, поля, итоги, параметры, варианты |
|
||||
| `/skd-edit` | `<TemplatePath> -Operation <op> -Value "<value>"` | Точечное редактирование: 25 атомарных операций (add/set/modify/clear/remove) |
|
||||
| `/skd-validate` | `<TemplatePath> [-MaxErrors 20]` | Валидация структурной корректности: ~30 проверок |
|
||||
|
||||
## Рабочий цикл
|
||||
|
||||
```
|
||||
Описание отчёта (текст) → JSON DSL → /skd-compile → Template.xml → /skd-validate
|
||||
↕ /skd-edit → /skd-info
|
||||
```
|
||||
|
||||
1. Claude формирует JSON-определение СКД (shorthand-поля, параметры, итоги, варианты)
|
||||
2. `/skd-compile` генерирует Template.xml с корректными namespace, типами, группировками
|
||||
3. `/skd-edit` вносит точечные изменения: добавление полей, фильтров, наборов данных, вариантов, условного оформления и т.д.
|
||||
4. `/skd-validate` проверяет корректность XML
|
||||
5. `/skd-info` выводит компактную сводку для визуальной проверки
|
||||
|
||||
## JSON DSL — компактный формат
|
||||
|
||||
СКД описываются в JSON с двумя уровнями детализации для каждой секции:
|
||||
|
||||
### Минимальный пример
|
||||
|
||||
```json
|
||||
{
|
||||
"dataSets": [{
|
||||
"query": "ВЫБРАТЬ Номенклатура.Наименование ИЗ Справочник.Номенклатура КАК Номенклатура",
|
||||
"fields": ["Наименование"]
|
||||
}]
|
||||
}
|
||||
```
|
||||
|
||||
Умолчания: dataSource создаётся автоматически (`ИсточникДанных1/Local`), набор получает имя `НаборДанных1`, вариант настроек "Основной" с деталями.
|
||||
|
||||
### Поля — shorthand
|
||||
|
||||
```json
|
||||
"fields": [
|
||||
"Наименование",
|
||||
"Количество: decimal(15,2)",
|
||||
"Организация: CatalogRef.Организации @dimension",
|
||||
"Служебное: string #noFilter #noOrder"
|
||||
]
|
||||
```
|
||||
|
||||
Формат: `Имя[: Тип] [@роль...] [#ограничение...]`. Роли: `@dimension`, `@account`, `@balance`, `@period`. Ограничения: `#noField`, `#noFilter`, `#noGroup`, `#noOrder`.
|
||||
|
||||
### Итоги — shorthand
|
||||
|
||||
```json
|
||||
"totalFields": ["Количество: Сумма", "Стоимость: Сумма(Кол * Цена)"]
|
||||
```
|
||||
|
||||
Формат: `Поле: Функция` или `Поле: Функция(выражение)`. Объектная форма поддерживает привязку к группировкам: `{ "dataPath": "X", "expression": "Сумма(X)", "group": ["Группа1", "ОбщийИтог"] }`.
|
||||
|
||||
### Параметры — shorthand + @autoDates
|
||||
|
||||
```json
|
||||
"parameters": [
|
||||
"Период: StandardPeriod = LastMonth @autoDates",
|
||||
"Организация: CatalogRef.Организации"
|
||||
]
|
||||
```
|
||||
|
||||
`@autoDates` автоматически генерирует параметры `ДатаНачала`/`ДатаОкончания` (заменяет 5 строк на 1).
|
||||
|
||||
### Вычисляемые поля — shorthand
|
||||
|
||||
```json
|
||||
"calculatedFields": ["Итого = Количество * Цена"]
|
||||
```
|
||||
|
||||
### Варианты настроек — shorthand
|
||||
|
||||
```json
|
||||
"settingsVariants": [{
|
||||
"name": "Основной",
|
||||
"settings": {
|
||||
"selection": ["Номенклатура", "Количество", "Сумма"],
|
||||
"filter": ["Организация = _ @off @user"],
|
||||
"order": ["Сумма desc"],
|
||||
"dataParameters": ["Период = LastMonth @user"],
|
||||
"outputParameters": { "Заголовок": "Мой отчёт" },
|
||||
"structure": "Организация > details"
|
||||
}
|
||||
}]
|
||||
```
|
||||
|
||||
- **filter shorthand**: `"Поле оператор значение @флаги"` — флаги `@off`, `@user`, `@quickAccess`, `@normal`, `@inaccessible`
|
||||
- **dataParameters shorthand**: `"Имя = значение @флаги"`
|
||||
- **structure shorthand**: `"Поле1 > Поле2 > details"` — `>` разделяет уровни группировки
|
||||
- **conditionalAppearance**: условное оформление с автоопределением типов значений (Color, Boolean, LocalStringType)
|
||||
|
||||
### Объектная форма
|
||||
|
||||
Все секции поддерживают полную объектную форму для сложных случаев (title, appearance, role с выражениями, userSettingID, userSettingPresentation, conditionalAppearance, группы фильтров And/Or/Not и т.д.). Подробности — в [спецификации SKD DSL](skd-dsl-spec.md).
|
||||
|
||||
## Сценарии использования
|
||||
|
||||
### Анализ существующей СКД
|
||||
|
||||
```
|
||||
> Проанализируй схему компоновки отчёта Reports/АнализНДФЛ/Templates/ОсновнаяСхемаКомпоновкиДанных
|
||||
```
|
||||
|
||||
Claude вызовет `/skd-info` (overview → trace → query → variant) и опишет:
|
||||
- наборы данных и их поля
|
||||
- параметры и значения по умолчанию
|
||||
- ресурсы и формулы агрегации
|
||||
- структуру группировок в вариантах настроек
|
||||
|
||||
### Создание СКД по описанию
|
||||
|
||||
```
|
||||
> Создай СКД для отчёта по продажам: группировка по организациям,
|
||||
> поля Номенклатура, Количество, Сумма. Период — параметр.
|
||||
```
|
||||
|
||||
Claude сформирует JSON:
|
||||
```json
|
||||
{
|
||||
"dataSets": [{
|
||||
"name": "Продажи",
|
||||
"query": "ВЫБРАТЬ ...",
|
||||
"fields": [
|
||||
"Организация: CatalogRef.Организации @dimension",
|
||||
"Номенклатура: CatalogRef.Номенклатура @dimension",
|
||||
"Количество: decimal(15,3)",
|
||||
"Сумма: decimal(15,2)"
|
||||
]
|
||||
}],
|
||||
"totalFields": ["Количество: Сумма", "Сумма: Сумма"],
|
||||
"parameters": ["Период: StandardPeriod = LastMonth @autoDates"],
|
||||
"settingsVariants": [{
|
||||
"name": "Основной",
|
||||
"settings": {
|
||||
"selection": ["Номенклатура", "Количество", "Сумма"],
|
||||
"dataParameters": ["Период = LastMonth @user"],
|
||||
"structure": "Организация > details"
|
||||
}
|
||||
}]
|
||||
}
|
||||
```
|
||||
|
||||
И вызовет `/skd-compile` → `/skd-validate` → `/skd-info`.
|
||||
|
||||
### Проверка существующей СКД
|
||||
|
||||
```
|
||||
> Проверь корректность СКД Reports/МойОтчёт/Templates/ОсновнаяСхемаКомпоновкиДанных/Ext/Template.xml
|
||||
```
|
||||
|
||||
Claude вызовет `/skd-validate` и покажет результат: ошибки (битые ссылки, дубликаты, невалидные типы) и предупреждения.
|
||||
|
||||
## Структура файлов СКД
|
||||
|
||||
```
|
||||
<Объект>/Templates/
|
||||
├── ИмяМакета.xml # Метаданные (UUID, TemplateType=DataCompositionSchema)
|
||||
└── ИмяМакета/
|
||||
└── Ext/
|
||||
└── Template.xml # Тело схемы (DataCompositionSchema)
|
||||
```
|
||||
|
||||
## Спецификации
|
||||
|
||||
- [1c-dcs-spec.md](1c-dcs-spec.md) — XML-формат DataCompositionSchema, namespace, элементы, типы
|
||||
- [skd-dsl-spec.md](skd-dsl-spec.md) — JSON DSL для описания СКД (формат входных данных `/skd-compile`)
|
||||
Reference in New Issue
Block a user