/form-compile — Генерация Form.xml из JSON DSL

Принимает компактное JSON-определение формы (20–50 строк) и генерирует полный корректный Form.xml (100–500+ строк) с namespace-декларациями, автогенерированными companion-элементами, последовательными ID.

При проектировании формы с нуля (5+ элементов или нечёткие требования) — вызовите /form-patterns для загрузки справочника: архетипы, конвенции именования, продвинутые паттерны. Для простых форм (1–3 поля, пользователь описал что нужно) — не нужно.

Использование

/form-compile <JsonPath> <OutputPath>

Параметры

Параметр Обязательный Описание

JsonPath да Путь к JSON-определению формы

OutputPath да Путь к выходному файлу Form.xml

Команда

powershell.exe -NoProfile -File .claude/skills/form-compile/scripts/form-compile.ps1 -JsonPath "<json>" -OutputPath "<xml>"

JSON DSL — справка

Структура верхнего уровня

{ "title": "Заголовок формы", "properties": { "autoTitle": false, ... }, "events": { "OnCreateAtServer": "ПриСозданииНаСервере" }, "excludedCommands": ["Reread"], "elements": [ ... ], "attributes": [ ... ], "commands": [ ... ], "parameters": [ ... ] }

• title — заголовок формы (multilingual). Можно указать и в properties , но лучше на верхнем уровне

• properties — свойства формы: autoTitle , windowOpeningMode , commandBarLocation , saveDataInSettings , width , height и др.

• events — обработчики событий формы (ключ: имя события 1С, значение: имя процедуры)

• excludedCommands — исключённые стандартные команды

Элементы (ключ определяет тип)

DSL ключ XML элемент Значение ключа

"group"

UsualGroup "horizontal" / "vertical" / "alwaysHorizontal" / "alwaysVertical" / "collapsible"

"input"

InputField имя элемента

"check"

CheckBoxField имя

"label"

LabelDecoration имя (текст задаётся через title )

"labelField"

LabelField имя

"table"

Table имя

"pages"

Pages имя

"page"

Page имя

"button"

Button имя

"picture"

PictureDecoration имя

"picField"

PictureField имя

"calendar"

CalendarField имя

"cmdBar"

CommandBar имя

"popup"

Popup имя

Общие свойства (все типы элементов)

Ключ Описание

name

Переопределить имя (по умолчанию = значение ключа типа)

title

Заголовок элемента

visible: false

Скрыть (синоним: hidden: true )

enabled: false

Сделать недоступным (синоним: disabled: true )

readOnly: true

Только чтение

on: [...]

События с автоименованием обработчиков

handlers: {...}

Явное задание имён обработчиков: {"OnChange": "МоёИмя"}

Допустимые имена событий (on )

Компилятор предупреждает о неизвестных событиях. Имена регистрозависимы — используйте точно как указано.

Форма (events ): OnCreateAtServer , OnOpen , BeforeClose , OnClose , NotificationProcessing , ChoiceProcessing , OnReadAtServer , BeforeWriteAtServer , OnWriteAtServer , AfterWriteAtServer , BeforeWrite , AfterWrite , FillCheckProcessingAtServer , BeforeLoadDataFromSettingsAtServer , OnLoadDataFromSettingsAtServer , ExternalEvent , Opening

input / picField: OnChange , StartChoice , ChoiceProcessing , AutoComplete , TextEditEnd , Clearing , Creating , EditTextChange

check: OnChange

table: OnStartEdit , OnEditEnd , OnChange , Selection , ValueChoice , BeforeAddRow , BeforeDeleteRow , AfterDeleteRow , BeforeRowChange , BeforeEditEnd , OnActivateRow , OnActivateCell , Drag , DragStart , DragCheck , DragEnd

label / picture: Click , URLProcessing

labelField: OnChange , StartChoice , ChoiceProcessing , Click , URLProcessing , Clearing

button: Click

pages: OnCurrentPageChange

Поле ввода (input)

Ключ Описание Пример

path

DataPath — привязка к данным "Объект.Организация"

titleLocation

Размещение заголовка "none" , "left" , "top"

multiLine: true

Многострочное поле текстовое поле, комментарий

passwordMode: true

Режим пароля (звёздочки) поле ввода пароля

choiceButton: true

Кнопка выбора ("...") ссылочное поле

clearButton: true

Кнопка очистки ("X")

spinButton: true

Кнопка прокрутки числовые поля

dropListButton: true

Кнопка выпадающего списка

markIncomplete: true

Пометка незаполненного обязательные поля

skipOnInput: true

Пропускать при обходе Tab

inputHint

Подсказка в пустом поле "Введите наименование..."

width / height

Размер числа

autoMaxWidth: false

Отключить авто-ширину для фиксированных полей

