1、此文件受到UFIDA的保護(hù), 并已在保護(hù)中心注冊(cè), 外泄必糾!UFIDA GUID1162153F0-8B62-6E8D-1D46-54499B5A622BUFIDA GUID131C26706-1290-5BDE-DD7D-D594B804C93CNC單據(jù)開發(fā)初學(xué)者手冊(cè)編寫者：NC-UAP 薄奇 賴宏偉用友軟件股份有限公司二零零六年四月目 錄 MACROBUTTON InsertCrossReference TOC o 1-3 h z HYPERLINK l _Toc131819807 第一章 概述 PAGEREF _Toc131819807 h 1 HYPERLINK l _Toc1318

2、19808 1.1 基本概念 PAGEREF _Toc131819808 h 1 HYPERLINK l _Toc131819809 1.2 單據(jù)開發(fā)主要流程 PAGEREF _Toc131819809 h 1 HYPERLINK l _Toc131819810 第二章 搭建開發(fā)環(huán)境 PAGEREF _Toc131819810 h 1 HYPERLINK l _Toc131819811 2.1 本文軟件開發(fā)環(huán)境 PAGEREF _Toc131819811 h 1 HYPERLINK l _Toc131819812 2.2 給PD打補(bǔ)丁 PAGEREF _Toc131819812 h 1 HYP

3、ERLINK l _Toc131819813 2.3 建立數(shù)據(jù)庫 PAGEREF _Toc131819813 h 1 HYPERLINK l _Toc131819814 2.4 建立開發(fā)工程 PAGEREF _Toc131819814 h 2 HYPERLINK l _Toc131819815 第三章 數(shù)據(jù)庫表pdm及SQL腳本的生成 PAGEREF _Toc131819815 h 3 HYPERLINK l _Toc131819816 3.1 數(shù)據(jù)模型 PAGEREF _Toc131819816 h 3 HYPERLINK l _Toc131819817 3.2 生成pdm步驟 PAGERE

4、F _Toc131819817 h 3 HYPERLINK l _Toc131819818 3.3 生成SQL腳本步驟 PAGEREF _Toc131819818 h 7 HYPERLINK l _Toc131819819 第四章 生成數(shù)據(jù)字典 PAGEREF _Toc131819819 h 11 HYPERLINK l _Toc131819820 4.1 步驟 PAGEREF _Toc131819820 h 11 HYPERLINK l _Toc131819821 第五章 生成VO PAGEREF _Toc131819821 h 15 HYPERLINK l _Toc131819822 5.

5、1 準(zhǔn)備工作 PAGEREF _Toc131819822 h 15 HYPERLINK l _Toc131819823 5.2 生成VO PAGEREF _Toc131819823 h 18 HYPERLINK l _Toc131819824 第六章 第一個(gè)單據(jù) PAGEREF _Toc131819824 h 20 HYPERLINK l _Toc131819825 6.3 步驟一、建立單據(jù)模板 PAGEREF _Toc131819825 h 20 HYPERLINK l _Toc131819826 6.4 步驟二、建立工程包結(jié)構(gòu) PAGEREF _Toc131819826 h 25 HYPE

6、RLINK l _Toc131819827 6.5 步驟三、定制界面控制類 PAGEREF _Toc131819827 h 25 HYPERLINK l _Toc131819828 6.6 步驟四、定制界面UI類 PAGEREF _Toc131819828 h 26 HYPERLINK l _Toc131819829 6.7 步驟四、連接模板到NC集成輔助開發(fā)工具中查看效果 PAGEREF _Toc131819829 h 26 HYPERLINK l _Toc131819830 第七章 參照 PAGEREF _Toc131819830 h 28 HYPERLINK l _Toc13181983

7、1 7.3 什么是參照 PAGEREF _Toc131819831 h 28 HYPERLINK l _Toc131819832 7.4 建立參照類 PAGEREF _Toc131819832 h 28 HYPERLINK l _Toc131819833 7.5 在單據(jù)模板上設(shè)置參照 PAGEREF _Toc131819833 h 29 HYPERLINK l _Toc131819834 第八章 單據(jù)模板中的公式使用 PAGEREF _Toc131819834 h 33 HYPERLINK l _Toc131819835 8.1 什么是公式 PAGEREF _Toc131819835 h 33

