NC单据开发初学者手册.doc
文本预览下载声明
NC单据开发初学者手册
编写者：NC-UAP
薄奇 赖宏伟
用友软件股份有限公司
二零零六年四月
目 录
第一章 概述 1
1.1 基本概念 1
1.2 单据开发主要流程 1
第二章 搭建开发环境 1
2.1 本文软件开发环境 1
2.2 给PD打补丁 1
2.3 建立数据库 1
2.4 建立开发工程 2
第三章 数据库表pdm及SQL脚本的生成 3
3.1 数据模型 3
3.2 生成pdm步骤 3
3.3 生成SQL脚本步骤 7
第四章 生成数据字典 11
4.1 步骤 11
第五章 生成VO 15
5.1 准备工作 15
5.2 生成VO 18
第六章 第一个单据 20
6.3 步骤一、建立单据模板 20
6.4 步骤二、建立工程包结构 25
6.5 步骤三、定制界面控制类 25
6.6 步骤四、定制界面UI类 26
6.7 步骤四、连接模板到NC集成辅助开发工具中查看效果 26
第七章 参照 28
7.3 什么是参照 28
7.4 建立参照类 28
7.5 在单据模板上设置参照 29
第八章 单据模板中的公式使用 33
8.1 什么是公式 33
8.2 给单据模板设置公式 33
第九章 参考文献 36
概述
基本概念
单据：比如报销时的报销单，一般由表头和表体组成（有些时候还含有表尾）。表头中包含了单据的主信息，比如日期、部门、预算项目；表体包含了单据的明细信息，比如具体的事项和金额；
单据类型：一个业务系统为了使结构更清晰，通常也是分层的。比如，供应链系统包含了采购、库存等子系统，每个子系统都具有一个系统类型，而每个子系统都会具有很多张单据，为了区分这些单据，为每张单据命名一个单据类型，作为唯一标识；
模板：单据开发涉及到三大模板（单据模板、查询模板、打印模板）。单据模板定义了单据的显示外观和基本框架，查询模板定义了单据的查询对话框，打印模板定义了单据信息打印到打印机的样式和格式；
VO：值对象，用作传输数据的载体
聚合VO：单据一般由表头和表体构成，因此单据的数据表通常设计成主表和子表。聚合VO是对单据数据的抽象，它用于装载主表VO和一组子表VO.；
UI工厂：虽然能通过三大模板定义出单据的显示，但每张单据都有一些公共的或特殊的行为。UI工厂是一种单据开发框架，它将常用单据抽象成了很多类型，因此，UI工厂相当于是单据开发的代码模板，预置了单据的各种公共行为，比如增、删、改、查，并且可以连接到NC流程平台，支持审批、单据驱动等应用。
单据开发主要流程
NC平台对开发过程进行很多抽象和封装，使得单据开发变得非常容易。一般地，开发环境中，开发一个单据主要包括以下步骤：
第一步、PowerDesigner中建立单据的物理模型（数据库表），保存成pdm文件(xml)；
第二步、利用PowerDesigner生成单据的建表脚本(SQL语句)，在数据库中执行此脚本建立数据库表结构；
第三步、利用NC集成辅助工具中的数据字典生成工具导入pdm文件，生成相应的数据字典；
第四步、利用NC集成辅助工具中的CodeSeedVO工具利用odbc连接数据库，将单据涉及的数据表生成VO对象；
第五步、以UI工厂为基础，应用Template模式，编写自己的单据类。
下面，我们以一个简单的员工信息管理系统分别介绍这几个步骤。
搭建开发环境
本文软件开发环境
1、操作系统：Windows 2000 Server
2、数据库设计工具：Sybase PowerDesigner Version 9.5.0.648（以下简称PD）
为了给数据表自动生成时间戳(ts)、删除标志(dr)字段，需给PD打上插件补丁：db2cs7.xdb，oracl8i2.xdb，sqlserv7.xdb
3、数据库：MS SQL Server 2000
4、开发工具：Eclipse 3.1.1
给PD打补丁
将三个补丁文件全部拷贝到PD的安装目录的 Resource Files\DBMS 下即可
建立数据库
因为NC本身使用了很多数据库表，所以我们建立的数据库中必须包含NC系统表和其中的某些数据，而不是简单新建库。本文以SQL Server 2000为例。
第一步、建立数据库v5test
第二步、在v5test数据库名上右键选择导入数据，根据其它已经建好的库来生成库。或者根据数据库的备份和还原操作来建库。
这样，我们就建立起包含NC系统表的数据库，在此基础上，我们建立自己的数据表进行开发。
建立开发工程
现在已经存在NC_UAP_UIFactory工程，其中包含了部分UI工厂源码和依赖的jar包，依此工程建立我们自己的eclipse工程。
第一步、打开eclipse，新建java工程（在V5中
显示全部