horizontalStretch: true

Растягивать по ширине

Чекбокс (check)

Ключ Описание

path

DataPath

titleLocation

Размещение заголовка

Надпись-декорация (label)

Ключ Описание

title

Текст надписи (обязательно)

hyperlink: true

Сделать ссылкой

width / height

Размер

Группа (group)

Значение ключа задаёт ориентацию: "horizontal" , "vertical" , "alwaysHorizontal" , "alwaysVertical" , "collapsible" .

Ключ Описание

showTitle: true

Показывать заголовок группы

united: false

Не объединять рамку

representation

"none" , "normal" , "weak" , "strong"

children: [...]

Вложенные элементы

Таблица (table)

Важно: таблица требует связанный реквизит формы типа ValueTable с колонками (см. раздел "Связки").

Ключ Описание

path

DataPath (привязка к реквизиту-таблице)

columns: [...]

Колонки — массив элементов (обычно input )

changeRowSet: true

Разрешить добавление/удаление строк

changeRowOrder: true

Разрешить перемещение строк

height

Высота в строках таблицы

header: false

Скрыть шапку

footer: true

Показать подвал

commandBarLocation

"None" , "Top" , "Auto"

searchStringLocation

"None" , "Top" , "Auto"

Страницы (pages + page)

Ключ (pages) Описание

pagesRepresentation

"None" , "TabsOnTop" , "TabsOnBottom" и др.

children: [...]

Массив page

Ключ (page) Описание

title

Заголовок вкладки

group

Ориентация внутри страницы

children: [...]

Содержимое страницы

Кнопка (button)

Ключ Описание

command

Имя команды формы → Form.Command.Имя

stdCommand

Стандартная команда: "Close" → Form.StandardCommand.Close ; с точкой: "Товары.Add" → Form.Item.Товары.StandardCommand.Add

defaultButton: true

Кнопка по умолчанию

type

"usual" , "hyperlink" , "commandBar"

picture

Картинка кнопки

representation

"Auto" , "Text" , "Picture" , "PictureAndText"

locationInCommandBar

"Auto" , "InCommandBar" , "InAdditionalSubmenu"

Командная панель (cmdBar)

Ключ Описание

autofill: true

Автозаполнение стандартными командами

children: [...]

Кнопки панели

Выпадающее меню (popup)

Ключ Описание

title

Заголовок подменю

children: [...]

Кнопки подменю

Используется внутри cmdBar для группировки кнопок в подменю:

{ "cmdBar": "Панель", "children": [ { "popup": "Добавить", "title": "Добавить", "children": [ { "button": "ДобавитьСтроку", "stdCommand": "Товары.Add" }, { "button": "ДобавитьИзДокумента", "command": "ДобавитьИзДокумента", "title": "Из документа" } ]} ]}

Реквизиты (attributes)

{ "name": "Объект", "type": "DataProcessorObject.Загрузка", "main": true } { "name": "Итого", "type": "decimal(15,2)" } { "name": "Таблица", "type": "ValueTable", "columns": [ { "name": "Номенклатура", "type": "CatalogRef.Номенклатура" }, { "name": "Количество", "type": "decimal(10,3)" } ]}

• savedData: true — сохраняемые данные

Команды (commands)

{ "name": "Загрузить", "action": "ЗагрузитьОбработка", "shortcut": "Ctrl+Enter" }

• title — заголовок (если отличается от name)

• picture — картинка команды

Система типов

DSL XML

"string" / "string(100)"

xs:string

• StringQualifiers

"decimal(15,2)"

xs:decimal

• NumberQualifiers

"decimal(10,0,nonneg)"

с AllowedSign=Nonnegative

"boolean"

xs:boolean

"date" / "dateTime" / "time"

xs:dateTime

• DateFractions

"CatalogRef.XXX"

cfg:CatalogRef.XXX

"DocumentRef.XXX"

cfg:DocumentRef.XXX

"ValueTable"

v8:ValueTable

"ValueList"

v8:ValueListType

"Type1 | Type2"

составной тип

Связки: элемент + реквизит

Таблица и некоторые поля требуют связанный реквизит. Элемент ссылается на реквизит через path .

Таблица — элемент table

• реквизит ValueTable :

{ "elements": [ { "table": "Товары", "path": "Объект.Товары", "columns": [ { "input": "Номенклатура", "path": "Объект.Товары.Номенклатура" } ]} ], "attributes": [ { "name": "Объект", "type": "DataProcessorObject.Загрузка", "main": true, "columns": [ { "name": "Товары", "type": "ValueTable", "columns": [ { "name": "Номенклатура", "type": "CatalogRef.Номенклатура" } ]} ] } ] }

Или, если таблица привязана к реквизиту формы (не к Объект):

