git:20260827.9eb6ebe to git:20260828.2b87e3e

---

name: 1c-form-compile

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

argument-hint: <JsonPath> <OutputPath> | -FromObject <OutputPath>

allowed-tools:

- Bash

- Read

- Write

- Glob

---

Два режима:

## Параметры

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

|------------|:------------:|---------------------------------|

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

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

## Команда

```powershell

# Режим JSON DSL

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

# Режим from-object (объект и purpose выводятся из OutputPath; Document и Catalog)

powershell.exe -NoProfile -File skills/1c-form-compile/scripts/form-compile.ps1 -FromObject -OutputPath "<.../TypePlural/ObjectName/Forms/FormName/Ext/Form.xml>"

```

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

```json

{

"title": "Заголовок формы",

"properties": { "autoTitle": false, ... },

"events": { "OnCreateAtServer": "ПриСозданииНаСервере" },

"excludedCommands": ["Reread"],

"elements": [ ... ],

"attributes": [ ... ],

"commands": [ ... ],

"parameters": [ ... ]

}

```

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

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

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

| `"group"` | UsualGroup | `"horizontal"` / `"vertical"` / `"alwaysHorizontal"` / `"alwaysVertical"` / `"collapsible"` |

| `"input"` | InputField | имя элемента |

| `"check"` | CheckBoxField | имя |

| `"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: [...]` | События с автоименованием обработчиков |

### Допустимые имена событий (`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)

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

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

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

| `multiLine: 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)

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

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

| `showTitle: true` | Показывать заголовок группы |

| `united: false` | Не объединять рамку |

| `representation` | `"none"`, `"normal"`, `"weak"`, `"strong"` |

| `children: [...]` | Вложенные элементы |

### Таблица (table)

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

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

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

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

| `changeRowSet: true` | Разрешить добавление/удаление строк |

| `changeRowOrder: true` | Разрешить перемещение строк |

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

| `header: false` | Скрыть шапку |

| `footer: true` | Показать подвал |

| `commandBarLocation` | `"None"`, `"Top"`, `"Auto"` |

| `searchStringLocation` | `"None"`, `"Top"`, `"Auto"` |

| `choiceMode: true` | Режим выбора (для форм выбора) |

| `initialTreeView` | `"ExpandTopLevel"` и др. (иерархические списки) |

| `enableDrag: true` | Разрешить перетаскивание |

| `enableStartDrag: true` | Разрешить начало перетаскивания |

| `rowPictureDataPath` | Путь к картинке строки (напр. `"Список.DefaultPicture"`) |

| `tableAutofill: false` | Управление Autofill внутреннего AutoCommandBar |

### Страницы (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` для группировки кнопок в подменю:

```json

{ "cmdBar": "Панель", "children": [

{ "popup": "Добавить", "title": "Добавить", "children": [

{ "button": "ДобавитьСтроку", "stdCommand": "Товары.Add" },

{ "button": "ДобавитьИзДокумента", "command": "ДобавитьИзДокумента", "title": "Из документа" }

]}

]}

```

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

```json

{ "name": "Объект", "type": "DataProcessorObject.Загрузка", "main": true }

{ "name": "Список", "type": "DynamicList", "main": true, "settings": {

"mainTable": "Catalog.Номенклатура", "dynamicDataRead": true

}}

{ "name": "Итого", "type": "decimal(15,2)" }

{ "name": "Таблица", "type": "ValueTable", "columns": [

{ "name": "Номенклатура", "type": "CatalogRef.Номенклатура" },

{ "name": "Количество", "type": "decimal(10,3)" }

]}

```

- `useAlways: ["Поле"]` - поля, читаемые с сервера всегда. Имя без точки достраивается

именем реквизита, знак `~` остается впереди. Колонка с `useAlways: true` попадает в тот же

список.

- `additionalColumns: [{ "table": "Объект.Товары", "columns": [...] }]` - дополнительные

колонки табличной части объекта. Идут в `<Columns>` после прямых колонок; пустой список

колонок дает `<AdditionalColumns table="..."/>`.

### Команды (commands)

```json

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

```

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

**Примитивные:**

| 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 |

**Ссылочные и объектные (`cfg:Prefix.Name`):**

| DSL | Описание |

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

| `"CatalogRef.XXX"` / `"CatalogObject.XXX"` | Справочник |

| `"DocumentRef.XXX"` / `"DocumentObject.XXX"` | Документ |

| `"EnumRef.XXX"` | Перечисление |

| `"InformationRegisterRecordSet.XXX"` | Набор записей регистра сведений |

| `"AccumulationRegisterRecordSet.XXX"` | Набор записей регистра накопления |

| `"DynamicList"` | Динамический список |

Также допустимы: `ChartOfAccountsRef/Object`, `ChartOfCharacteristicTypesRef/Object`, `ChartOfCalculationTypesRef/Object`, `ExchangePlanRef/Object`, `BusinessProcessRef/Object`, `TaskRef/Object`, `AccountingRegisterRecordSet`, `InformationRegisterRecordManager`, `ConstantsSet`.

