NC客户化开发全书(第三版)

第一篇 入门篇 7 1. 搭建NC环境 7 1.1. 内容概述 7 1.2. 详细介绍 8 1.2.1. 建立数据库 8 1.2.2. 安装NC 8 1.2.3. 配置启动NC 12 1.2.4. Eclipse中建立NC开发环境 17 1.2.5. 产品参数，档案初始化 23 1.2.6. 权限管理 25 1.2.7. 产品主要目录结构介绍 27 2. NC基础技术 28 2.1. 内容概述 28 2.2. 详细介绍 28 2.2.1. NC开发基本概念 28 2.2.2. NC UAP 总体介绍 30 2.2.3. NC的开发模型 35 2.2.4. 开发远程接口 37 2.2.4.1. 定义接口 37 2.2.4.2. 实现该接口 37 2.2.4.3. 部署组件 37 2.2.4.4. 客户端调用 38 2.2.4.5. 事务型组件发布 38 2.2.4.6. 客户端代码 40 3. NC数据库持久化技术 41 3.1. 内容概述 41 3.2. 详细介绍 42 3.2.1. 核心类介绍 42 3.2.2. 通过JDBC FrameWork访问数据库 42 3.2.3. 通过BaseDao进行对象的持久化 44 3.2.4. 结果集合操作 45 3.2.5. 结果集控制 46 第二篇 中级篇 48 4. 元数据建模 48 4.1. 内容概述 48 4.2. 详细介绍 48 4.2.1. 新建元数据模型 48 4.2.2. 建立模型文件 49 4.2.3. 建立数据实体 49 4.2.4. 发布元数据 59 4.2.5. 导出JAVA源代码 60 4.2.6. 生成SQL脚本并执行 60 4.2.7. 最终成果 61 5. 功能建模 62 5.1. 内容概述 62 5.2. 详细介绍 62 5.2.1. 进入Workshop 62 5.2.2. 表单开发流程导航工具 65 5.2.2.1. 新建业务组件 65 5.2.2.2. 公共信息设置 66 5.2.2.3. 单据模板设置 66 5.2.2.4. 查询模板设置 69 5.2.2.5. 配置打印模板 70 5.2.2.6. 建立单据类型 71 5.2.2.7. 单据动作编辑 71 5.2.2.8. 单据动作脚本设置 73 5.2.2.9. 单据VO交换 73 5.2.2.10. 单据号设置 74 5.2.2.11. 自定义按钮设置 75 5.2.2.12. UI组装 75 5.2.2.13. 发布UI 76 5.2.2.14. 生成代码到本地 76 5.2.3. 权限分配 78 6. 单据开发技术 78 6.1. 内容概述 78 6.2. 详细介绍 78 6.2.1. UI工厂 78 6.2.1.1. UI工厂结构图 79 6.2.1.2. UI工厂最基础类说明 79 6.2.1.3. 单据模型介绍 81 6.2.1.4. 界面加载 81 6.2.1.5. 事件处理 82 6.2.2. 参照开发 83 6.2.2.1. 参照的类结构图 83 6.2.2.2. 自定义参照开发规范 83 6.2.2.3. UIRefPane 和refModle设置 86 6.2.3. 单据号 87 6.2.3.1. 单据号规则 87 6.2.3.2. 接口方法 89 6.2.4. 公式 91 6.2.4.1. 常用公式 91 6.2.4.2. 创建公式执行器 92 6.2.4.3. 设置公式执行器环境 93 6.2.4.4. 设置公式的值 93 6.2.4.5. 对公式进行语法检查 94 6.2.4.6. 提取公式变量 95 6.2.4.7. 给公式变量赋值 95 6.2.4.8. 取公式的值 96 6.2.5. 锁 96 6.2.6. 日志 98 6.2.6.1. 日志API的选择 99 6.2.6.2. 日志级别的选择 100 6.2.7. 异常 100 第三篇 高级篇 101 7. 流程平台 102 7.1. 内容概述 102 7.2. 详细介绍 102 7.2.1. 流程平台介绍 102 7.2.2. 业务流程 104 7.2.2.1. 建立数据交换 104 7.2.2.2. 建立业务类型 109 7.2.2.3. 单据动作配置（推式流程配置） 109 7.2.2.4. 流程配置 110 7.2.2.5. 单据来源配置（拉式流程配置） 110 7.2.2.6. 动作约束配置 112 7.2.2.7. 动作事件控制配置 113 7.2.2.8. 动作驱动配置（推式流程配置） 114 7.2.2.9. 其他工作 115 7.2.2.10. 推式流程过程 116 7.2.2.11. 拉式单据过程（单据的上下游参照） 116 7.2.3. 审批流 118 7.2.3.1. 审批流定义 118 7.2.3.2. 流程模型 120 7.2.3.3. 消息配置（Message Config） 121 7.2.3.4. 工作项的审批结果 122 7.2.3.5. 相关平台类介绍 123 7.2.3.6. 动作处理时序图 124 7.2.3.7. UI端调用-PfUtilClient 124 1． 判断是否进行动作前提示 125 7.2.3.8. BS端调用 125 1． 单据动作处理 125 7.2.4. 消息中心 130 7.2.4.1. 展现样式 131 7.2.4.2. 消息类型 133 8. 查询引擎 134 8.1. 内容概述 134 8.2. 详细介绍 134 8.2.1. 进入查询引擎管理页面 134 8.2.2. 创建查询对象 134 8.2.3. 设置报表参数 135 8.2.4. 制作查询定义 136 8.2.5. 查询格式设计 138 9. 预警平台 141 9.1. 内容概述 141 9.2. 详细介绍 141 9.2.1. 预警类型注册 141 9.2.2. 预警条目注册 143 10. 交换平台 148 10.1. 内容概述 148 10.2. 详细介绍 148 10.2.1. 交换平台使用 148 10.2.1.1. 注册外部系统 149 10.2.1.2. 准备外系统数据 150 10.2.1.3. 配置辅助信息（可选） 151 10.2.1.4. 设置基础数据对照（可选） 151 10.2.1.5. 配置Servlet的URL地址 152 10.2.1.6. 利用客户端发送数据 152 11. 会计平台 154 11.1. 内容概述 154 11.2. 详细介绍 155 11.2.1. 会计平台注册 156 11.2.2. 代码调用 160 12. 单点登陆 162 12.1. 内容概述 162 12.2. 详细介绍 163 12.2.1. 单点登陆 163 12.2.2. 打开代办事项 165 13. NC开发webservice 167 13.1. 内容概述 167 13.2. 详细介绍 167 13.2.1. 发布服务 167 13.2.1.1. 创建WSDL文件 168 13.2.1.2. 创建XSD文件 169 13.2.1.3. 配置UPM文件 170 13.2.2. 客户端调用 176 13.2.2.1. 创建相关JAVA类文件 176 13.2.2.2. 创建JAVA接口 177 13.2.2.3. 测试用例 178 第四篇 附录 182 14. XML和EXCEL 182 14.1. 内容概述 182 14.2. 详细介绍 182 14.2.1. 利用XmlUtils读取XML 182 14.2.2. Excel文件读写 188 15. 多语言 189 15.1. 内容概述 189 15.2. 详细介绍 189 15.2.1. 生成资源文件 190 15.2.2. 代码调用 190 16. 补丁与安装盘 191 16.1. 内容概述 191 16.2. 详细介绍 191 16.2.1. 安装盘结构 191 16.2.2. 产品结构 191 16.2.3. 模块结构 192 16.2.4. 制作补丁 194 17. 设计开发规范 197 17.1. 内容概述 197 17.2. 详细介绍 197 17.2.1. SQL规范 197 17.2.1.1. 概述 197 17.2.1.2. 书写风格 197 17.2.1.3. 性能优化 198 17.2.1.4. 四、多数据库的考虑 199 17.2.2. JAVA开发规范 201 17.2.2.1. 文件 201 17.2.2.2. 命名规则 202 17.2.2.3. 注释规范 206 17.2.2.4. 编码规范 211 18. 开发常见问题与技巧 215 18.1. 内容概述 215 18.2. 详细介绍 215 18.2.1. 环境变量类 nc.ui.pub.ClientEnvironment 215 18.2.2. UAP发送待办消息方法 217 18.2.3. 模板中下拉框的值 218 18.2.4. 数据权限过滤 218 19. 技术红皮书 221 19.1. 内容概述 221 19.2. 详细介绍 221 19.2.1. 技术红皮书目录 221 ### NC客户化开发全书(第三版)知识点总结 #### 第一篇：入门篇 ##### 1. 搭建NC环境 **1.1. 内容概述** 本章介绍了如何搭建一个完整的NC开发环境，包括数据库的建立、NC软件的安装及配置等。 **1.2. 详细介绍** **1.2.1. 建立数据库** - **步骤一**：选择合适的数据库管理系统，如Oracle或MySQL。 - **步骤二**：根据NC提供的数据库脚本，创建数据库和表结构。 **1.2.2. 安装NC** - **步骤一**：下载并解压NC安装包。 - **步骤二**：按照安装向导逐步完成NC服务器的安装。 - **步骤三**：安装完毕后，进行必要的配置调整。 **1.2.3. 配置启动NC** - **步骤一**：配置NC服务器的启动参数。 - **步骤二**：确保数据库连接正确无误。 - **步骤三**：启动NC服务器，并验证是否成功。 **1.2.4. Eclipse中建立NC开发环境** - **步骤一**：安装Eclipse IDE。 - **步骤二**：添加NC插件或SDK支持。 - **步骤三**：配置Eclipse以适应NC开发需求。 **1.2.5. 产品参数，档案初始化** - **步骤一**：设置NC产品的各项参数。 - **步骤二**：导入或手动输入档案数据。 **1.2.6. 权限管理** - **步骤一**：定义用户角色。 - **步骤二**：为不同角色分配不同的访问权限。 - **步骤三**：测试权限设置的有效性。 **1.2.7. 产品主要目录结构介绍** - **步骤一**：了解NC产品的文件夹结构。 - **步骤二**：熟悉各目录下的文件用途。 ##### 2. NC基础技术 **2.1. 内容概述** 本章提供了NC的基础技术概览，涵盖NC的开发框架、开发模型以及远程接口开发等内容。 **2.2. 详细介绍** **2.2.1. NC开发基本概念** - **概念一**：理解NC的核心架构及其组成部分。 - **概念二**：熟悉NC的开发工具和环境。 **2.2.2. NC UAP 总体介绍** - **UAP简介**：了解统一应用平台(UAP)的功能和特点。 - **UAP模块**：分析各个模块的作用和应用场景。 **2.2.3. NC的开发模型** - **开发模型**：介绍NC采用的开发模型。 - **模型优势**：探讨该模型的优势和局限性。 **2.2.4. 开发远程接口** - **定义接口**：定义接口的方法和注意事项。 - **实现接口**：具体实现接口的过程。 - **部署组件**：组件的部署方式。 - **客户端调用**：客户端如何调用远程接口。 - **事务型组件发布**：发布事务型组件的步骤。 - **客户端代码**：示例代码展示。 ##### 3. NC数据库持久化技术 **3.1. 内容概述** 本章介绍了NC数据库持久化的技术细节，包括核心类介绍、通过框架访问数据库等。 **3.2. 详细介绍** **3.2.1. 核心类介绍** - **核心类**：列出并解释核心类的功能。 - **使用场景**：给出每个核心类的典型应用场景。 **3.2.2. 通过JDBC FrameWork访问数据库** - **访问方法**：如何利用JDBC框架进行数据库操作。 - **操作示例**：提供具体的代码示例。 **3.2.3. 通过BaseDao进行对象的持久化** - **对象持久化**：介绍BaseDao类在对象持久化中的作用。 - **示例代码**：给出使用BaseDao的具体实例。 **3.2.4. 结果集合操作** - **操作方式**：介绍如何对结果集进行操作。 - **示例代码**：提供示例代码。 **3.2.5. 结果集控制** - **控制方法**：解释如何控制结果集的返回和处理。 - **代码示例**：给出代码示例。 #### 第二篇：中级篇 ##### 4. 元数据建模 **4.1. 内容概述** 本章涵盖了元数据建模的基础知识，包括模型的创建、数据实体的定义等。 **4.2. 详细介绍** **4.2.1. 新建元数据模型** - **步骤一**：确定元数据模型的需求。 - **步骤二**：创建模型文件。 - **步骤三**：定义数据实体。 **4.2.2. 建立模型文件** - **步骤一**：使用工具或手动创建模型文件。 - **步骤二**：填写必要的元数据信息。 **4.2.3. 建立数据实体** - **步骤一**：定义实体属性。 - **步骤二**：设置实体之间的关系。 **4.2.4. 发布元数据** - **步骤一**：准备发布所需的文件。 - **步骤二**：通过指定的工具或命令发布元数据。 **4.2.5. 导出JAVA源代码** - **步骤一**：选择导出的范围。 - **步骤二**：生成Java源代码。 **4.2.6. 生成SQL脚本并执行** - **步骤一**：生成SQL脚本文件。 - **步骤二**：执行脚本创建数据库表结构。 **4.2.7. 最终成果** - **成果展示**：展示最终的元数据模型和生成的代码。 ##### 5. 功能建模 **5.1. 内容概述** 本章讲解了功能建模的基本流程，包括如何进入开发环境、创建业务组件等。 **5.2. 详细介绍** **5.2.1. 进入Workshop** - **步骤一**：打开Workshop工具。 - **步骤二**：设置项目基本信息。 **5.2.2. 表单开发流程导航工具** - **步骤一**：使用表单开发导航工具。 - **步骤二**：创建新的业务组件。 - **步骤三**：设置组件的基本属性。 **5.2.2.1. 新建业务组件** - **步骤一**：选择组件类型。 - **步骤二**：配置组件的基本信息。 **5.2.2.2. 公共信息设置** - **步骤一**：设置组件的公共信息。 - **步骤二**：定义组件的权限控制。 **5.2.2.3. 单据模板设置** - **步骤一**：设计单据模板布局。 - **步骤二**：配置单据字段属性。 **5.2.2.4. 查询模板设置** - **步骤一**：设计查询界面。 - **步骤二**：设置查询条件和结果展示。 **5.2.2.5. 配置打印模板** - **步骤一**：设计打印模板布局。 - **步骤二**：配置打印样式。 **5.2.2.6. 建立单据类型** - **步骤一**：定义单据类型。 - **步骤二**：关联单据模板。 **5.2.2.7. 单据动作编辑** - **步骤一**：定义单据的操作。 - **步骤二**：设置动作的触发条件。 **5.2.2.8. 单据动作脚本设置** - **步骤一**：编写单据动作脚本。 - **步骤二**：调试脚本逻辑。 **5.2.2.9. 单据VO交换** - **步骤一**：设置单据VO间的交互逻辑。 - **步骤二**：测试VO交换功能。 **5.2.2.10. 单据号设置** - **步骤一**：定义单据编号规则。 - **步骤二**：实现自动编号功能。 **5.2.2.11. 自定义按钮设置** - **步骤一**：定义自定义按钮。 - **步骤二**：设置按钮的显示逻辑。 **5.2.2.12. UI组装** - **步骤一**：组合UI元素。 - **步骤二**：预览UI效果。 **5.2.2.13. 发布UI** - **步骤一**：准备好发布所需的文件。 - **步骤二**：通过指定工具发布UI。 **5.2.2.14. 生成代码到本地** - **步骤一**：选择要生成的代码范围。 - **步骤二**：生成代码并保存到本地。 **5.2.3. 权限分配** - **步骤一**：定义角色。 - **步骤二**：为角色分配权限。 #### 第三篇：高级篇 ##### 7. 流程平台 **7.1. 内容概述** 本章深入探讨了NC的流程平台，包括业务流程的设计与配置、审批流的设置等。 **7.2. 详细介绍** **7.2.1. 流程平台介绍** - **平台介绍**：简述流程平台的功能和优势。 - **平台特点**：分析平台的特点和适用场景。 **7.2.2. 业务流程** - **步骤一**：建立数据交换机制。 - **步骤二**：定义业务类型。 - **步骤三**：配置单据动作和流程。 - **步骤四**：设置动作驱动。 - **步骤五**：定义流程处理过程。 **7.2.3. 审批流** - **步骤一**：定义审批流。 - **步骤二**：配置审批流程模型。 - **步骤三**：设置消息通知。 - **步骤四**：处理审批结果。 后续章节将对查询引擎、预警平台、交换平台等内容进行详细介绍，旨在帮助开发者深入了解NC的各项高级功能和技术细节，提升开发效率和质量。