{ "elements": [ { "table": "ТаблицаДанных", "path": "ТаблицаДанных", "columns": [ { "input": "Наименование", "path": "ТаблицаДанных.Наименование" } ]} ], "attributes": [ { "name": "ТаблицаДанных", "type": "ValueTable", "columns": [ { "name": "Наименование", "type": "string(150)" } ]} ] }

Паттерны

Диалог загрузки файла

{ "title": "Загрузка из файла", "properties": { "autoTitle": false }, "events": { "OnCreateAtServer": "ПриСозданииНаСервере" }, "elements": [ { "group": "horizontal", "name": "ГруппаФайл", "children": [ { "input": "ИмяФайла", "path": "ИмяФайла", "title": "Файл", "inputHint": "Выберите файл...", "choiceButton": true, "on": ["StartChoice"] }, { "check": "ПерваяСтрокаЗаголовок", "path": "ПерваяСтрокаЗаголовок" } ]}, { "input": "Результат", "path": "Результат", "multiLine": true, "height": 8, "readOnly": true, "title": "Лог" }, { "group": "horizontal", "name": "ГруппаКнопок", "children": [ { "button": "Загрузить", "command": "Загрузить", "defaultButton": true }, { "button": "Закрыть", "stdCommand": "Close" } ]} ], "attributes": [ { "name": "Объект", "type": "ExternalDataProcessorObject.ЗагрузкаИзФайла", "main": true }, { "name": "ИмяФайла", "type": "string" }, { "name": "ПерваяСтрокаЗаголовок", "type": "boolean" }, { "name": "Результат", "type": "string" } ], "commands": [ { "name": "Загрузить", "action": "ЗагрузитьОбработка", "shortcut": "Ctrl+Enter" } ] }

Мастер (wizard) с шагами

{ "title": "Мастер настройки", "properties": { "autoTitle": false }, "elements": [ { "pages": "СтраницыМастера", "pagesRepresentation": "None", "children": [ { "page": "Шаг1", "title": "Параметры", "children": [ { "input": "Параметр1", "path": "Параметр1" } ]}, { "page": "Шаг2", "title": "Результат", "children": [ { "input": "Итог", "path": "Итог", "readOnly": true } ]} ]}, { "group": "horizontal", "name": "Навигация", "children": [ { "button": "Назад", "command": "Назад", "title": "< Назад" }, { "button": "Далее", "command": "Далее", "title": "Далее >" } ]} ], "attributes": [ { "name": "Объект", "type": "ExternalDataProcessorObject.Мастер", "main": true }, { "name": "Параметр1", "type": "string" }, { "name": "Итог", "type": "string" } ], "commands": [ { "name": "Назад", "action": "НазадОбработка" }, { "name": "Далее", "action": "ДалееОбработка" } ] }

Список с фильтром и таблицей

{ "title": "Просмотр данных", "elements": [ { "group": "horizontal", "name": "Фильтр", "children": [ { "input": "Период", "path": "Период", "on": ["OnChange"] }, { "input": "Организация", "path": "Организация", "on": ["OnChange"] } ]}, { "table": "Данные", "path": "Данные", "changeRowSet": true, "columns": [ { "input": "Дата", "path": "Данные.Дата" }, { "input": "Сумма", "path": "Данные.Сумма" }, { "input": "Комментарий", "path": "Данные.Комментарий" } ]} ], "attributes": [ { "name": "Объект", "type": "ExternalDataProcessorObject.Просмотр", "main": true }, { "name": "Период", "type": "date" }, { "name": "Организация", "type": "string" }, { "name": "Данные", "type": "ValueTable", "columns": [ { "name": "Дата", "type": "date" }, { "name": "Сумма", "type": "decimal(15,2)" }, { "name": "Комментарий", "type": "string(200)" } ]} ] }

Автогенерация

• Companion-элементы: ContextMenu, ExtendedTooltip и др. создаются автоматически

• Обработчики событий: "on": ["OnChange"] → ОрганизацияПриИзменении

• Namespace: все 17 namespace-деклараций

• ID: последовательная нумерация, AutoCommandBar = id="-1"

• Unknown keys: выводится предупреждение о нераспознанных ключах

Верификация

/form-validate <OutputPath> — проверка корректности XML /form-info <OutputPath> — визуальная сводка структуры

Особенности для внешних обработок (EPF)

• Тип главного реквизита: ExternalDataProcessorObject.ИмяОбработки (не DataProcessorObject )

• DataPath: используйте реквизиты формы (ИмяРеквизита ), а не Объект.ИмяРеквизита — у внешних обработок нет реквизитов объекта в метаданных

• Ссылочные типы: CatalogRef.XXX , DocumentRef.XXX допустимы в XML, но для сборки EPF потребуется база с целевой конфигурацией (см. /epf-build )