form-edit

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

1. unica.form.info — посмотреть текущую структуру формы
2. Создать JSON с описанием добавлений
3. unica.form.edit — добавить в форму
4. unica.form.validate — проверить корректность
5. unica.form.info — убедиться что добавилось правильно