NC 开发指南
NC 开发指南
iii
目录
1. 基础知识 ........................................................................................................................................ 1
1. 快速入门 ............................................................................................................................... 1
1.1. NC6.1 产品安装详解 ............................................................................................... 1
1.1.1. 建立标准数据库结构 .................................................................................. 1
1.1.2. 为 NC 建立数据库用户 .............................................................................. 1
1.1.3. 安装代码 ...................................................................................................... 3
1.1.4. 配置数据源连接并部署 .............................................................................. 9
1.1.5. 建立账套 .................................................................................................... 14
1.2. 环境搭建 ................................................................................................................ 15
1.2.1. 安装 Eclipse ............................................................................................... 15
1.2.2. 数据库工具的连接配置 ............................................................................ 15
1.3. 第一个应用 HelloNC ............................................................................................. 23
1.3.1. 新建 NC 项目 ............................................................................................ 23
1.3.2. 编写一个后台服务 .................................................................................... 27
1.3.3. 通过 upm 文件注册服务 ........................................................................... 28
1.3.4. 从开发环境运行 NC ................................................................................. 29
1.3.5. 节点注册 .................................................................................................... 30
1.3.6. 在打开节点时调用后台服务获取字符串,并显示在界面上 ................ 36
1.3.7. 总结 ............................................................................................................ 38
2. 业务元数据 ......................................................................................................................... 38
2.1. 元数据介绍 ............................................................................................................ 38
2.2. 实体组件 ................................................................................................................ 39
2.3. 操作组件 ................................................................................................................ 44
3. 持久化框架 ......................................................................................................................... 45
3.1. 简介 ........................................................................................................................ 45
3.2. 使用方法 ................................................................................................................ 45
3.2.1. JdbcSession 的创建: ............................................................................... 46
3.2.2. 数据访问异常的处理 ................................................................................ 46
3.2.3. 查询的实现 ................................................................................................ 46
3.2.4. 结果集合的处理 ........................................................................................ 47
3.2.5. 更新的实现 ................................................................................................ 48
3.2.6. 批量更新 .................................................................................................... 48
3.2.7. JdbcSession 中特殊参数类型 ................................................................... 49
4. 模板 ..................................................................................................................................... 50
4.1. 单据模板 ................................................................................................................ 50
4.1.1. 单据模板介绍 ............................................................................................ 50
4.1.2. 单据模板的定义 ........................................................................................ 50
4.1.3. 单据模板公式设置 .................................................................................... 54
4.2. 查询模板 ................................................................................................................ 57
4.2.1. 概述 ............................................................................................................ 57
4.2.2. 制作查询模板 ............................................................................................ 57
4.2.3. 查询方案 .................................................................................................... 59
4.2.4. 查询 ............................................................................................................ 59
4.2.5. 深入应用 .................................................................................................... 61
4.3. 输出模板 ................................................................................................................ 62
4.3.1. 前言 ............................................................................................................ 62
4.3.2. 概述 ............................................................................................................ 62
4.3.3. 原理 ............................................................................................................ 63
4.3.4. 基本概念 .................................................................................................... 65
NC 开发指南
iv
4.3.5. 制作 ............................................................................................................ 68
4.3.6. 使用 ............................................................................................................ 69
4.3.7. 高阶 ............................................................................................................ 71
5. UI 开发框架 ........................................................................................................................ 71
5.1. UI 工厂 II 原理简介 ............................................................................................... 71
5.1.1. 主要解决的问题 ........................................................................................ 71
5.2. 标准配置文件详解 ................................................................................................ 83
5.2.1. 概述 ............................................................................................................ 83
5.2.2. 主子表 ........................................................................................................ 83
5.2.3. 主子表节点初始化 .................................................................................... 83
5.2.4. 编写主子表节点 xml 步骤 ........................................................................ 84
5.2.5. 单表 ............................................................................................................ 91
5.3. ACTION 详解 ........................................................................................................ 93
5.3.1. 概述 ............................................................................................................ 93
5.3.2. Action 的通用使用方法介绍 .................................................................... 93
5.4. UI 事件框架 ......................................................................................................... 109
5.5. 后台业务规则框架 .............................................................................................. 110
6. 流程平台 ............................................................................................................................ 111
6.1. 单据类型注册 ....................................................................................................... 111
6.2. 交易类型注册 ...................................................................................................... 113
6.3. 审批流支持 .......................................................................................................... 114
6.3.1. 审批流配置 .............................................................................................. 114
6.3.2. 审批、弃审、收回 .................................................................................. 116
6.3.3. 后台动作脚本 .......................................................................................... 118
6.3.4. 待审批查询条件的处理 .......................................................................... 120
6.3.5. 联查审批流状态 ...................................................................................... 120
6.4. 业务流支持 .......................................................................................................... 121
6.4.1. VO 对照 ................................................................................................... 121
6.4.2. 保存时业务流程的确定 .......................................................................... 121
6.4.3. 拉单 UI 实现 ............................................................................................ 121
6.4.4. 如何查询当前业务流程 .......................................................................... 125
6.4.5. 转单开发步骤 .......................................................................................... 125
6.4.6. 上下游接口对应关系查询 ...................................................................... 125
6.4.7. V6.1 流程验证最佳实践 ......................................................................... 126
7. 报表平台 ........................................................................................................................... 142
7.1. 语义模型的使用 .................................................................................................. 142
7.2. 自由报表的新建 .................................................................................................. 146
7.3. 自由报表格式设计 .............................................................................................. 149
8. 规范 ................................................................................................................................... 150
8.1. 数据库设计强制规范 .......................................................................................... 150
8.1.1. 统一要求规范 .......................................................................................... 150
8.1.2. 业务数据字段命名规范 .......................................................................... 151
8.1.3. 数量、单价、金额的字段命名 .............................................................. 152
8.2. 元数据/数据库设计推荐原则 ............................................................................. 155
8.2.1. UAP 统一推荐 ......................................................................................... 155
8.2.2. 业务元数据命名规范 .............................................................................. 155
8.2.3. 元数据模型的数据项 .............................................................................. 156
8.3. 命名空间规范 ...................................................................................................... 157
8.4. 代码注释规范 ...................................................................................................... 161
8.4.1. 问题 .......................................................................................................... 161
8.4.2. 意义 .......................................................................................................... 161
8.4.3. javadoc 标记 ............................................................................................ 162
8.4.4. HTML 标签 ............................................................................................. 162
NC 开发指南
v
8.4.5. JAVA 注释 ................................................................................................ 162
8.5. 日志规范 .............................................................................................................. 166
2. 档案开发详解 ............................................................................................................................ 167
1. 设计元数据 ....................................................................................................................... 167
1.1. 元数据 .................................................................................................................. 167
2. 自动产生代码 ................................................................................................................... 169
3. 创建界面 ........................................................................................................................... 169
3.1. 基本档案单据模板创建通用步骤 ...................................................................... 169
3.2. 列表界面(以币种为例):必须有表体 ............................................................ 171
3.3. 卡片界面(以人员为例):必须有表头 ............................................................ 171
4. 创建查询模板 ................................................................................................................... 173
5. 创建打印模板 ................................................................................................................... 175
5.1. 第一种方式 .......................................................................................................... 175
5.2. 第二种方式 .......................................................................................................... 179
6. 编写服务接口和实现 ....................................................................................................... 183
6.1. 编写服务接口 ...................................................................................................... 183
6.2. 添加接口实现 ...................................................................................................... 184
6.3. 添加 upm 文件注册后台服务 ............................................................................. 185
7. 编写配置文件 ................................................................................................................... 185
7.1. 列表型配置范文 .................................................................................................. 186
7.2. 管理型配置范文 .................................................................................................. 188
7.3. 树管理型配置范文 .............................................................................................. 189
7.4. 树卡型配置范文 .................................................................................................. 191
8. 注册功能节点 ................................................................................................................... 193
9. 完善个性化需求 ............................................................................................................... 204
10. 自定义档案的创建 ......................................................................................................... 204
10.1. 术语介绍 ............................................................................................................ 204
10.2. 使用说明 ............................................................................................................ 204
10.2.1. 自定义档案定义 .................................................................................... 204
10.2.2. 自定义档案定义界面 ............................................................................ 204
10.2.3. 将自定义档案发布为独立结点 ............................................................ 205
10.2.4. 导出元数据文件及脚本 ........................................................................ 207
3. 单据开发详解 ............................................................................................................................ 209
1. 销售订单维护节点主要功能介绍 ................................................................................... 209
2. 销售订单的基本配置 ....................................................................................................... 209
3. 销售订单维护节点查询配置 ........................................................................................... 216
4. 配置显示客户信用、客户预收款、存量区域 ............................................................... 218
5. 界面按钮浏览态、编辑态 ............................................................................................... 221
6. 业务活动 ........................................................................................................................... 224
7. 单价金额工具适配 ........................................................................................................... 227
8. 精度工具适配 ................................................................................................................... 229
9. 单据联查、单据追溯的使用 ........................................................................................... 233
10. 懒加载的使用 ................................................................................................................. 237
11. 上游单据参照制单 ......................................................................................................... 242
4. 报表开发详解 ............................................................................................................................ 245
1. 基本功能 ........................................................................................................................... 245
1.1. 可扩展区域管理 .................................................................................................. 245
1.2. 排序 ...................................................................................................................... 248
1.3. 筛选 ...................................................................................................................... 251
1.4. 页维度 .................................................................................................................. 253
1.5. 固定成员 .............................................................................................................. 266
1.6. 分组 ...................................................................................................................... 269
1.7. 统计 ...................................................................................................................... 271