**Платформенные:**

| DSL | XML |

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

| `"ValueTable"` | `v8:ValueTable` |

| `"ValueTree"` | `v8:ValueTree` |

| `"ValueList"` | `v8:ValueListType` |

| `"TypeDescription"` | `v8:TypeDescription` |

| `"UUID"` | `v8:UUID` |

| `"FormattedString"` | `v8ui:FormattedString` |

| `"Picture"` / `"Color"` / `"Font"` | `v8ui:*` |

| `"DataCompositionSettings"` | `dcsset:DataCompositionSettings` |

| `"Type1 \| Type2"` | составной тип (несколько `<v8:Type>`) |

**Недопустимые типы (XDTO-ошибка при загрузке):**

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

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

```json

{

"elements": [

{ "table": "Товары", "path": "Объект.Товары", "columns": [

{ "input": "Номенклатура", "path": "Объект.Товары.Номенклатура" }

]}

],

"attributes": [

{ "name": "Объект", "type": "DataProcessorObject.Загрузка", "main": true,

"columns": [

{ "name": "Товары", "type": "ValueTable", "columns": [

{ "name": "Номенклатура", "type": "CatalogRef.Номенклатура" }

]}

]

}

]

}

```

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

```json

{

"elements": [

{ "table": "ТаблицаДанных", "path": "ТаблицаДанных", "columns": [

{ "input": "Наименование", "path": "ТаблицаДанных.Наименование" }

]}

],

"attributes": [

{ "name": "ТаблицаДанных", "type": "ValueTable", "columns": [

{ "name": "Наименование", "type": "string(150)" }

]}

]

}

```

## Паттерны

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

```json

{

"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) с шагами

```json

{

"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": "ДалееОбработка" }

]

}

```

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

```json

{

"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**: выводится предупреждение о нераспознанных ключах

## Workflow

1. **Компиляция**: `/form-compile` генерирует `Form.xml` и автоматически регистрирует `<Form>` в `ChildObjects` родительского объекта (если OutputPath следует конвенции `.../TypePlural/ObjectName/Forms/FormName/Ext/Form.xml`).

3. **Проверка**: `/form-validate`, `/form-info`.

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

```

```

## Особенности для EDT-проектов

> **form-compile генерирует формы в формате logform (XML-выгрузка).** Для EDT-проектов форма будет работать, но дизайнер EDT может показать пустую форму из-за отсутствия EDT-специфичных свойств. Альтернативы: создать форму штатно через EDT или использовать MCP `generate_form_from_metadata` с `format="edt"`.

Если форма создается вручную или через form-compile для EDT, после генерации необходимо добавить:

### Критично (без этого дизайнер EDT пустой)

- `<extInfo xsi:type="form:ТипFormExtInfo"/>` на корневом `form:Form` - тип формы:

- `CatalogFormExtInfo` - справочник

- `DocumentFormExtInfo` - документ

- `DataProcessorFormExtInfo` - обработка

- `InformationRegisterFormExtInfo` - регистр сведений

### Обязательные свойства формы

- `commandInterface` с `<navigationPanel/>` и `<commandBar/>`

- `windowOpeningMode` = `LockOwnerWindow`

- `autoFillCheck` = `true`

- `showTitle`, `showCloseButton` = `true`

- `allowFormCustomize`, `saveWindowSettings` = `true`

### Обязательные свойства полей (InputField, LabelField, CheckBoxField)

- `visible`, `enabled` = `true`

- `userVisible` с `<common>true</common>`

- `editMode` = `EnterOnInput`

- `showInHeader`, `showInFooter` = `true`

- `typeDomainEnabled` = `true`

- `chooseType` = `true`

- `wrap` = `true`

- `textEdit` = `true`

- `headerHorizontalAlign` = `Left`

### Обязательные свойства кнопок (Button)

- Кнопка на форме (вне CommandBar): `type` = `UsualButton` (обязательно)

- Кнопка в CommandBar: `type` = `CommandBarButton` (дефолт, можно не указывать)

- Имя кнопки = имя команды (не `Кнопка[Команда]`, не `[Команда]Кнопка`)

### Размещение обработчиков событий (Events)

Обработчики InputField делятся по месту размещения в XML:

**На уровне элемента** (`<Events>` внутри `<InputField>`):

- `OnChange`, `DragCheck`, `Drag`, `DragStart`

**Внутри `<extInfo xsi:type="form:InputFieldExtInfo">`** (`<handlers>`):

- `StartChoice`, `Clearing`, `Opening`, `ChoiceProcessing`, `AutoComplete`, `TextEditEnd`

Эти события специфичны для типа поля и размещаются внутри extInfo, а не на уровне элемента.

### Специфика объектов

- Иерархический справочник - всегда добавлять поле Родитель (Parent)

- DynamicList: `<extInfo xsi:type="form:DynamicListExtInfo">` на атрибуте с `mainTable`

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

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

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