8、 HYPERLINK l _Toc131819836 8.2 給單據(jù)模板設(shè)置公式 PAGEREF _Toc131819836 h 33 HYPERLINK l _Toc131819837 第九章 參考文獻(xiàn) PAGEREF _Toc131819837 h 36概述基本概念單據(jù)：比如報(bào)銷時(shí)的報(bào)銷單，一般由表頭和表體組成（有些時(shí)候還含有表尾）。表頭中包含了單據(jù)的主信息，比如日期、部門、預(yù)算項(xiàng)目；表體包含了單據(jù)的明細(xì)信息，比如具體的事項(xiàng)和金額；單據(jù)類型：一個(gè)業(yè)務(wù)系統(tǒng)為了使結(jié)構(gòu)更清晰，通常也是分層的。比如，供應(yīng)鏈系統(tǒng)包含了采購(gòu)、庫存等子系統(tǒng)，每個(gè)子系統(tǒng)都具有一個(gè)系統(tǒng)類型，而每個(gè)子系統(tǒng)都會(huì)具有很多張單據(jù)，

9、為了區(qū)分這些單據(jù)，為每張單據(jù)命名一個(gè)單據(jù)類型，作為唯一標(biāo)識(shí)；模板：?jiǎn)螕?jù)開發(fā)涉及到三大模板（單據(jù)模板、查詢模板、打印模板）。單據(jù)模板定義了單據(jù)的顯示外觀和基本框架，查詢模板定義了單據(jù)的查詢對(duì)話框，打印模板定義了單據(jù)信息打印到打印機(jī)的樣式和格式；VO：值對(duì)象，用作傳輸數(shù)據(jù)的載體聚合VO：?jiǎn)螕?jù)一般由表頭和表體構(gòu)成，因此單據(jù)的數(shù)據(jù)表通常設(shè)計(jì)成主表和子表。聚合VO是對(duì)單據(jù)數(shù)據(jù)的抽象，它用于裝載主表VO和一組子表VO.；UI工廠：雖然能通過三大模板定義出單據(jù)的顯示，但每張單據(jù)都有一些公共的或特殊的行為。UI工廠是一種單據(jù)開發(fā)框架，它將常用單據(jù)抽象成了很多類型，因此，UI工廠相當(dāng)于是單據(jù)開發(fā)的代碼模板，預(yù)置

10、了單據(jù)的各種公共行為，比如增、刪、改、查，并且可以連接到NC流程平臺(tái)，支持審批、單據(jù)驅(qū)動(dòng)等應(yīng)用。單據(jù)開發(fā)主要流程N(yùn)C平臺(tái)對(duì)開發(fā)過程進(jìn)行很多抽象和封裝，使得單據(jù)開發(fā)變得非常容易。一般地，開發(fā)環(huán)境中，開發(fā)一個(gè)單據(jù)主要包括以下步驟：第一步、PowerDesigner中建立單據(jù)的物理模型（數(shù)據(jù)庫表），保存成pdm文件(xml)；第二步、利用PowerDesigner生成單據(jù)的建表腳本(SQL語句)，在數(shù)據(jù)庫中執(zhí)行此腳本建立數(shù)據(jù)庫表結(jié)構(gòu)；第三步、利用NC集成輔助工具中的數(shù)據(jù)字典生成工具導(dǎo)入pdm文件，生成相應(yīng)的數(shù)據(jù)字典；第四步、利用NC集成輔助工具中的CodeSeedVO工具利用odbc連接數(shù)據(jù)庫，將單

11、據(jù)涉及的數(shù)據(jù)表生成VO對(duì)象；第五步、以UI工廠為基礎(chǔ)，應(yīng)用Template模式，編寫自己的單據(jù)類。下面，我們以一個(gè)簡(jiǎn)單的員工信息管理系統(tǒng)分別介紹這幾個(gè)步驟。搭建開發(fā)環(huán)境本文軟件開發(fā)環(huán)境1、操作系統(tǒng)：Windows 2000 Server2、數(shù)據(jù)庫設(shè)計(jì)工具：Sybase PowerDesigner Version 9.5.0.648（以下簡(jiǎn)稱PD）為了給數(shù)據(jù)表自動(dòng)生成時(shí)間戳(ts)、刪除標(biāo)志(dr)字段，需給PD打上插件補(bǔ)?。篸b2cs7.xdb，oracl8i2.xdb，sqlserv7.xdb3、數(shù)據(jù)庫：MS SQL Server 20004、開發(fā)工具：Eclipse 3.1.1給PD打補(bǔ)丁

