form-add

/form-add — Adding a form to a configuration object

Creates a managed form (metadata XML + Form.xml + Module.bsl) and registers it in the root XML of the configuration object (Document, Catalog, InformationRegister, etc.).

Usage

/form-add <ObjectPath> <FormName> [Purpose] [Synonym] [--set-default]

Parameter	Required	Default	Description
ObjectPath	yes	—	Path to the object's XML file (Documents/Doc.xml)
FormName	yes	—	Form name (DocumentForm)
Purpose	no	Object	Purpose: Object, List, Choice, Record
Synonym	no	= FormName	Form synonym
--set-default	no	auto	Set as the default form

Command

powershell.exe -NoProfile -File .claude/skills/form-add/scripts/form-add.ps1 -ObjectPath "<ObjectPath>" -FormName "<FormName>" [-Purpose "<Purpose>"] [-Synonym "<Synonym>"] [-SetDefault]

Purpose — form purpose

Purpose	Valid object types	Main attribute	DefaultForm property
Object	Document, Catalog, DataProcessor, Report, ExternalDataProcessor, ExternalReport, ChartOf*, ExchangePlan, BusinessProcess, Task	Object (type: *Object.Name)	DefaultObjectForm (DefaultForm for DataProcessor/Report/ExternalDataProcessor/ExternalReport)
List	All except DataProcessor	List (DynamicList)	DefaultListForm
Choice	Document, Catalog, ChartOf*, ExchangePlan, BusinessProcess, Task	List (DynamicList)	DefaultChoiceForm
Record	InformationRegister	Record (InformationRegisterRecordManager)	DefaultRecordForm

What is created

<ObjectDir>/Forms/
├── <FormName>.xml                    # Метаданные формы (UUID)
└── <FormName>/
    └── Ext/
        ├── Form.xml                  # Описание формы (logform namespace)
        └── Form/
            └── Module.bsl           # BSL-модуль с 5 регионами + ПриСозданииНаСервере

What is modified

<ObjectPath> — added <Form> в ChildObjects (before <Template> or <TabularSection>), Default*Form is updated (automatically if empty, or explicitly with --set-default)

Supported object types

Document, Catalog, DataProcessor, Report, ExternalDataProcessor, ExternalReport, InformationRegister, ChartOfAccounts, ChartOfCharacteristicTypes, ExchangePlan, BusinessProcess, Task

Examples

# Форма документа
/form-add Documents/АвансовыйОтчет.xml ФормаДокумента --purpose Object

# Форма списка каталога
/form-add Catalogs/Контрагенты.xml ФормаСписка --purpose List

# Форма записи регистра сведений
/form-add InformationRegisters/КурсыВалют.xml ФормаЗаписи --purpose Record

# Форма выбора с синонимом
/form-add Catalogs/Номенклатура.xml ФормаВыбора --purpose Choice --synonym "Выбор номенклатуры"

# Установить как форму по умолчанию
/form-add Documents/Заказ.xml ФормаДокументаНовая --purpose Object --set-default

Workflow

/form-add — create a form skeleton
/form-compile or /form-edit — populate Form.xml with elements
/form-validate — check correctness
/form-info — analyze the result