# 子表格控件 ## 基本信息 | 属性 | 值 | |------|-----| | jnpfKey | `table` | | AIBridge builder | `build_table_field_model()` | | 源码示例 | `extend/tableDemo/` 多种模式 | | workSystem 示例 | 水电费用、报价信息、个人信息、采购合同 等 | ## 基本规则 ### 核心概念 子表格是一种**嵌套表格**,用于在主表单中管理多条明细数据。 ### 关键配置 | 配置 | 说明 | 必填 | |------|------|------| | child_table_name | 子表物理表名 | 是 | | children | 子表字段列表 | 是 | | show_summary | 是否显示汇总 | 否 | | summary_field | 汇总字段 | 否 | | addTableConf | 新增弹窗配置 | 否 | | footerBtnsList | 底部按钮 | 否 | | columnBtnsList | 列按钮 | 否 | ### AIBridge 使用 ```python from aibridge.builders.field_model import build_table_field_model, build_field_model # 创建子表格 table = build_table_field_model( label="订单明细", vmodel="f_order_detail_list", child_table_name="ord_order_detail", children=[ build_field_model("商品名称", "f_product_name", "input"), build_field_model("规格型号", "f_spec", "input"), build_field_model("单位", "f_unit", "select", options=[ {"fullName": "个", "id": "个"}, {"fullName": "件", "id": "件"}, {"fullName": "台", "id": "台"}, ]), build_field_model("数量", "f_quantity", "inputNumber"), build_field_model("单价", "f_unit_price", "inputNumber"), build_field_model("金额", "f_amount", "inputNumber"), # 可能用于汇总 ], render_key=0, show_summary=True, # 显示汇总行 summary_field="f_amount" # 汇总字段 ) ``` ### 子表格字段配置 子表格内的字段需要额外配置: ```python # 子表字段会自动设置 isSubTable 属性 # 但需要注意 parentVModel 和 relationTable child_fields = [ build_field_model("商品名称", "f_product_name", "input"), build_field_model("数量", "f_quantity", "inputNumber"), ] ``` --- ## workSystem 示例 | 表单名称 | 表单ID | 子表配置 | |----------|--------|----------| | 水电费用 | 585110234985398597 | calculate + table, 自动计算 | | 报价信息 | 585107422926864709 | table, 商品明细 | | 个人信息 | 585101489710563653 | table, 教育经历等 | | 采购合同 | 585077579715707205 | table + calculate, 合同明细+金额计算 | | 高级控件和默认查询 | 469499301635095045 | table, 默认查询条件 | | 订单示例 | 469133201755925637 | table, 订单明细 | | 采购管理 | 469106304141552773 | table + uploadFile, 采购明细+附件 | | 客户管理 | 469102214628043141 | table, 客户联系人 | | OKR管理 | 469059874144184709 | table, KR明细 | | 报名管理外链 | 468848215723140933 | table, 报名信息 | | 应收费用 | 468826463014018501 | table, 费用明细 | | 产品管理 | 469039386000943493 | table + modifyTime, 产品明细 | --- ## 高级配置 ### 表格网格 (tableGrid) 一种特殊的子表格布局,支持主子表头。 ```json { "__config__": { "jnpfKey": "tableGrid", "label": "费用明细", "tag": "JnpfTableGrid" }, "children": [ { "title": "项目", "children": [ {"title": "名称", "dataIndex": "f_item_name"}, {"title": "编码", "dataIndex": "f_item_code"} ] }, { "title": "金额", "children": [ {"title": "预算", "dataIndex": "f_budget"}, {"title": "实际", "dataIndex": "f_actual"} ] } ] } ``` workSystem 示例: 复杂表头(主子表)示例 (469496902811974149) ### 汇总行配置 ```python # 汇总配置 table = build_table_field_model( label="订单明细", vmodel="f_order_detail_list", child_table_name="ord_order_detail", children=[...], show_summary=True, summary_field="f_amount" ) ``` ### 新增弹窗配置 (addTableConf) ```python # 暂不支持,需手动配置 add_config = { "popupTitle": "新增明细", "popupWidth": "60%", "columnCount": 2 # 弹窗内字段排版 } ``` --- ## 表格类型对比 | 类型 | jnpfKey | 说明 | workSystem | |------|---------|------|------------| | 子表格 | table | 嵌套表格 | #25, #26, #27 | | 表格网格 | tableGrid | 复杂表头主子表 | #35 | --- ## 常见问题 | 问题 | 原因 | 解决 | |------|------|------| | 子表数据保存失败 | isSubTable 未设置 | 子表字段必须使用 build_table_field_model | | 汇总不显示 | show_summary 未设 | `show_summary=True` | | 汇总字段不对 | summary_field 错误 | 确认汇总字段名 | | 弹窗新增失败 | addTableConf 缺失 | 需要配置弹窗属性 | --- ## 数据存储规律 ### 子表格存储规律 子表格(table)的数据存储在**独立的物理表**中,而非主表。 ### 存储机制 1. **主表字段**:存储子表的外键关联(主键ID) 2. **子表字段**:存储在独立的物理表中,通过 `f_flow_task_id` 或 `f_id` 关联 ### 子表数据结构 ```json // 主表存储 { "f_id": "主表记录ID", "f_order_no": "SO20260407001", "f_order_detail_list": "811298790165190697" // 子表关联ID } // 子表(ord_order_detail)存储 { "f_id": "子表记录ID", "f_flow_task_id": "811298790165190697", // 关联主表 "f_product_name": "产品A", "f_quantity": 10, "f_unit_price": 99.00 } ``` ### 子表字段存储 子表内字段的存储与其他控件相同: | 子表字段 | 存储类型 | 示例 | |---------|---------|------| | input | 字符串 | `"产品名称"` | | textarea | 字符串 | `"备注信息"` | | inputNumber | 数值/字符串 | `99.00` 或 `"99.00"` | | select/radio | 字符串 | `"1"` | | checkbox | JSON数组 | `["1","3"]` | ### 数据库表结构要求 子表需要创建独立的物理表,表结构示例: ```sql CREATE TABLE ord_order_detail ( f_id VARCHAR(50) PRIMARY KEY, -- 主键(雪花ID) f_flow_task_id VARCHAR(50), -- 关联主表的flow_task_id f_product_name VARCHAR(200), -- 商品名称 f_spec VARCHAR(100), -- 规格型号 f_unit VARCHAR(20), -- 单位 f_quantity DECIMAL(18,2), -- 数量 f_unit_price DECIMAL(18,2), -- 单价 f_amount DECIMAL(18,2), -- 金额 -- 系统字段 f_create_user VARCHAR(50), f_create_time DATETIME, f_modify_user VARCHAR(50), f_modify_time DATETIME ); ``` ### 重要配置 | 配置 | 说明 | 必填 | |------|------|------| | child_table_name | 子表物理表名(snake_case) | 是 | | children | 子表字段列表 | 是 | | is_sub_table | 标记为子表字段 | 自动设置 | | show_summary | 是否显示汇总行 | 否 | | summary_field | 汇总字段名 | 否 | --- ## 下一步 - [特殊控件](08-special-controls.md) - [图表控件](09-chart-controls.md) - [表格高级模式](10-table-patterns.md)