12、將三個(gè)補(bǔ)丁文件全部拷貝到PD的安裝目錄的 Resource FilesDBMS 下即可建立數(shù)據(jù)庫因?yàn)镹C本身使用了很多數(shù)據(jù)庫表，所以我們建立的數(shù)據(jù)庫中必須包含NC系統(tǒng)表和其中的某些數(shù)據(jù)，而不是簡(jiǎn)單新建庫。本文以SQL Server 2000為例。第一步、建立數(shù)據(jù)庫v5test第二步、在v5test數(shù)據(jù)庫名上右鍵選擇導(dǎo)入數(shù)據(jù)，根據(jù)其它已經(jīng)建好的庫來生成庫?；蛘吒鶕?jù)數(shù)據(jù)庫的備份和還原操作來建庫。這樣，我們就建立起包含NC系統(tǒng)表的數(shù)據(jù)庫，在此基礎(chǔ)上，我們建立自己的數(shù)據(jù)表進(jìn)行開發(fā)。建立開發(fā)工程現(xiàn)在已經(jīng)存在NC_UAP_UIFactory工程，其中包含了部分UI工廠源碼和依賴的jar包，依此工程建立我們

13、自己的eclipse工程。第一步、打開eclipse，新建java工程（在V5中則新建MDE工程）第二步、設(shè)置工程名，本例為UIFactoryV5，選擇從存在的資源中創(chuàng)建工程，選擇NC_UAP_UIFactory文件夾，依次確定建立工程。數(shù)據(jù)庫表pdm及SQL腳本的生成PD是一種高端的數(shù)據(jù)建模工具，使用它可以很方便的建立數(shù)據(jù)庫、導(dǎo)出SQL腳本，其物理模型文件的后綴名為pdm，所以，NC輔助開發(fā)工具多處依賴PD來完成數(shù)據(jù)庫相關(guān)操作。數(shù)據(jù)模型我們的員工信息管理系統(tǒng)包括員工的基本信息，員工的類別信息，員工工資，為了增強(qiáng)系統(tǒng)的可擴(kuò)展性，從員工基本信息中獨(dú)立出員工的家庭住址信息，街道信息。下圖顯示了實(shí)體

14、間的關(guān)系。 生成pdm步驟第一步、打開PD文件夾中的可執(zhí)行文件pdshell9.exe，啟動(dòng)PD，會(huì)出現(xiàn)如下界面，選擇新建一個(gè)物理模型。第二步、我們以MS SQL Server數(shù)據(jù)庫為例，選擇數(shù)據(jù)庫為Miscrosft SQL Server 7.x，注意，由于補(bǔ)丁文件只針對(duì)SQL Server 7.x版本，所以，無論我們用SQL Server 7.x還是2000或以上版本，此處的DBMS都要選擇SQL. Server.7.x。第三步、確定后左側(cè)面板中會(huì)出現(xiàn)一個(gè)節(jié)點(diǎn)，雙擊彈出如下對(duì)話框，設(shè)置此模型的name,code等第四步、在新建節(jié)點(diǎn)上點(diǎn)擊右鍵選擇 New-Table第五步、在General選

15、項(xiàng)卡中，設(shè)置表名，表的中文描述第六步、在Columns選項(xiàng)卡中定義列，列的中文描述。注意此處列的數(shù)據(jù)類型，一般地，主鍵前綴為pk_，數(shù)據(jù)類型為char(20)，boolean類型的列前綴為b，數(shù)據(jù)類型為char(1)，日期類型前綴為d，數(shù)據(jù)類型為char(10)，等等，更多數(shù)據(jù)庫表字段命名規(guī)范參照附錄開發(fā)規(guī)范文檔。第七步、保存到指定目錄，便得到pdm文件生成SQL腳本步驟第一步、選擇菜單項(xiàng) Database - Generate Database 第二步、在彈出界面中，設(shè)置生成腳本文件的存放路徑，并對(duì)Tables & Views選項(xiàng)卡做如下設(shè)置第三步、對(duì)Keys & Indexs 選項(xiàng)卡做如下

