1c-skd-edit · git:20260828.2b87e3e · 2026-08-28 · sha256 7e3baabcabf0904b
1c-skd-edit git:20260828.2b87e3eA
Immutable. This exact content is served forever at /api/v1/blob/7e3baabcabf0904b.
--- name: 1c-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 skills/1c-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: `"Имя [Заголовок]: тип = Выражение #noFilter #noOrder #noGroup"`. ``` "Маржа = Продажа - Закупка" "Наценка [Наценка, %]: decimal(10,2) = Маржа / Закупка * 100" "Служебное: string = \"\" #noFilter #noOrder #noGroup" ``` `#noFilter`, `#noOrder`, `#noGroup`, `#noField` → `<useRestriction>` (аналогично add-field). Также добавляется в selection варианта. ### add-parameter - добавить параметр ``` "Период [Отчетный период]: StandardPeriod = LastMonth @autoDates" "Организация: CatalogRef.Организации" ``` Shorthand: `"Имя [Заголовок]: тип = значение @флаги"`. `[Заголовок]` опциональный - добавляет `<title>`. `@autoDates` генерирует пару скрытых параметров `ДатаНачала`/`ДатаОкончания` для StandardPeriod-параметра - для БСП-отчетов, чтобы получить пару полей "Начало/Конец" в панели быстрых настроек. ### modify-parameter - изменить существующий параметр Находит параметр по имени, добавляет/обновляет свойства. ``` "ПорядокОкругления use=Always" "ПорядокОкругления [Округление сумм] denyIncompleteValues=true" "ПериодОтчета [Отчетный период]" # только title "ПорядокОкругления availableValue=Перечисление.Округления.Окр1 presentation=руб." ``` `[Заголовок]` опциональный - устанавливает или заменяет `<title>`. Можно вызывать без других kv-пар, чтобы только обновить title. `availableValue=` добавляет один элемент списка допустимых значений (можно несколько через `;;`). Тип значения определяется автоматически (DesignTimeValue для ссылок). ### rename-parameter - переименовать параметр Shorthand: `"OldName => NewName"`. Атомарно обновляет имя параметра, ссылки `&Имя` в выражениях других параметров (только полные совпадения, `&ПериодX` не задевается), и записи в `dataParameters` всех вариантов. Текст запроса не трогает - переименование строго в области параметров. ``` "Период => ПериодОтчета" ``` ### reorder-parameters - переставить параметры в указанном порядке Shorthand: `"Имя1, Имя2, Имя3"`. Частичный список - указанные параметры идут первыми в заданном порядке, остальные сохраняют исходный порядок и идут в конце. Параметры из списка, которых нет в схеме - warning, пропуск. ``` "ПериодОтчета, НачалоПериода, КонецПериода" ``` ### add-filter - добавить фильтр в вариант Shorthand: `"Поле оператор значение @флаги"`. Флаги: `@off` (use=false), `@user` (userSettingID=auto), `@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" "Folder(Поступление: ПолеА, ПолеБ, ПолеВ)" ``` `Folder(Название: поле1, поле2)` - группа полей (SelectedItemFolder) с заголовком и `placement=Auto`. `@group=ИмяГруппировки` - добавить в selection именованной группировки (вместо уровня варианта): ``` "Folder(Поступление: ПолеА, ПолеБ) @group=ДанныеОтчета" ``` ### add-dataSetLink - добавить связь наборов данных Shorthand: `"Источник > Приемник on ВырИсточника = ВырПриемника [param Имя]"`. ``` "Набор1 > Набор2 on Поле1 = Поле2" "Набор1 > Набор2 on Поле1 = Поле2 [param Связь]" ``` ### add-dataSet - добавить набор данных Shorthand: `"Имя: ТЕКСТ_ЗАПРОСА"` или `"ТЕКСТ_ЗАПРОСА"` (авто-имя `НаборДанныхN`). ``` "Доп: ВЫБРАТЬ 1 КАК Тест" "ВЫБРАТЬ Ссылка ИЗ Справочник.Номенклатура" "Продажи: @queries/sales.sql" ``` `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 Цена, Сумма" ``` Типы значений appearance (автодетект): `web:*`/`style:*`/`win:*` → Color, `true`/`false` → Boolean, параметр `Формат`/`Текст`/`Заголовок` → LocalStringType, иначе String. Типы значений фильтра (автодетект): `Перечисление.*`/`Справочник.*`/`ПланСчетов.*`/`Документ.*` → DesignTimeValue, `true`/`false` → Boolean, дата → DateTime, числа → Decimal, иначе String. OrGroup: несколько условий через ` or ` в `when` объединяются в FilterItemGroup/OrGroup: ``` "Формат = ЧЦ=15; ЧДЦ=0 when ПараметрыДанных.Округление = Перечисление.Округления.Окр1 or ПараметрыДанных.Округление = Перечисление.Округления.Окр1000" ``` **Важно**: для параметров данных используйте префикс `ПараметрыДанных.` в поле фильтра. ### add-drilldown - подключить расшифровку к ресурсам в шаблонах Value - имена ресурсов (как в полях/вычисляемых полях СКД) через запятую. ``` "ПоступлениеИзПроизводства, ВыбытиеПрочее" "Сумма_Дт83, Сумма_Дт99, Сумма_68, Сумма_84" ``` Подключает DrillDown по `ИмяРесурса` ко всем шаблонам, содержащим указанные ресурсы. Идемпотентно. ### set-query - заменить текст запроса Не поддерживает пакетный режим. Value - полный текст запроса или `@path/to/file.sql` (ссылка на внешний файл). Путь разрешается относительно Template.xml, затем CWD. ### patch-query - точечная замена в тексте запроса Shorthand: `"старое => новое"`. Заменяет все вхождения подстроки. Поддерживает пакетный режим и `-DataSet`. ``` "СубконтоДт1) В => СубконтоКт1) В" "ЛЕВОЕ СОЕДИНЕНИЕ => ВНУТРЕННЕЕ СОЕДИНЕНИЕ" ``` ### set-outputParameter - установить параметр вывода ``` "Заголовок = Мой отчет" "ВыводитьЗаголовок = true" ``` Если параметр уже существует - заменяет значение. ### set-structure - установить структуру варианта Shorthand: `"Поле1 > Поле2 > details"`. `details`/`детали` - детальные записи. Заменяет всю структуру. Не поддерживает пакетный режим. ``` "Организация > Номенклатура > details" "details" "СчетМеждународногоУчета @name=ДанныеОтчета" ``` `@name=Имя` - присваивает имя группировке (`<dcsset:name>`). Используется для привязки шаблонов через `groupName`. ### modify-field - изменить существующее поле Тот же shorthand что и `add-field`. Находит по dataPath, объединяет свойства (непустые переопределяют), сохраняет позицию. ``` "Цена [Цена USD]: decimal(10,4) @dimension" ``` ### modify-filter - изменить существующий фильтр Тот же shorthand что и `add-filter`. Находит по полю, обновляет оператор/значение/флаги. См. правило для `<use>` ниже. ### modify-dataParameter - изменить параметр данных Тот же shorthand что и `add-dataParameter`. Находит по имени, обновляет значение/флаги. См. правило для `<use>` ниже. #### Правило `<use>` для modify-filter / modify-dataParameter В отличие от `add-*`, в `modify-*` поле `<use>` обновляется **только если флаг задан явно**: - `@off` - установить `<use>false</use>` - `@on` - убрать существующий `<use>false</use>` (включить параметр) - ни `@off`, ни `@on` не задано - `<use>` не трогается, существующее значение сохраняется (важно: это значит, что отключенный параметр останется отключенным после модификации других свойств) ### 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> - визуальная сводка ```