| name | form-edit |
| description | Добавление элементов, реквизитов и команд в существующую управляемую форму 1С. Используй когда нужно точечно модифицировать готовую форму |
| argument-hint | <FormPath> (<JsonPath> | <definition>) |
| allowed-tools | ["Bash","Read","Write","Glob"] |
/form-edit — Редактирование формы
MCP routing
- Preferred path: use MCP
unica tool unica.form.edit; unica owns XML/JSON DSL work and refreshes related workspace caches after mutations.
- Do not call internal MCP/CLI adapters directly. They are hidden behind
unica and synchronized by the orchestrator.
- Execution path: call MCP
unica tool unica.form.edit; skill-local operation scripts are not part of the workflow.
- For mutating operations, pass
dryRun: false only when the user explicitly requested the change; otherwise keep the default dry run.
- Vendor support guard runs inside
unica; if it blocks a locked/read-only supported object, prefer CFE/release-support or an explicit support-state change plan instead of editing raw support metadata.
Добавляет элементы, реквизиты и/или команды в существующий Form.xml. Автоматически выделяет ID из правильного пула, генерирует companion-элементы (ContextMenu, ExtendedTooltip, и др.) и обработчики событий.
Использование
Используй MCP unica tool unica.form.edit с FormPath и ровно одним источником изменений: JsonPath или inline-объектом definition.
Параметры
| Параметр | Обязательный | Описание |
|---|
| FormPath | да | Путь к существующему Form.xml |
| JsonPath | один из двух | Путь к JSON с описанием добавлений |
| definition | один из двух | То же описание как inline JSON object |
MCP вызов
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "unica.form.edit",
"arguments": {
"cwd": "<workspace>",
"FormPath": "src/Catalogs/Номенклатура/Forms/ФормаЭлемента/Ext/Form.xml",
"JsonPath": "forms/patch-add-article.json",
"dryRun": false
}
}
}
Для небольшого изменения можно передать DSL без временного файла:
{
"FormPath": "src/Catalogs/Номенклатура/Forms/ФормаЭлемента/Ext/Form.xml",
"definition": {
"formEvents": [
{ "name": "OnCreateAtServer", "handler": "ПриСозданииНаСервере" }
]
},
"dryRun": false
}
JSON формат
{
"into": "ГруппаШапка",
"after": "Контрагент",
"elements": [
{ "input": "Склад", "path": "Объект.Склад", "on": ["OnChange"] }
],
"attributes": [
{ "name": "СуммаИтого", "type": "decimal(15,2)" }
],
"commands": [
{ "name": "Рассчитать", "action": "РассчитатьОбработка" }
]
}
Расширения (extension-формы)
Для заимствованных форм (с <BaseForm>) автоматически активируется extension-режим: ID начинаются с 1000000+. Доступны дополнительные секции:
{
"formEvents": [
{ "name": "OnCreateAtServer", "handler": "Расш1_ПриСозданииПосле", "callType": "After" },
{ "name": "OnOpen", "handler": "Расш1_ПриОткрытии", "callType": "Before" }
],
"elementEvents": [
{ "element": "Банк", "name": "OnChange", "handler": "Расш1_БанкПриИзменении", "callType": "Before" }
],
"commands": [
{ "name": "Подбор", "action": "Расш1_ПодборПосле", "callType": "After" },
{ "name": "Запрос", "actions": [
{ "callType": "Before", "handler": "Расш1_ЗапросПеред" },
{ "callType": "After", "handler": "Расш1_ЗапросПосле" }
]}
],
"elements": [
{ "input": "Поле", "path": "Объект.Поле", "on": [{ "event": "OnChange", "callType": "After" }] }
]
}
Позиционирование элементов
| Ключ | По умолчанию | Описание |
|---|
into | корневой ChildItems | Имя группы/таблицы/страницы, куда вставлять |
after | в конец | Имя элемента, после которого вставлять |
Типы элементов
Те же DSL-ключи, что в unica.form.compile:
| Ключ | XML тег | Companions |
|---|
input | InputField | ContextMenu, ExtendedTooltip |
check | CheckBoxField | ContextMenu, ExtendedTooltip |
label | LabelDecoration | ContextMenu, ExtendedTooltip |
labelField | LabelField | ContextMenu, ExtendedTooltip |
group | UsualGroup | ExtendedTooltip |
table | Table | ContextMenu, AutoCommandBar, Search*, ViewStatus* |
pages | Pages | ExtendedTooltip |
page | Page | ExtendedTooltip |
button | Button | ExtendedTooltip |
Группы и таблицы поддерживают children/columns для вложенных элементов.
Кнопки: command и stdCommand
"command": "ИмяКоманды" → Form.Command.ИмяКоманды"stdCommand": "Close" → Form.StandardCommand.Close"stdCommand": "Товары.Add" → Form.Item.Товары.StandardCommand.Add (стандартная команда элемента)
Допустимые события (on)
Editor до записи проверяет событие по единой платформенной матрице. Недопустимое сочетание возвращает ok=false и код FORM_EVENT_*, не меняя файл. Основные сочетания:
- input:
OnChange, StartChoice, ChoiceProcessing, Clearing, AutoComplete, TextEditEnd, Opening, Creating, EditTextChange
- check:
OnChange
- table:
OnStartEdit, OnEditEnd, OnChange, Selection, BeforeAddRow, BeforeDeleteRow, OnActivateRow
- label:
Click, URLProcessing
- picture:
Click, Drag, DragCheck
- pages:
OnCurrentPageChange
- page/button/group/command bar: события не поддерживаются
События table требуют непустой привязки: path для нового элемента или прямого DataPath у существующего Table. Платформа удаляет обработчики событий у несвязанной таблицы при загрузке/выгрузке конфигурации.
OnReadAtServer, BeforeWrite, BeforeWriteAtServer, OnWriteAtServer, AfterWriteAtServer и AfterWrite разрешены только при подтверждённом persistent object/record типе главного реквизита. Для DataProcessorObject, ReportObject, DynamicList и неизвестного контекста они отклоняются. NewWriteProcessing и FillCheckProcessingAtServer являются общими событиями формы и этим ограничением не связаны.
Система типов (для attributes)
string, string(100), decimal(15,2), boolean, date, dateTime, CatalogRef.XXX, DocumentObject.XXX, ValueTable, DynamicList, Type1 | Type2 (составной).
Секции расширений
| Секция | Назначение |
|---|
formEvents | События уровня формы; callType только для расширения |
elementEvents | События существующих элементов; callType только для расширения |
callType на commands | callType на Action команды |
callType на on | callType на событиях новых элементов (объектный формат) |
Все extension-секции опциональны — без них навык работает как с обычными формами.
Повтор идентичного binding является явным idempotent no-op. Конфликт обработчика/callType, duplicate, отсутствующий элемент и любой недопустимый event отклоняют весь batch до мутации; dryRun: true использует тот же planner.
Workflow
unica.form.info — посмотреть текущую структуру формы- Создать JSON с описанием добавлений
unica.form.edit — добавить в формуunica.form.validate — проверить корректностьunica.form.info — убедиться что добавилось правильно
