name: form-add description: 添加管理表单到1C配置对象 argument-hint: <ObjectPath> <FormName> [Purpose] [–set-default] allowed-tools:
- Bash
- Read
- Write
- Edit
- Glob
- Grep
/form-add — 添加表单到配置对象
创建管理表单(元数据XML + Form.xml + Module.bsl)并在配置对象的根XML中注册(文档、目录、信息寄存器等)。
用法
/form-add <ObjectPath> <FormName> [Purpose] [Synonym] [--set-default]
| 参数 | 必选 | 默认值 | 描述 |
|---|---|---|---|
| ObjectPath | 是 | — | 对象XML文件的路径(如Documents/文档.xml) |
| FormName | 是 | — | 表单名称(如ФормаДокумента) |
| Purpose | 否 | Object | 用途:Object, List, Choice, Record |
| Synonym | 否 | = FormName | 表单同义词 |
| –set-default | 否 | 自动 | 设置为默认表单 |
命令
powershell.exe -NoProfile -File .claude/skills/form-add/scripts/form-add.ps1 -ObjectPath "<ObjectPath>" -FormName "<FormName>" [-Purpose "<Purpose>"] [-Synonym "<Synonym>"] [-SetDefault]
Purpose — 表单用途
| Purpose | 允许的对象类型 | 主要组件 | DefaultForm属性 |
|---|---|---|---|
| Object | 文档、目录、数据处理器、报表、外部数据处理器、外部报表、科目表*、交换计划、业务流程、任务 | 对象(类型:*Object.名称) | DefaultObjectForm(数据处理器/报表/外部数据处理器/外部报表的DefaultForm) |
| List | 除数据处理器外的所有类型 | 列表(DynamicList) | DefaultListForm |
| Choice | 文档、目录、科目表*、交换计划、业务流程、任务 | 列表(DynamicList) | DefaultChoiceForm |
| Record | 信息寄存器 | 记录(InformationRegisterRecordManager) | DefaultRecordForm |
创建内容
<ObjectDir>/Forms/
├── <FormName>.xml # 表单元数据(UUID)
└── <FormName>/
└── Ext/
├── Form.xml # 表单描述(logform命名空间)
└── Form/
└── Module.bsl # BSL模块,含5个区域 + ПриСозданииНаСервере
修改内容
<ObjectPath>— 在ChildObjects中添加<Form>(在<Template>或<TabularSection>之前),更新Default*Form(如果为空则自动更新,或通过--set-default显式更新)
支持的对象类型
文档、目录、数据处理器、报表、外部数据处理器、外部报表、信息寄存器、会计科目表、特性类型表、交换计划、业务流程、任务
示例
# 文档表单
/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
工作流程
/form-add— 创建表单框架/form-compile或/form-edit— 填充Form.xml元素/form-validate— 检查正确性/form-info— 分析结果