16、設(shè)置，注意，取消除主鍵外的所有選項(xiàng)，因?yàn)榇藭r(shí)我們沒有這些選項(xiàng)信息第四步、取消 Database 選項(xiàng)卡中的所有選項(xiàng)第五步、按下確定按鈕后，便生成了SQL腳本生成數(shù)據(jù)字典數(shù)據(jù)字典是NC二次開發(fā)工具中探測(cè)數(shù)據(jù)庫表結(jié)構(gòu)的數(shù)據(jù)基礎(chǔ)，而不是采用每次需要數(shù)據(jù)都連接數(shù)據(jù)庫的方式。數(shù)據(jù)字典由上一步驟生成的pdm文件生成，NC二次開發(fā)工具提供了相應(yīng)的生成工具。步驟第一步、啟動(dòng)NC集成輔助開發(fā)工具，選擇菜單 系統(tǒng)管理工具 - 數(shù)據(jù)字典管理第二步、在彈出的界面中，選擇菜單項(xiàng) 工具 - 導(dǎo)入數(shù)據(jù)字典第三步、選擇數(shù)據(jù)字典導(dǎo)入文件類型，此處選擇 解析PDM文件第四步、在彈出的界面中點(diǎn)擊 選擇 按鈕，選擇上一章生成的PDM

17、文件第五步、選擇覆蓋方式，一般地，選擇 全部覆蓋第六步、在彈出的窗口左側(cè)會(huì)出現(xiàn)可供選擇的數(shù)據(jù)表，選中需要導(dǎo)入的數(shù)據(jù)庫表加到右邊的窗口中第七步，會(huì)出現(xiàn)如下窗口，此時(shí)便完成了數(shù)據(jù)字典的導(dǎo)入生成VOVO值對(duì)象是數(shù)據(jù)傳遞的載體，其結(jié)構(gòu)和數(shù)據(jù)庫表結(jié)構(gòu)緊密相關(guān)。一般我們?cè)谝粋€(gè)專門的包中存放VO對(duì)象，VO對(duì)象命名規(guī)則表現(xiàn)為類名以VO結(jié)尾。NC二次開發(fā)工具中也提供了相應(yīng)的工具，用于生成數(shù)據(jù)庫表的VO類。準(zhǔn)備工作VO類通過ODBC連接數(shù)據(jù)庫探測(cè)數(shù)據(jù)庫表結(jié)構(gòu)生成，所以，我們首先要建立起數(shù)據(jù)庫表結(jié)構(gòu)和ODBC連接源。第一步、在SQL Server 2000查詢分析器中執(zhí)行第二章生成的SQL腳本，生成數(shù)據(jù)庫表第二步、

18、選擇 控制面板 - 管理工具 - 數(shù)據(jù)源(ODBC) ，彈出如下界面第三步、選擇 SQL Server 驅(qū)動(dòng)模式第四步、指定數(shù)據(jù)源名稱和數(shù)據(jù)庫服務(wù)器第五步、在彈出的界面中，按下圖進(jìn)行設(shè)置第六步、選擇剛才建立的數(shù)據(jù)庫，此處為v5test第七步、在彈出的界面采用默認(rèn)設(shè)置第八步、測(cè)試數(shù)據(jù)庫連接，如果出現(xiàn)如下信息，則表明建立的數(shù)據(jù)源有效生成VO建立起數(shù)據(jù)庫和ODBC數(shù)據(jù)源之后，我們就可以開始生成VO對(duì)象。第一步、啟動(dòng)NC集成輔助開發(fā)工具，選擇菜單 向?qū)Чぞ?- codeseedVO 第二步、設(shè)置我們剛剛生成的ODBC數(shù)據(jù)源，數(shù)據(jù)庫訪問的用戶名和密碼，如果數(shù)據(jù)庫表很多，可以勾選上“表前綴過濾”選項(xiàng)，輸入

