NC单据开发初学手册V1.0

NC单据开发初学者手册

编写者：王松涛

用友软件股份有限公司

二零一零年七月

- i -

目 录

错误！未找到引用源。

第一章 概述 .................................................................................................................. 1

1.1 基本概念 ................................................................................................... 1 1.2 单据开发主要流程 ................................................................................... 1

第二章 搭建开发环境 .................................................................................................. 1

2.1 开发环境 ................................................................................................... 1 2.2 建立数据库 ............................................................................................... 1 2.3 建立开发工程 ........................................................................................... 1

第三章 数据库pdm和建表 ......................................................................................... 3

3.1 数据模型 ................................................................................................... 3 3.2 生成pdm步骤 .......................................................................................... 3 3.3 给PD打补丁 ............................................................................................ 7 3.4 生成SQL脚本步骤 .................................................................................. 7

第四章 数据库pdm和建表 ......................................................................................... 8

4.1 步骤 ........................................................................................................... 8

第五章 生成VO ......................................................................................................... 12

5.1 VO生成工具使用步骤 ........................................................................... 12 5.2 修改VOMeta类 ..................................................................................... 13

第六章 功能注册和按钮注册 .................................................................................... 15

6.1 功能注册 ................................................................................................. 15

6.1.1步骤 ................................................................................................ 15 6.1.2 功能注册对应数据库表结构 ....................................................... 16 6.2 按钮注册 ................................................................................................. 17 6.3 权限分配 ................................................................................................. 18

第七章 第一个单据 .................................................................................................... 19

7.1步骤一、建立单据模版 .......................................................................... 20

7.1.1单据模板的建立步骤 .................................................................... 20 7.1.2 单据模板涉及的表和表结构 ....................................................... 25 7.2步骤二、建立工程包结构 ...................................................................... 28

- ii -

7.3 步骤三、定制常量类和缓存类 ............................................................. 28

7.3.1 缓存类Model ............................................................................... 28 7.3.2 节点相关常量类 NodeInfo ......................................................... 33 7.4 步骤四、定制界面控制类和面板初始化类 ......................................... 34

7.4.1 定制面板类 ................................................................................... 34 7.4.2 定制控制类 ................................................................................... 35

7.4.2.1 事件处理控制类（EditCtrl） ...................................................................................................... 35 7.4.2.2 面板控制类（CardPanelCtrl / ListPanelCtrl） ............................................................................ 38 7.4.2.3 按钮控制类（ButtonCtrl） .......................................................................................................... 40

7.5 步骤五、定制界面UI类 ....................................................................... 40 7.6 步骤六、定制按钮事件处理类 ............................................................. 41

7.6.1 编写ButtonEventHandler的步骤 ................................................ 41 7.6.2 增加按钮功能 ............................................................................... 44 7.6.3 修改按钮功能 ............................................................................... 44 7.6.4 保存按钮功能 ............................................................................... 45 7.6.5 取消按钮功能 ............................................................................... 45 7.6.6 删除按钮功能 ............................................................................... 45 7.6.7 查询按钮功能 ............................................................................... 45 7.7 步骤七、查看前台效果 ......................................................................... 46 7.8 步骤八、编写后台处理 ......................................................................... 46

7.8.1 编写接口和编写实现类 ............................................................... 46 7.8.2 编写DMO数据库处理类 ........................................................... 48

7.8.2.1 新增保存后台处理 ....................................................................................................................... 48 7.8.2.2 修改保存后台处理 ....................................................................................................................... 48 7.8.2.3 查询后台处理 ............................................................................................................................... 49 7.8.2.4 删除后台处理 ............................................................................................................................... 49

第八章 参照 ................................................................................................................ 49

8.1 什么是参照 ............................................................................................. 49 8.2 建立参照类 ............................................................................................. 49 8.3在单据模板上设置参照 .......................................................................... 50

第九章 单据模板中的公式使用 ................................................................................ 54

1.1 什么是公式 ............................................................................................. 54 1.2 给单据模板设置公式 ............................................................................. 54

- 2 -

第一章

第二章 概述

2.1 基本概念

单据：比如报销时的报销单，一般由表头和表体组成（有些时候还含有表尾）。表头中包含了单据的主信息，比如日期、部门、预算项目；表体包含了单据的明细信息，比如具体的事项和金额；

单据类型：一个业务系统为了使结构更清晰，通常也是分层的。比如，供应链系统包含了采购、库存等子系统，每个子系统都具有一个系统类型，而每个子系统都会具有很多张单据，为了区分这些单据，为每张单据命名一个单据类型，作为唯一标识；

模板：单据开发涉及到三大模板（单据模板、查询模板、打印模板）。单据模板定义了单据的显示外观和基本框架，查询模板定义了单据的查询对话框，打印模板定义了单据信息打印到打印机的样式和格式；

VO：值对象，用作传输数据的载体

聚合VO：单据一般由表头和表体构成，因此单据的数据表通常设计成主表和子表。聚合VO是对单据数据的抽象，它用于装载主表VO和一组子表VO.；

UI工厂：虽然能通过三大模板定义出单据的显示，但每张单据都有一些公共的或特殊的行为。UI工厂是一种单据开发框架，它将常用单据抽象成了很多类型，因此，UI工厂相当于是单据开发的代码模板，预置了单据的各种公共行为，比如增、删、改、查，并且可以连接到NC流程平台，支持审批、单据驱动等应用。

2.2 单据开发主要流程

NC平台对开发过程进行很多抽象和封装，使得单据开发变得非常容易。一般地，开发环境中，开发一个单据主要包括以下步骤：

第一步、PowerDesigner中建立单据的物理模型（数据库表），保存成pdm文件(xml)；

第二步、利用PowerDesigner生成单据的建表脚本(SQL语句)，在数据库中执行此脚本建立数据库表结构；

第三步、利用NC集成辅助工具中的数据字典生成工具导入pdm文件，生

- 1 -