核心用法
本技能提供预算系统的完整数据模型定义,包含68个数据表的详细结构信息。主要服务于三类场景:查询预算相关数据模型结构、编写数据查询脚本、获取特定表的字段信息。
数据模型要素:每个表包含table_id(数据库表名)、table_name(中文别名)、fields(字段列表)。字段信息涵盖field_id(数据库字段名)、field_name(中文别名)、data_type(string/number/integer/datetime/date/array)、length、is_required、is_editable等完整元数据。
查询方式:支持三种数据访问模式——DataModelUtils.getCIByPK单条查询、getCIByAttr多条件查询、以及原生SQL查询。字段访问通过dataFieldMap.字段名方式进行。
显著优点
1. 模型完整性:覆盖预算基础表(主表/版本/公式/科目)、费用预算表(单位成本/成本预算/毛利预算/费用明细)、业务预算表(维修计划/培训计划/附加服务/航材储备)、报表相关表及辅助表,形成完整体系
2. 开发友好:提供Groovy代码示例,包含变量命名规范、字段类型对照表、关联查询指引
3. 场景覆盖:直接响应"预算管理表有哪些字段""某字段在哪个表里"等高频问题
潜在局限
- 数据模型定义存储于references/data_models.json,实际可用性依赖该文件完整性
- 仅提供结构定义,不包含实际业务数据或权限控制说明
- SQL示例中表名使用双引号包裹,需注意目标数据库的方言兼容性
适合人群
- 需要集成预算系统的后端开发人员
- 编写数据迁移或报表脚本的工程师
- 需要理解预算系统数据库结构的技术人员
常规风险
- 字段必填约束(is_required)未在运行时强制校验,依赖调用方保证
- ID字段长度128位的设计需确保生成策略兼容性
- 未提及敏感字段(如金额、客户信息)的脱敏或加密要求