19、需要表的前綴，按下“列表”按鈕后會(huì)在界面的左邊列表框中列出所有符合前綴條件的表名，選擇一個(gè)主表，其它需要生成VO的表選作子表。在右邊設(shè)置生成VO對(duì)象的存儲(chǔ)路徑和VO類的包名及創(chuàng)建者，按下“為當(dāng)前表生成文件”按鈕，這樣就在目標(biāo)路徑下生成了VO類。第一個(gè)單據(jù)在以上準(zhǔn)備工作的基礎(chǔ)上，我們現(xiàn)在著手開發(fā)第一個(gè)單據(jù)。步驟一、建立單據(jù)模板第一步、啟動(dòng)NC集成輔助開發(fā)工具，選擇菜單項(xiàng) 模板管理 - 單據(jù)模板設(shè)置工具第二步、在彈出的界面中，輸入新單據(jù)模板標(biāo)識(shí)，如T01，然后按下“顯示模板”按鈕，如果此模板已經(jīng)存在，會(huì)顯示出已經(jīng)設(shè)置好的信息，如果此模板不存在，右側(cè)的“增加”按鈕會(huì)變亮，表明可添加此模板。然后，通過

20、表前綴過濾器，列出需要的數(shù)據(jù)表，主表只能選一個(gè)，子表可多選，本例我們選擇員工信息作為主表，員工家庭住址作為子表，按下“增加”按鈕。第三步、彈出的界面的右上是我們剛才選擇的數(shù)據(jù)表，左上為表頭部分，左中為表體部分。第四步、接下來我們?cè)O(shè)置表頭和表體的顯示內(nèi)容，左鍵單擊選中主表（uap_test_employee）不放，拖動(dòng)到表頭區(qū)域松開，此時(shí)會(huì)彈出如下對(duì)話框。第五步、采用默認(rèn)設(shè)置，確定，同樣操作，將子表（uap_test_address）拖動(dòng)到表體區(qū)域，此時(shí)界面變成如下樣子。第六步、我們可以修改具體顯示字段的排列順序，在表頭/表體區(qū)域按下鼠標(biāo)右鍵，會(huì)彈出下圖右鍵菜單。第七步、選擇“項(xiàng)目重新排序”菜單

21、，通過上移下移改變排列順序。第八步、我們還可以去掉一些不需要顯示的字段，在不需要顯示的字段上按下鼠標(biāo)右鍵，彈出如下右鍵菜單，選擇“刪除項(xiàng)目”菜單，就完成字段的刪除。第九步、保存編輯完的模板，選擇菜單項(xiàng) 模板操作 - 保存模板第十步、輸入模板的顯示標(biāo)題和節(jié)點(diǎn)標(biāo)識(shí)，便完成了模板的設(shè)置。步驟二、建立工程包結(jié)構(gòu)首先、建立自己的模板包，此處包名為nc.ui.mytest。其次、建立VO對(duì)象包，將我們第五章生成的VO包拷貝到工程的src目錄下即可。步驟三、定制界面控制類第一步、在nc.ui.mytest包中新建MyTestControler類，實(shí)現(xiàn)ICardController接口。public clas

22、s MyTestController implements ICardController / 第二步、重載getBillType()方法，其返回值為單據(jù)類型。本例中為T01。public String getBillType() return T01;第三步、重載getBillVoName()方法，關(guān)聯(lián)VO類，控制單據(jù)數(shù)據(jù)的獲得。public String getBillVoName() return new StringHYBillVO.class.getName(),TestEmployeeVO.class.getName(),TestAddressVO.class.getName();

23、第四步、重載getBusinessActionType()方法，設(shè)置單據(jù)是否走流程平臺(tái)。IbusinessActionType為常量接口，BD表明單據(jù)不走流程平臺(tái)。public int getBusinessActionType() return IBusinessActionType.BD;這樣，就完成了Controller類步驟四、定制界面UI類第一步、在nc.ui.mytest包中建立MyTestUI類，繼承自BillCardUI類public class MyTestUI extends BillCardUI /第二步、重載createController()方法，關(guān)聯(lián)界面控制類，此處

