1c Form Compile

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

Два режима:

1. JSON DSL - из JSON-определения формы
2. From object (-FromObject) - автоматически из метаданных объекта 1С по пресету ERP

При проектировании формы с нуля (5+ элементов или нечеткие требования) - вызовите /form-patterns для загрузки справочника. Для простых форм (1-3 поля) - не нужно.

Параметры

Команда

powershellCopy code
# Режим 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 DSL - справка

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

jsonCopy code
{
  "title": "Заголовок формы",
  "properties": { "autoTitle": false, ... },
  "events": { "OnCreateAtServer": "ПриСозданииНаСервере" },
  "excludedCommands": ["Reread"],
  "elements": [ ... ],
  "attributes": [ ... ],
  "commands": [ ... ],
  "parameters": [ ... ]
}

• title - заголовок формы (multilingual). Можно указать и в properties, но лучше на верхнем уровне
• properties - свойства формы: autoTitle, windowOpeningMode, commandBarLocation, saveDataInSettings, width, height и др.
• events - обработчики событий формы (ключ: имя события 1С, значение: имя процедуры)
• excludedCommands - исключенные стандартные команды

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

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

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

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

Форма (events): OnCreateAtServer, OnOpen, BeforeClose, OnClose, NotificationProcessing, ChoiceProcessing, OnReadAtServer, BeforeWriteAtServer, OnWriteAtServer, AfterWriteAtServer, BeforeWrite, AfterWrite, FillCheckProcessingAtServer, BeforeLoadDataFromSettingsAtServer, OnLoadDataFromSettingsAtServer, OnSaveDataInSettingsAtServer, ExternalEvent, OnReopen

input: OnChange, StartChoice, ChoiceProcessing, AutoComplete, TextEditEnd, Clearing, Creating, EditTextChange, Opening

picField: OnChange, StartChoice, ChoiceProcessing, Click, Clearing

check: OnChange

table: OnStartEdit, OnEditEnd, OnChange, Selection, ValueChoice, BeforeAddRow, BeforeDeleteRow, AfterDeleteRow, BeforeRowChange, BeforeEditEnd, OnActivateRow, OnActivateCell, OnActivateField, Drag, DragStart, DragCheck, DragEnd, OnGetDataAtServer, BeforeLoadUserSettingsAtServer, OnUpdateUserSettingSetAtServer

calendar: OnChange, OnActivate

label / picture: Click, URLProcessing

labelField: OnChange, StartChoice, ChoiceProcessing, Click, URLProcessing, Clearing

button: Click

pages: OnCurrentPageChange

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

Чекбокс (check)

Надпись-декорация (label)

Группа (group)

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

Таблица (table)

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

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

Кнопка (button)

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

Выпадающее меню (popup)

Используется внутри cmdBar для группировки кнопок в подменю:

jsonCopy code
{ "cmdBar": "Панель", "children": [
  { "popup": "Добавить", "title": "Добавить", "children": [
    { "button": "ДобавитьСтроку", "stdCommand": "Товары.Add" },
    { "button": "ДобавитьИзДокумента", "command": "ДобавитьИзДокумента", "title": "Из документа" }
  ]}
]}

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

jsonCopy code
{ "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 - сохраняемые данные
• useAlways: ["Поле"] - поля, читаемые с сервера всегда. Имя без точки достраивается именем реквизита, знак ~ остается впереди. Колонка с useAlways: true попадает в тот же список.
• additionalColumns: [{ "table": "Объект.Товары", "columns": [...] }] - дополнительные колонки табличной части объекта. Идут в <Columns> после прямых колонок; пустой список колонок дает <AdditionalColumns table="..."/>.

Команды (commands)

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

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

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

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

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

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

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

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

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

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

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

Таблица - элемент table + реквизит ValueTable:

jsonCopy code
{
  "elements": [
    { "table": "Товары", "path": "Объект.Товары", "columns": [
      { "input": "Номенклатура", "path": "Объект.Товары.Номенклатура" }
    ]}
  ],
  "attributes": [
    { "name": "Объект", "type": "DataProcessorObject.Загрузка", "main": true,
      "columns": [
        { "name": "Товары", "type": "ValueTable", "columns": [
          { "name": "Номенклатура", "type": "CatalogRef.Номенклатура" }
        ]}
      ]
    }
  ]
}

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

jsonCopy code
{
  "elements": [
    { "table": "ТаблицаДанных", "path": "ТаблицаДанных", "columns": [
      { "input": "Наименование", "path": "ТаблицаДанных.Наименование" }
    ]}
  ],
  "attributes": [
    { "name": "ТаблицаДанных", "type": "ValueTable", "columns": [
      { "name": "Наименование", "type": "string(150)" }
    ]}
  ]
}

Паттерны

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

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

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

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

jsonCopy code
{
  "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).
2. Метаданные формы (ФормаСписка.xml) и Module.bsl создает /form-add. Если /form-add еще не вызывался - вызови после /form-compile. Он не перезаписывает существующий Form.xml.
3. Существующий Module.bsl сохраняется: при повторной компиляции непустой модуль не перезаписывается и не дополняется обработчиками (выводится [SKIP] Module.bsl). Заготовки обработчиков пишутся только в отсутствующий или пустой файл (BOM и пробелы считаются пустотой). Параметры и директива заготовки (&НаСервере / &НаКлиенте) фиксированы по справке платформы для каждого события реестра и от имени обработчика не зависят; событие вне реестра заготовку не получает - только предупреждение, XML при этом пишется как задано.
4. Проверка: /form-validate, /form-info.

Верификация

Copy code
/form-validate <OutputPath>    - проверка корректности XML
/form-info <OutputPath>        - визуальная сводка структуры

Особенности для 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)
• DataPath: используйте реквизиты формы (ИмяРеквизита), а не Объект.ИмяРеквизита - у внешних обработок нет реквизитов объекта в метаданных
• Ссылочные типы: CatalogRef.XXX, DocumentRef.XXX допустимы в XML, но для сборки EPF потребуется база с целевой конфигурацией (см. /epf-build)