1. NCC UAP平台数据字典概述NCCNew Cloud ComputingUAPUnified Application Platform是用友网络推出的企业级应用开发平台数据字典作为其核心元数据管理组件承担着系统数据结构定义与管理的重任。在大型ERP项目实施过程中数据字典的完整性和准确性直接影响系统配置、二次开发及数据交互的可靠性。典型的数据字典结构包含以下核心字段表名Table_Name物理表名称遵循平台命名规范字段名Field_Name表中列名通常采用驼峰命名法数据类型Data_Type包括VARCHAR/NUMBER/DATE等标准类型长度Length字段存储空间限制是否必填MandatoryY/N标识默认值Default_Value字段初始值设置描述Description业务含义说明2. 数据字典增补的必要性分析2.1 业务场景驱动需求在项目实施中常遇到以下需要增补数据字典的场景定制开发扩展当标准功能无法满足客户特殊业务流程时开发人员需新增自定义表和字段接口字段映射与第三方系统对接时需建立中间表存储转换字段报表分析需求为支持复杂数据分析需添加计算字段或索引字段2.2 技术债务清理系统经过多次迭代后可能出现开发人员直接操作数据库未维护字典临时字段未及时清理字段用途变更未更新注释重要提示未经数据字典登记的字段在平台升级时可能丢失且无法通过标准API访问3. UAP平台数据字典增补实操指南3.1 开发环境准备安装UAP Studio开发工具最新版本建议6.5配置JDK 1.8环境变量获取目标环境的元数据访问权限准备数据库客户端工具如PL/SQL-- 验证元数据表访问权限 SELECT * FROM NCC_METADATA.TABLES WHERE ROWNUM 5;3.2 标准增补流程3.2.1 图形化操作步骤登录UAP Studio打开元数据管理视图右键点击目标模块→新建数据表在属性面板填写表基本信息表编码遵循MODULE_ENTITY命名规范显示名称中文业务名称存储策略选择主表/子表类型添加字段并设置约束条件3.2.2 脚本方式增补对于批量操作建议使用SQL脚本-- 示例添加采购订单扩展表 BEGIN NCC_METADATA.ADD_TABLE( PUR_ORDER_EXT, 采购订单扩展表, PUR, Y, 采购模块自定义扩展字段 ); NCC_METADATA.ADD_FIELD( PUR_ORDER_EXT, contract_photo, 合同扫描件, BLOB, 0, N, NULL, 供应商合同电子存档 ); END;3.3 字段类型选型建议数据类型适用场景注意事项VARCHAR2文本、编码类字段长度需预留20%余量NUMBER金额、数量等计算字段明确精度和标度CLOB大文本超过4000字节不可建立索引BLOB文件、图片存储影响数据库备份效率DATE日期时间建议统一时区处理4. 冲突处理与版本管理4.1 Eclipse插件冲突解决当出现元数据同步冲突时常见于团队开发环境在UAP Studio中右键项目→选择Team→Synchronize冲突文件会显示红色标记使用Merge Tool进行三方对比合并重点检查字段ID、表版本号等关键属性4.2 版本控制策略表结构版本化每次修改需递增VERSION字段变更日志记录维护CHANGE_LOG表记录修改历史基线管理每月导出MD5校验文件作为版本快照// 自动生成版本校验码示例 MessageDigest md MessageDigest.getInstance(MD5); String schemaVersion DigestUtils.md5Hex( tableName fieldList new Date().toString() );5. 数据字典最佳实践5.1 命名规范建议表名使用模块前缀如GL_表示总账布尔字段以IS_/HAS_开头外键字段以ID结尾避免使用数据库保留字5.2 性能优化方案索引策略为查询条件字段创建组合索引CREATE INDEX IDX_PUR_EXT_1 ON PUR_ORDER_EXT(vendor_id, approve_status);分区设计交易类大表按日期分区字段冗余适当冗余高频访问字段5.3 数据字典校验脚本定期运行以下检查脚本可提前发现问题-- 查找未维护描述的字段 SELECT table_name, field_name FROM ncc_metadata.fields WHERE description IS NULL; -- 检测数据类型不匹配的字段 SELECT a.table_name, a.field_name, a.data_type, b.data_type FROM ncc_metadata.fields a JOIN user_tab_columns b ON a.table_name b.table_name AND a.field_name b.column_name WHERE a.data_type ! b.data_type;6. 常见问题排查指南6.1 字段无法持久化现象界面输入的值保存后变为NULL排查步骤检查字段长度是否不足验证NOT NULL约束与界面校验逻辑查看数据库触发器是否修改值6.2 元数据缓存异常现象修改未及时生效解决方案// 前端强制刷新缓存 NCC.refreshMetaCache(模块编码); // 后端清理缓存需要管理员权限 UPDATE NCC_SYS_PARAM SET PARAM_VALUE RELOAD WHERE PARAM_KEY META_CACHE_FLAG;6.3 多语言支持对于国际化项目需维护多语言描述field i18nKeyPUR_ORDER_EXT.contract_photo label langzh_CN合同扫描件/label label langen_USContract Scan/label /field在实际项目实施中我们总结出数据字典维护的三同步原则开发环境与生产环境同步、文档与代码同步、业务变更与技术变更同步。特别是在系统升级前务必进行元数据完整性检查避免因字段缺失导致业务中断。 
长河君 · 2026/10/31 2:41:22 · 阅读 1.2k NCC UAP平台数据字典增补与最佳实践指南
1. NCC UAP平台数据字典概述NCCNew Cloud ComputingUAPUnified Application Platform是用友网络推出的企业级应用开发平台数据字典作为其核心元数据管理组件承担着系统数据结构定义与管理的重任。在大型ERP项目实施过程中数据字典的完整性和准确性直接影响系统配置、二次开发及数据交互的可靠性。典型的数据字典结构包含以下核心字段表名Table_Name物理表名称遵循平台命名规范字段名Field_Name表中列名通常采用驼峰命名法数据类型Data_Type包括VARCHAR/NUMBER/DATE等标准类型长度Length字段存储空间限制是否必填MandatoryY/N标识默认值Default_Value字段初始值设置描述Description业务含义说明2. 数据字典增补的必要性分析2.1 业务场景驱动需求在项目实施中常遇到以下需要增补数据字典的场景定制开发扩展当标准功能无法满足客户特殊业务流程时开发人员需新增自定义表和字段接口字段映射与第三方系统对接时需建立中间表存储转换字段报表分析需求为支持复杂数据分析需添加计算字段或索引字段2.2 技术债务清理系统经过多次迭代后可能出现开发人员直接操作数据库未维护字典临时字段未及时清理字段用途变更未更新注释重要提示未经数据字典登记的字段在平台升级时可能丢失且无法通过标准API访问3. UAP平台数据字典增补实操指南3.1 开发环境准备安装UAP Studio开发工具最新版本建议6.5配置JDK 1.8环境变量获取目标环境的元数据访问权限准备数据库客户端工具如PL/SQL-- 验证元数据表访问权限 SELECT * FROM NCC_METADATA.TABLES WHERE ROWNUM 5;3.2 标准增补流程3.2.1 图形化操作步骤登录UAP Studio打开元数据管理视图右键点击目标模块→新建数据表在属性面板填写表基本信息表编码遵循MODULE_ENTITY命名规范显示名称中文业务名称存储策略选择主表/子表类型添加字段并设置约束条件3.2.2 脚本方式增补对于批量操作建议使用SQL脚本-- 示例添加采购订单扩展表 BEGIN NCC_METADATA.ADD_TABLE( PUR_ORDER_EXT, 采购订单扩展表, PUR, Y, 采购模块自定义扩展字段 ); NCC_METADATA.ADD_FIELD( PUR_ORDER_EXT, contract_photo, 合同扫描件, BLOB, 0, N, NULL, 供应商合同电子存档 ); END;3.3 字段类型选型建议数据类型适用场景注意事项VARCHAR2文本、编码类字段长度需预留20%余量NUMBER金额、数量等计算字段明确精度和标度CLOB大文本超过4000字节不可建立索引BLOB文件、图片存储影响数据库备份效率DATE日期时间建议统一时区处理4. 冲突处理与版本管理4.1 Eclipse插件冲突解决当出现元数据同步冲突时常见于团队开发环境在UAP Studio中右键项目→选择Team→Synchronize冲突文件会显示红色标记使用Merge Tool进行三方对比合并重点检查字段ID、表版本号等关键属性4.2 版本控制策略表结构版本化每次修改需递增VERSION字段变更日志记录维护CHANGE_LOG表记录修改历史基线管理每月导出MD5校验文件作为版本快照// 自动生成版本校验码示例 MessageDigest md MessageDigest.getInstance(MD5); String schemaVersion DigestUtils.md5Hex( tableName fieldList new Date().toString() );5. 数据字典最佳实践5.1 命名规范建议表名使用模块前缀如GL_表示总账布尔字段以IS_/HAS_开头外键字段以ID结尾避免使用数据库保留字5.2 性能优化方案索引策略为查询条件字段创建组合索引CREATE INDEX IDX_PUR_EXT_1 ON PUR_ORDER_EXT(vendor_id, approve_status);分区设计交易类大表按日期分区字段冗余适当冗余高频访问字段5.3 数据字典校验脚本定期运行以下检查脚本可提前发现问题-- 查找未维护描述的字段 SELECT table_name, field_name FROM ncc_metadata.fields WHERE description IS NULL; -- 检测数据类型不匹配的字段 SELECT a.table_name, a.field_name, a.data_type, b.data_type FROM ncc_metadata.fields a JOIN user_tab_columns b ON a.table_name b.table_name AND a.field_name b.column_name WHERE a.data_type ! b.data_type;6. 常见问题排查指南6.1 字段无法持久化现象界面输入的值保存后变为NULL排查步骤检查字段长度是否不足验证NOT NULL约束与界面校验逻辑查看数据库触发器是否修改值6.2 元数据缓存异常现象修改未及时生效解决方案// 前端强制刷新缓存 NCC.refreshMetaCache(模块编码); // 后端清理缓存需要管理员权限 UPDATE NCC_SYS_PARAM SET PARAM_VALUE RELOAD WHERE PARAM_KEY META_CACHE_FLAG;6.3 多语言支持对于国际化项目需维护多语言描述field i18nKeyPUR_ORDER_EXT.contract_photo label langzh_CN合同扫描件/label label langen_USContract Scan/label /field在实际项目实施中我们总结出数据字典维护的三同步原则开发环境与生产环境同步、文档与代码同步、业务变更与技术变更同步。特别是在系统升级前务必进行元数据完整性检查避免因字段缺失导致业务中断。