NCV6.3-数据导入技术红皮书分析报告.doc

数据导入技术红皮书 NC-UAP 63 用友NC-UAP 2013-01-31目 录 目 录 1 第一章 前 言 2 第二章 数据导入功能总体设计 3 2.1 数据导入用例图 3 2.2 数据导入的前台界面类图 4 2.3 术语定义 5 2.3.1 格式文件 5 2.3.2 导入 5 2.4数据导入的设计思路 5 第三章 实现数据导入节点开发流程 7 3.1 接口介绍 7 3.2 导出格式文件 8 3.2.1 档案（或单据）界面使用了单据模板 9 3.2.2 档案（或单据）界面没有使用单据模板 9 3.2.3 特殊情况的处理 10 3.2.4 格式文件中填写数据的约束 13 3.3 导入 15 3.3.1导入操作所使用的方法 15 3.3.2 导入工具处理数据流程 16 3.3.3 具体方法的实现细节 16 3.4 档案注册和界面加载 27 3.4.1 档案注册到数据导入工具中 27 3.4.2 数据导入工具对档案界面加载 28 3.4.3 虚拟档案的注册 28 3.5 新UI框架所做档案的开发流程 29 第四章 节点级导入导出功能的实现 31 第五章 附录JAVA DOC 33 4.1 InputItemCreator类 33 4.2 InputItemGenerator类 33 4.3 DefInputItemGenerator类 35 4.4 Conversion类 37 4.5 VOConvertor类 37 第一章 前 言 目前NC系统的很多档案（或单据）录入数据的方式一般是手工一条条的在界面上输入然后保存到数据库，如果遇到了稍微多一些的数据，用户必须重复完成同一个操作，这样使得用户会把大量的时间和精力放在导入过程上，这种导入方式效率很低，也违反了软件可以消除人类重复劳动的基本理念。 为了使实施人员、测试人员和用户能够提高数据录入的效率，从NC5.5开始特增加了数据导入功能。通过该功能可以实现数据的批量录入，用户只需用事先准备好的数据文件进行导入而不必像原来那样重复的在界面输入和保存。在批量导入期间，用户完全可以去做其他事情，只要最后来查看导入日志就可以知道数据导入的详细情况。如果有出错的数据未能保存到数据库，可以根据日志中的错误信息修改该数据后进行二次导入，这样就可以节省大量手工录入的时间。目前的可支持的数据文件格式为Microsoft Office Excel的CSV格式，xlsx文件，xls文件 第二章 数据导入功能总体设计 数据导入功能的展现形式是一个单独的功能结点（数据导入），作为一个工具来使用，凡是可导入的档案（或单据）都可以注册到该工具中（其UI类必须先实现相应接口），然后通过该工具对档案（或单据）进行数据导入操作。 2.1 数据导入用例图 2.2 数据导入的前台界面类图 nc.ui.trade.excelimport.ExcelImportUI类是导入工具的入口类。该类中有一个ToftPanel用来引用待导入档案（或单据）的UI类对象，也就是说所有需要数据导入的档案（或单据）的UI类都必须是ToftPanel的子类。在绘制档案（或单据）的界面时实际上是创建了一个档案（或单据）UI类对象，默认调用的是无参构造方法，所以这些档案（或单据）的UI类需要提供无参构造方法，否则会有异常。（在该工具界面展现的待导入档案（或单据）的界面是没有按钮的，并且去除了其所有的界面事件监听器。） 2.3 术语定义 2.3.1 格式文件 根据待导入的档案（或单据）而生成对应的excel格式文件，这个excel格式文件设定了数据的录入格式，用来存储待导入的数据。可以自定义设定档案（或单据）的格式文件中的输入项，但是基本格式是不能变的。输入项包括必输项和非必输项，必输项是会被自动强制选择的，而非必输项可以自定义设置。 2.3.2 导入 通过解析格式文件中的数据，将这些数据保存到数据库中，导入过程中如果出现保存异常会有提示信息，导入结束之后会有日志。 2.4数据导入的设计思路 1，所有需要数据导入功能的档案（或单据）的UI类（即结点入口类）必须实现nc.itf.trade.excelimport.IImportableEditor接口。 2，通过输出的格式文件规范导入数据的格式，以便于进行数据的转换（即通信协议是底层程序已经确定的）。IImportableEditor接口中的getInputItems方法用来返回档案（或单据）的所有输入项列表。 3，将格式文件中的数据解析后传到数据导入器中，数据导入器回调该数据所属档案（或单据）的UI类中所实现IImportableEditor的getImportableInfo方法来判断当前档案