mirror of
https://github.com/Nikolay-Shirokov/cc-1c-skills.git
synced 2026-06-13 09:24:55 +03:00
Nick Shirokov
189 lines
9.3 KiB
Markdown
189 lines
9.3 KiB
Markdown
# Управляемые формы (Form)
|
||
|
||
Навыки группы `/form-*` позволяют анализировать и генерировать управляемые формы 1С:Предприятия 8.3 из XML-исходников, не читая тысячи строк XML.
|
||
|
||
## Навыки
|
||
|
||
| Навык | Параметры | Описание |
|
||
|-------|-----------|----------|
|
||
| `/form-info` | `<FormPath>` | Компактная сводка: дерево элементов, реквизиты, команды, события |
|
||
| `/form-compile` | `<JsonPath> <OutputPath>` | Генерация Form.xml из компактного JSON-определения |
|
||
|
||
## Сценарии использования
|
||
|
||
### Анализ формы перед модификацией
|
||
|
||
Файлы Form.xml содержат от сотен до десятков тысяч строк XML. 80% объёма — визуальный шум (цвета, шрифты, размеры, автогенерированные подсказки). `/form-info` извлекает суть.
|
||
|
||
```
|
||
> Покажи структуру формы документа РеализацияТоваровУслуг
|
||
```
|
||
|
||
Claude найдёт Form.xml и вызовет `/form-info`. Результат — компактная сводка (40–100 строк вместо тысяч):
|
||
|
||
```
|
||
=== Form: ФормаДокумента (Documents.РеализацияТоваровУслуг) ===
|
||
|
||
Properties: AutoTitle=false, CommandBarLocation=None
|
||
|
||
Events:
|
||
OnCreateAtServer -> ПриСозданииНаСервере
|
||
OnOpen -> ПриОткрытии
|
||
|
||
Elements:
|
||
├─ [Group:AH] ГруппаШапка
|
||
│ ├─ [Input] Организация -> Объект.Организация {OnChange}
|
||
│ └─ [Input] Контрагент -> Объект.Контрагент {OnChange, StartChoice}
|
||
├─ [Table] Товары -> Объект.Товары
|
||
│ ├─ [Input] Номенклатура -> Объект.Товары.Номенклатура {OnChange}
|
||
│ └─ [Input] Сумма -> Объект.Товары.Сумма [ro]
|
||
└─ [Pages] Страницы
|
||
├─ [Page] Основное (5 items)
|
||
└─ [Page] Печать (2 items)
|
||
|
||
Attributes:
|
||
*Объект: DocumentObject.РеализацияТоваровУслуг (main)
|
||
Валюта: CatalogRef.Валюты
|
||
...
|
||
|
||
Commands:
|
||
Печать -> ПечатьДокумента [Ctrl+P]
|
||
```
|
||
|
||
### Добавление элемента на форму
|
||
|
||
Чтобы добавить поле на форму, нужно знать структуру групп и ориентацию (горизонтальная/вертикальная). `/form-info` показывает это в дереве элементов.
|
||
|
||
```
|
||
> Добавь поле "Склад" в шапку формы документа
|
||
```
|
||
|
||
Claude вызовет `/form-info`, увидит `[Group:AH] ГруппаШапка` → `[Group:V] ГруппаШапкаЛевая`, поймёт куда вставить элемент в XML.
|
||
|
||
### Поиск обработчиков и привязок
|
||
|
||
Из сводки видно, какие события подключены к каким элементам:
|
||
|
||
```
|
||
> Какие обработчики срабатывают при изменении контрагента?
|
||
```
|
||
|
||
Claude вызовет `/form-info` и найдёт: `[Input] Контрагент -> Объект.Контрагент {OnChange, StartChoice}` — далее откроет модуль формы и найдёт процедуры по именам событий.
|
||
|
||
### Точечное погружение в детали
|
||
|
||
Сводка — это карта. Для деталей по конкретному элементу достаточно grep по имени из сводки:
|
||
|
||
```
|
||
> Покажи все свойства элемента ДоговорКонтрагента
|
||
```
|
||
|
||
Claude сделает grep по Form.xml и найдёт полный XML-блок с ChoiceParameters, ChoiceFoldersAndItems, стилями и прочими свойствами.
|
||
|
||
## Чтение вывода
|
||
|
||
### Дерево элементов
|
||
|
||
| Обозначение | Элемент |
|
||
|---|---|
|
||
| `[Group:V]` `[Group:H]` `[Group:AH]` `[Group:AV]` | Группа (Vertical / Horizontal / AlwaysHorizontal / AlwaysVertical) |
|
||
| `[Input]` | Поле ввода |
|
||
| `[Check]` | Флажок |
|
||
| `[Label]` | Декоративная надпись |
|
||
| `[LabelField]` | Поле надписи (привязанное к данным) |
|
||
| `[Table]` | Таблица |
|
||
| `[Pages]` / `[Page]` | Вкладки (страницы показывают количество элементов) |
|
||
| `[Button]` | Кнопка |
|
||
| `[CmdBar]` | Командная панель |
|
||
| `[Popup]` | Выпадающее меню |
|
||
| `[Picture]` | Декоративная картинка |
|
||
| `[PicField]` | Поле картинки |
|
||
| `[Calendar]` | Календарь |
|
||
|
||
### Флаги
|
||
|
||
Показываются только при отклонении от умолчания:
|
||
- `[hidden]` — элемент скрыт (Visible=false)
|
||
- `[disabled]` — элемент недоступен (Enabled=false)
|
||
- `[ro]` — только чтение (ReadOnly=true)
|
||
- `,collapse` — сворачиваемая группа (Behavior=Collapsible)
|
||
|
||
### Привязки и события
|
||
|
||
- `-> Объект.Поле` — DataPath (привязка к данным)
|
||
- `-> Form.Command.Имя` — привязка к команде формы
|
||
- `{OnChange, StartChoice}` — имена подключённых событий
|
||
- `[title:Текст]` — заголовок, если отличается от имени элемента
|
||
|
||
### Реквизиты
|
||
|
||
- `*Объект: DocumentObject.Реализация (main)` — основной реквизит формы
|
||
- `Таблица: ValueTable [Кол1: тип, Кол2: тип]` — таблица значений с колонками
|
||
- `Список: DynamicList -> Catalog.Пользователи` — динамический список с основной таблицей
|
||
|
||
## Генерация формы с нуля
|
||
|
||
`/form-compile` принимает компактное JSON-определение (20–50 строк) и генерирует полный Form.xml (100–500+ строк) с namespace-декларациями, companion-элементами и последовательными ID.
|
||
|
||
```
|
||
> Создай форму загрузки данных с полями Организация, Контрагент, таблицей Товары и кнопкой Загрузить
|
||
```
|
||
|
||
Claude создаст JSON-определение и вызовет `/form-compile`. Пример JSON:
|
||
|
||
```json
|
||
{
|
||
"properties": { "autoTitle": false },
|
||
"events": { "OnCreateAtServer": "ПриСозданииНаСервере" },
|
||
"elements": [
|
||
{ "group": "horizontal", "name": "Шапка", "children": [
|
||
{ "input": "Организация", "path": "Объект.Организация", "on": ["OnChange"] },
|
||
{ "input": "Контрагент", "path": "Объект.Контрагент" }
|
||
]},
|
||
{ "table": "Товары", "path": "Объект.Товары", "columns": [
|
||
{ "input": "Номенклатура", "path": "Объект.Товары.Номенклатура" },
|
||
{ "input": "Сумма", "path": "Объект.Товары.Сумма", "readOnly": true }
|
||
]},
|
||
{ "button": "Загрузить", "command": "Загрузить" }
|
||
],
|
||
"attributes": [
|
||
{ "name": "Объект", "type": "DataProcessorObject.ЗагрузкаДанных", "main": true }
|
||
],
|
||
"commands": [
|
||
{ "name": "Загрузить", "action": "ЗагрузитьОбработка" }
|
||
]
|
||
}
|
||
```
|
||
|
||
### Верификация результата
|
||
|
||
После компиляции используйте `/form-info` для проверки:
|
||
|
||
```
|
||
> /form-info src/МояОбработка/Forms/Форма/Ext/Form.xml
|
||
```
|
||
|
||
Структура в сводке должна совпадать с определением в JSON.
|
||
|
||
## Примеры слеш-команд
|
||
|
||
```
|
||
> /form-info upload/acc_8.3.24/Documents/РеализацияТоваровУслуг/Forms/ФормаДокумента/Ext/Form.xml
|
||
> /form-info src/МояОбработка/Forms/Форма/Ext/Form.xml
|
||
> /form-compile src/form.json src/МояОбработка/Forms/Форма/Ext/Form.xml
|
||
```
|
||
|
||
## Связь с EPF-навыками
|
||
|
||
`/form-info` и `/form-compile` работают с формами из любых источников — конфигурации и внешних обработок. При работе с обработками:
|
||
|
||
1. `/epf-add-form` — создать форму (каркас)
|
||
2. `/form-compile` — сгенерировать Form.xml из JSON-определения
|
||
3. `/form-info` — проверить результат
|
||
4. `/epf-build` — собрать EPF
|
||
|
||
## Спецификации
|
||
|
||
- [Управляемая форма](1c-form-spec.md) — Form.xml, элементы, команды, реквизиты, система типов
|
||
- [Form DSL](form-dsl-spec.md) — JSON-формат описания формы для `/form-compile`
|