mcpField
F
form-add

form-add

github.com/nikolay-shirokov开发74152 次安装今天更新
代码仓库

关于 form-add

form-add 是用于为 1C 配置对象创建托管窗体并注册到对象 XML 的技能,面向配置开发者。它按对象类型验证窗体用途,并支持设置窗体同义名和默认窗体。

主要功能

  1. 01生成元数据 XML、Form.xml 和 Module.bsl
  2. 02将窗体注册到对象根 XML
  3. 03按对象类型校验窗体用途
  4. 04设置窗体同义名和默认状态
  5. 05支持外部数据源表格窗体

适用场景

  1. 01为文档或目录对象添加窗体
  2. 02为信息登记簿创建记录窗体
  3. 03为设置存储创建保存或加载窗体

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/nikolay-shirokov/cc-1c-skills --skill form-add

安装后在 Claude Code 中输入/form-add确认已加载。

附带文件scripts/form-add.ps1scripts/form-add.py

详细介绍

/form-add — 向配置对象添加表单

创建托管表单(metadata XML + Form.xml + Module.bsl),并在配置对象的根 XML 中注册该表单(Document、Catalog、InformationRegister 等)。

用法

/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, ChartOfCharacteristicTypesObject, Folder, List, Choice, FolderChoice, Custom
Document, ChartOfAccounts, ChartOfCalculationTypes, ExchangePlan, BusinessProcess, TaskObject, List, Choice, Custom
DataProcessor, Report, ExternalDataProcessor, ExternalReportObject, Custom
InformationRegisterRecord, List, RecordSet, Custom
AccumulationRegister, AccountingRegister, CalculationRegisterList, RecordSet, Custom
DocumentJournal, FilterCriterionList, Custom
EnumList, Choice, Custom
SettingsStorageSave, 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

工作流

  1. /form-add — 创建表单框架
  2. /form-compile 或 /form-edit — 使用元素填充 Form.xml
  3. /form-validate — 检查正确性
  4. /form-info — 分析结果

评论

支持 Markdown