/form-add — Добавление формы к объекту конфигурации
Создаёт управляемую форму (metadata XML + Form.xml + Module.bsl) и регистрирует её в корневом XML объекта конфигурации (Document, Catalog, InformationRegister и др.).
Usage
/form-add <ObjectPath> <FormName> [-Purpose <Purpose>] [-Synonym <Synonym>] [-SetDefault]
| Параметр |
Обязательный |
По умолчанию |
Описание |
| ObjectPath |
да |
— |
Путь к XML-файлу объекта (Documents/Док.xml) |
| FormName |
да |
— |
Имя формы (ФормаДокумента) |
| Purpose |
нет |
основная форма вида |
Назначение формы — см. таблицу ниже: у справочника это форма объекта, у регистра сведений — форма записи, у журнала — форма списка |
| Synonym |
нет |
= FormName |
Синоним формы |
| -SetDefault |
нет |
авто |
Сделать основной. Без флага основной становится первая форма каждого назначения |
Команда
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-add.ps1" -ObjectPath "<ObjectPath>" -FormName "<FormName>" [-Purpose "<Purpose>"] [-Synonym "<Synonym>"] [-SetDefault]
Purpose — назначение формы
| Purpose |
Какая форма |
Становится основной |
| Object |
форма объекта (элемента, документа, обработки) |
да |
| List |
форма списка |
да |
| Choice |
форма выбора |
да |
| Folder |
форма группы |
да |
| FolderChoice |
форма выбора группы |
да |
| Record |
форма записи |
да |
| RecordSet |
форма набора записей |
нет — в платформе нет такого свойства |
| Save |
форма сохранения настроек |
да |
| Load |
форма загрузки настроек |
да |
| Custom |
произвольная форма, без привязки к объекту |
нет |
Что доступно типу объекта
| Тип объекта |
Назначения |
| Catalog, ChartOfCharacteristicTypes |
Object, Folder, List, Choice, FolderChoice, Custom |
| Document, ChartOfAccounts, ChartOfCalculationTypes, ExchangePlan, BusinessProcess, Task |
Object, List, Choice, Custom |
| DataProcessor, Report, ExternalDataProcessor, ExternalReport |
Object, Custom |
| InformationRegister |
Record, List, RecordSet, Custom |
| AccumulationRegister, AccountingRegister, CalculationRegister |
List, RecordSet, Custom |
| DocumentJournal, FilterCriterion |
List, Custom |
| Enum |
List, Choice, Custom |
| SettingsStorage |
Save, Load, Custom |
| Table (таблица внешнего источника) |
tableDataType=ObjectData — Object, List, Choice, Custom; NonobjectData — Record, List, Choice, Custom |
Недопустимое сочетание отклоняется со списком доступных для этого типа. У константы собственных
форм нет — для неё используется общая форма (CommonForm).
Таблица внешнего источника адресуется файлом таблицы:
ExternalDataSources/<Источник>/Tables/<Таблица>.xml. Ссылки в такой форме трёхчастные;
без -Purpose берётся форма объекта, а у таблицы с составным ключом — форма записи.
Примеры
# Форма документа
/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 -SetDefault
Workflow
/form-add — создать каркас формы/form-compile или /form-edit — наполнить Form.xml элементами/form-validate — проверить корректность/form-info — проанализировать результат
1---2name: form-add3description: Добавить пустую управляемую форму к объекту 1С. Используй когда нужно создать у объекта новую форму4---56# /form-add — Добавление формы к объекту конфигурации78Создаёт управляемую форму (metadata XML + Form.xml + Module.bsl) и регистрирует её в корневом XML объекта конфигурации (Document, Catalog, InformationRegister и др.).910## Usage1112```13/form-add <ObjectPath> <FormName> [-Purpose <Purpose>] [-Synonym <Synonym>] [-SetDefault]14```1516| Параметр | Обязательный | По умолчанию | Описание |17|-------------|:------------:|--------------|----------------------------------------------|18| ObjectPath | да | — | Путь к XML-файлу объекта (Documents/Док.xml) |19| FormName | да | — | Имя формы (ФормаДокумента) |20| Purpose | нет | основная форма вида | Назначение формы — см. таблицу ниже: у справочника это форма объекта, у регистра сведений — форма записи, у журнала — форма списка |21| Synonym | нет | = FormName | Синоним формы |22| -SetDefault | нет | авто | Сделать основной. Без флага основной становится первая форма каждого назначения |2324## Команда2526```powershell27powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/form-add.ps1" -ObjectPath "<ObjectPath>" -FormName "<FormName>" [-Purpose "<Purpose>"] [-Synonym "<Synonym>"] [-SetDefault]28```2930## Purpose — назначение формы3132| Purpose | Какая форма | Становится основной |33|---------|-------------|---------------------|34| Object | форма объекта (элемента, документа, обработки) | да |35| List | форма списка | да |36| Choice | форма выбора | да |37| Folder | форма группы | да |38| FolderChoice | форма выбора группы | да |39| Record | форма записи | да |40| RecordSet | форма набора записей | нет — в платформе нет такого свойства |41| Save | форма сохранения настроек | да |42| Load | форма загрузки настроек | да |43| Custom | произвольная форма, без привязки к объекту | нет |4445### Что доступно типу объекта4647| Тип объекта | Назначения |48|-------------|------------|49| Catalog, ChartOfCharacteristicTypes | Object, Folder, List, Choice, FolderChoice, Custom |50| Document, ChartOfAccounts, ChartOfCalculationTypes, ExchangePlan, BusinessProcess, Task | Object, List, Choice, Custom |51| DataProcessor, Report, ExternalDataProcessor, ExternalReport | Object, Custom |52| InformationRegister | Record, List, RecordSet, Custom |53| AccumulationRegister, AccountingRegister, CalculationRegister | List, RecordSet, Custom |54| DocumentJournal, FilterCriterion | List, Custom |55| Enum | List, Choice, Custom |56| SettingsStorage | Save, Load, Custom |57| Table (таблица внешнего источника) | `tableDataType=ObjectData` — Object, List, Choice, Custom; `NonobjectData` — Record, List, Choice, Custom |5859Недопустимое сочетание отклоняется со списком доступных для этого типа. У константы собственных60форм нет — для неё используется общая форма (`CommonForm`).6162Таблица внешнего источника адресуется файлом таблицы:63`ExternalDataSources/<Источник>/Tables/<Таблица>.xml`. Ссылки в такой форме трёхчастные;64без `-Purpose` берётся форма объекта, а у таблицы с составным ключом — форма записи.6566## Примеры6768```69# Форма документа70/form-add Documents/АвансовыйОтчет.xml ФормаДокумента -Purpose Object7172# Форма списка каталога73/form-add Catalogs/Контрагенты.xml ФормаСписка -Purpose List7475# Форма записи регистра сведений76/form-add InformationRegisters/КурсыВалют.xml ФормаЗаписи -Purpose Record7778# Форма выбора с синонимом79/form-add Catalogs/Номенклатура.xml ФормаВыбора -Purpose Choice -Synonym "Выбор номенклатуры"8081# Установить как форму по умолчанию82/form-add Documents/Заказ.xml ФормаДокументаНовая -Purpose Object -SetDefault83```8485## Workflow86871. `/form-add` — создать каркас формы882. `/form-compile` или `/form-edit` — наполнить Form.xml элементами893. `/form-validate` — проверить корректность904. `/form-info` — проанализировать результат
Nikolay-Shirokov