Form Compile

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

MCP routing

• Preferred path: use MCP unica tool unica.apply: форма заводится операцией form.create, наполняется element.add, formAttribute.add, formCommand.add, event.bind.
• Не зови внутренние адаптеры напрямую: они спрятаны за MCP unica.
• Всегда сначала dryRun: true; dryRun: false — только по явной просьбе пользователя и только с ifRev из превью.
• Словарь операций узла даёт unica.view {at} в секции can.

Шаг 1 — завести форму

Адрес называет будущую форму: <набор>:<Вид>.<Имя>.Form.<Форма>; values.type задаёт назначение, values.name обязано совпасть с именем в адресе.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "unica.apply",
    "arguments": {
      "at": "main:Catalog.Валюты.Form.ФормаЭлемента",
      "ops": [
        {"op": "form.create", "args": {"values": {"name": "ФормаЭлемента", "type": "ObjectForm"}}}
      ],
      "dryRun": true
    }
  }
}

Шаг 2 — наполнить

Применение первого шага публикует форму; после него её адрес принимает элементы, реквизиты и команды. Порядок тот же, что у всякой операции: превью → применение с ifRev → превью следующего шага → применение.

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "unica.apply",
    "arguments": {
      "at": "main:Catalog.Валюты.Form.ФормаЭлемента",
      "ops": [
        {"op": "formAttribute.add", "args": {"items": [{"name": "Объект", "type": "CatalogObject.Валюты", "main": true}]}},
        {"op": "element.add", "args": {"items": [{"input": "Наименование", "path": "Объект.Наименование"}]}}
      ],
      "dryRun": true
    }
  }
}

Точечные правки готовой формы держит form-edit; DSL ниже описывает, как выражать элементы в items.

Чего словарь не пишет

Сборки целой формы из готового JSON-определения одним вызовом на поверхности нет: DSL ниже остаётся справочником формата. Виды элементов, которые словарь создаёт, и виды, которые только читаются, перечислены в form-edit. Форма, которую не собрать этими операциями, — пробел контракта Unica MCP.

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С, значение: непустое строковое имя процедуры). Этот формат не поддерживает callType.
• excludedCommands — исключённые стандартные команды

Новые возможности DSL

• Форма отчёта: reportResult, reportFormType, reportResultViewMode.
• Управление выбором: choiceParameters, choiceParameterLinks, availableTypes.
• Служебные элементы и панели: extendedTooltip, commandBar, contextMenu, mobileCommandBarContent.
• Ролевое ограничение элементов и команд: roles.
• Командный интерфейс и навигация: CommandInterface, NavigationPanel.
• Специальные визуальные типы: chart, GanttChart.
• Динамические списки: dynamicDataRead в настройках реквизита DynamicList.

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

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

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

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

Форма (events): OnCreateAtServer, OnOpen, BeforeClose, OnClose, NotificationProcessing, ChoiceProcessing, ExternalEvent, OnReopen, OnMainServerAvailabilityChange, OnReadAtServer, BeforeWrite, NewWriteProcessing, FillCheckProcessingAtServer, BeforeWriteAtServer, OnWriteAtServer, AfterWriteAtServer, AfterWrite, BeforeLoadDataFromSettingsAtServer, OnLoadDataFromSettingsAtServer, OnSaveDataInSettingsAtServer, BeforeLoadUserSettingsAtServer, OnLoadUserSettingsAtServer, OnSaveUserSettingsAtServer, OnUpdateUserSettingSetAtServer, BeforeLoadVariantAtServer, OnLoadVariantAtServer, OnSaveVariantAtServer, OnChangeDisplaySettings, URLProcessing, URLListGetProcessing, URLGetProcessing, NavigationProcessing

События OnReadAtServer, BeforeWrite, BeforeWriteAtServer, OnWriteAtServer, AfterWriteAtServer и AfterWrite допустимы только при главном реквизите формы постоянного объекта или записи.

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

Чекбокс (check)

Группа (group)

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

Таблица (table)

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

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

Кнопка (button)

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

Дополнительная пользовательская панель команд, размещается как обычный элемент в layout формы.

Главная автокомандная панель формы (autoCmdBar)

Наполняет встроенную AutoCommandBar формы (id=-1) кастомными кнопками. Указывать только если нужно добавить свои кнопки на главную панель или явно управлять автозаполнением.

{ "autoCmdBar": "ФормаКоманднаяПанель", "autofill": true, "children": [
   { "button": "ИзменитьВыделенные", "command": "ИзменитьВыделенные",
     "locationInCommandBar": "InAdditionalSubmenu" }
]}

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

{ "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)" }
]}

• savedData: true — сохраняемые данные
• main: true — главный реквизит формы (например, основной *Object.*, DynamicList, *RecordSet.*)

Команды (commands)

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

• title — заголовок (если отличается от name)
• picture — картинка команды

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

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

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

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

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

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

FormDataStructure, FormDataCollection, FormDataTree — runtime-типы 1С, не существуют в XML-схеме. Вместо них используйте CatalogObject.XXX, DocumentObject.XXX, DataProcessorObject.XXX, ValueTable, ValueTree.

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

Таблица и некоторые поля требуют связанный реквизит. Элемент ссылается на реквизит через 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: выводится предупреждение о нераспознанных ключах

Workflow

1. Сборка: unica.apply (form.create, затем наполнение) генерирует Form.xml и регистрирует <Form> в составе объекта-владельца, названного адресом.
2. Метаданные формы (ФормаСписка.xml) и Module.bsl создаёт та же form.create; form.add регистрирует форму в составе объекта, когда она заводится списком. Существующий Form.xml ни одна из них не перезаписывает.
3. Проверка: unica.check на узле формы, затем unica.view on the form node.

Верификация

Проверка корректности XML

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "unica.check",
    "arguments": {
      "at": "<sourceSet>:Catalog.Валюты.Form.ФормаЭлемента"
    }
  }
}

Сводка структуры формы

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "unica.view",
    "arguments": {
      "cwd": "<workspace>",
      "at": "main:Catalog.Валюты.Form.ФормаЭлемента"
    }
  }
}

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

• Runtime идёт через unica.run: вызов без op отдаёт словарь операций и контракт каждой — argsSchema, execution, previewRequired, ifRevRequiredOnApply. Контракт вызова бери оттуда, а не из этого текста; выбирай только операцию с implemented: true и не выдумывай аргументов записи с argsSchema: null; превью исполнением не является. Не обходи контракт прямым runner-ом.

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

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

• Ссылочные типы: CatalogRef.XXX, DocumentRef.XXX допустимы в XML, но для будущей публикации EPF потребуется база с целевой конфигурацией; runtime-публикацию сначала обнаруживать через unica.run {} и использовать artifact.build только при implemented: true, не угадывая аргументы при argsSchema: null