24、返回剛剛創(chuàng)建的MyTestController類。protected ICardController createController() return new MyTestController();這樣，就完成了UI類步驟四、連接模板到NC集成輔助開發(fā)工具中查看效果第一步、從Eclipse的package explore打開NC_HOME/ierp/DevelopToolConfig.xml文件第二步、在其自定義菜單位置，添加一個(gè)新的子菜單，并將className設(shè)置為我們編寫的UI類。我的單據(jù)模板nc.ui.mytest.MyTestUI第三步、啟動(dòng)NC集成開發(fā)工具，會(huì)在自定義菜單項(xiàng)下發(fā)現(xiàn)

25、我們剛剛添加的菜單項(xiàng)“我的單據(jù)模板”，選擇此菜單項(xiàng)，就會(huì)彈出如下界面。參照什么是參照參照錄入，是一種輔助的數(shù)據(jù)輸入方式，通常彈出界面的形式提供可以參考的數(shù)據(jù)，比如在錄入省份信息時(shí)，提供一個(gè)全國(guó)省份列表以供選擇。單據(jù)開發(fā)中，有很多輸入字段存在類似的需求。NC系統(tǒng)中預(yù)置了很多種常見參照（基本覆蓋了所有的基本檔案，比如人員參照，存貨參照），如果要自定義一種參照，則需要簡(jiǎn)單的開發(fā)工作。下面我們對(duì)員工家庭住址中的街道做一個(gè)參照，方便街道信息的錄入。建立參照類步驟一、建立自己的參照類，定制被參照的數(shù)據(jù)及其顯示樣式及格式。我們用nc.ui.mytest.ref包來存放參照類，新建RoadRefModel繼承

26、DefaultRefModel類，用于錄入員工數(shù)據(jù)。public class RoadRefModel extends DefaultRefModel / 步驟二、設(shè)置存儲(chǔ)參照信息的數(shù)據(jù)庫表名，及其關(guān)鍵字字段名public String getTableName() return uap_test_road;public String getPkFieldCode() return pk_road;步驟三、分別重載getFieldCode()和getFieldName()方法，設(shè)置需要參照的字段（數(shù)據(jù)庫表中的列名），及其顯示名稱public String getFieldCode() retu

27、rn new String vname, vdescription;public String getFieldName() return new String 街道名稱, 描述信息 ;步驟四、設(shè)置參照彈出對(duì)話框的標(biāo)題 public String getRefTitle() return 道路參照; 這樣，就完成了參照類，下面將單據(jù)模板中的某些字段設(shè)置上參照。在單據(jù)模板上設(shè)置參照如果在第六章建立的單據(jù)模板中添加一條員工家庭住址信息，輸入住址所在街道時(shí)需要輸入街道數(shù)據(jù)表對(duì)應(yīng)記錄的主鍵，這是添上參照，使得用戶錄入員工家庭住址時(shí)，可以通過選擇街道來填充對(duì)應(yīng)的街道字段步驟一、啟動(dòng)NC集成輔助開發(fā)工具，

28、在 模板管理 - 單據(jù)模板設(shè)置工具 菜單中，修改之前建立的“T01”單據(jù)模板。步驟二、為了給用戶更加直觀的感受，我們給表體增加“街道名稱”列，并將這列作為參照錄入的列。在表體上按下右鍵菜單，選擇“增加自定義項(xiàng)目”。步驟三、此時(shí)會(huì)彈出如下對(duì)話框。第四步、每一列都有一個(gè)標(biāo)識(shí)，輸入列標(biāo)識(shí)后按下確定。這時(shí)，表體增加roadname列，單擊列頭右邊的屬性窗口會(huì)顯出出項(xiàng)目主鍵和顯示名稱。第五步、修改顯示名稱為“街道名稱”第六步、選擇高級(jí)屬性選項(xiàng)卡，將數(shù)據(jù)類型設(shè)置為“參照”，參照類型設(shè)置為我們建立的參照類，放到“”中，即為“”。設(shè)置關(guān)鍵字名為主鍵所在列的road，這是因?yàn)?，員工地址表中關(guān)聯(lián)的是街道主鍵，當(dāng)客戶在參照中選擇了某個(gè)街道，需要將這條數(shù)據(jù)的主鍵帶到界面中的road字段；第七步、此時(shí)，點(diǎn)擊每行的街道名稱單元格時(shí)，單元格中會(huì)顯示出一個(gè)按鈕，提示此格數(shù)據(jù)可以選擇錄入。第八步、按下按鈕，彈出如下對(duì)話框。選擇某