NC二次開(kāi)發(fā)指導(dǎo)手冊(cè)

用友集團(tuán)ERP客戶化開(kāi)發(fā)系列叢書(shū)

NC客戶化開(kāi)發(fā)進(jìn)階

培訓(xùn)教程

V2.0版

lEinA用友軟件股份有限公司

■IUFIDASOFTWARECO.,LTD.

本教程是用友軟件股份有限公司內(nèi)部培訓(xùn)資料，只限于用友公司內(nèi)部開(kāi)發(fā)

應(yīng)用，任何人未經(jīng)過(guò)事先書(shū)面許可不得擴(kuò)大本教程的使用范圍。同樣，未經(jīng)過(guò)

用友公司書(shū)面許可，任何人不得以任何形式對(duì)本手冊(cè)進(jìn)行增刪、改編、節(jié)選、

翻譯、翻印或仿制，違者必究！

?本手冊(cè)的著作權(quán)屬于用友軟件股份有限公司

版權(quán)所有?翻制必究

2009年1月第一次印刷

在中華人民共和國(guó)印制

用友軟件股份有限公司

目錄

第一篇入門篇....................................................................5

1.建立NC環(huán)境.................................................................5

內(nèi)容概述.....................................................................5

詳細(xì)介紹.....................................................................6

1.1.1.建立數(shù)據(jù)庫(kù)......................................................6

1.1.2.安裝NC..................................................................................................................7

1.1.3.配置啟動(dòng)NC.........................................................................................................9

1.1.4.Eclipse中建立NC開(kāi)發(fā)環(huán)境......................................13

1.1.5.產(chǎn)品參數(shù)，檔案初始化...........................................19

1.1.6.權(quán)限管理.......................................................22

1.1.7.產(chǎn)品主要目錄結(jié)構(gòu)介紹...........................................24

2.NC基礎(chǔ)技術(shù)................................................................25

內(nèi)容概述....................................................................25

詳細(xì)介紹....................................................................25

2.1.1.NCUAP總體介紹..............................................25

2.1.2.NC開(kāi)發(fā)中的一些基本概念.......................................30

2.1.3.NC的開(kāi)發(fā)模型..................................................32

2.1.4.開(kāi)發(fā)遠(yuǎn)程接口...................................................34

?定義接口........................................................34

?實(shí)現(xiàn)該接口.....................................................34

?部署組件........................................................34

?客戶端調(diào)用.....................................................35

?事務(wù)型組件發(fā)布.................................................36

?客戶端代碼.....................................................38

3.數(shù)據(jù)建模..................................................................40

內(nèi)容概述....................................................................40

詳細(xì)介紹....................................................................40

3.1.1.PowerDesigner建模..............................................40

3.1.2.生成NC數(shù)據(jù)字典...............................................48

第二篇中級(jí)篇...................................................................49

4.單據(jù)開(kāi)發(fā)..................................................................50

內(nèi)容概述....................................................................50

詳細(xì)介紹....................................................................50

4.1.1.進(jìn)入Workshop.....................................................................................................50

4.1.2.表單開(kāi)發(fā)流程導(dǎo)航工具...........................................52

4.1.3.UI工廠.........................................................65

5.NC數(shù)據(jù)庫(kù)持久化技術(shù)........................................................68

內(nèi)容概述....................................................................68

詳細(xì)介紹....................................................................69

5.1.1.核心類介紹：...................................................69

5.1.2.通過(guò)JDBCFrameWork訪問(wèn)數(shù)據(jù)庫(kù)................................70

5.1.3.通過(guò)BaseDao進(jìn)行對(duì)象的持久化..................................73

1

用友軟件股份有限公司

5.1.4.結(jié)果集控制......................................................74

6.單據(jù)開(kāi)發(fā)其他相關(guān)技術(shù).....................................................75

內(nèi)容概述....................................................................75

詳細(xì)介紹....................................................................75

6.1.1.參照開(kāi)發(fā).......................................................75

6.1.1.1.參照的類結(jié)構(gòu)圖.............................................75

6.1.1.2.自定義參照開(kāi)發(fā)規(guī)范........................................76

6.1.13.UIRefPane和erfModle設(shè)置..................................78

6.1.2.單據(jù)號(hào)..........................................................79

6.1.2.1.單據(jù)號(hào)規(guī)則.................................................79

6.1.2.2.接口方法...................................................81

6.1.3.公式............................................................83

6.1.4.鎖..............................................................88

6.1.5.日志............................................................90

6.1.6.異常............................................................91

7.報(bào)表開(kāi)發(fā)..................................................................93

內(nèi)容概述....................................................................93

詳細(xì)介紹....................................................................93

7.1.1.入門............................................................93

7.1.2.查詢模型.......................................................101

7.1.3.格式設(shè)計(jì).......................................................109

7.1.4.發(fā)布報(bào)表.......................................................120

第三篇高級(jí)篇..................................................................122

8.預(yù)警平臺(tái)....................................................................122

內(nèi)容概述...................................................................122

詳細(xì)介紹...................................................................123

8.1.1.預(yù)警類型注冊(cè)..................................................123

8.1.2.預(yù)警條目注冊(cè)..................................................125

9.交換平臺(tái)....................................................................130

內(nèi)容概述...................................................................130

詳細(xì)介紹...................................................................130

9.1.1.交換平臺(tái)使用..................................................130

9.1.2.交換平臺(tái)插件開(kāi)發(fā)..............................................136

10.流程平臺(tái)...............................................................138

內(nèi)容概述...................................................................138

詳細(xì)介紹...................................................................138

10.1.1.流程平臺(tái)介紹..................................................138

10.1.2.業(yè)務(wù)流程......................................................140

業(yè)務(wù)類型..........................................................141

流程配置..........................................................142

單據(jù)權(quán)限配置......................................................143

單據(jù)來(lái)源配置......................................................144

動(dòng)作約束配置......................................................145

動(dòng)作事件控制配置..................................................146

2

用友軟件股份有限公司

動(dòng)作驅(qū)動(dòng)配置......................................................146

單據(jù)V0交換.............................................................................................................147

下面是一個(gè)最小化的推式流程過(guò)程...................................149

拉式單據(jù)（單據(jù)的上下游參照）.....................................150

10.1.3.審批流........................................................152

審批流定義........................................................152

審批流編程........................................................156

10.1.4.消息中心.......................................................164

11.會(huì)計(jì)平臺(tái)...............................................................168

內(nèi)容概述...................................................................168

詳細(xì)介紹...................................................................168

11.1.1.會(huì)計(jì)平臺(tái)注冊(cè)..................................................169

11.1.2.代碼調(diào)用......................................................175

12.單點(diǎn)登陸...............................................................176

內(nèi)容概述...................................................................176

詳細(xì)介紹...................................................................177

12.1.1.單點(diǎn)登陸......................................................177

12.1.2.打開(kāi)代辦事項(xiàng)..................................................179

13.NC開(kāi)發(fā)webservice-Axis..................................................................................................181

內(nèi)容概述...................................................................181

詳細(xì)介紹...................................................................181

13.1.1.發(fā)布webservice..................................................................................................181

13.1.2.客戶端代碼調(diào)用................................................185

第四篇附錄....................................................................186

14.XMLEXCEL..................................................................................................................186

內(nèi)容概述186

詳細(xì)介紹186

14.1.利用XmlUtils讀取XML.................................................................................186

14.2.Excel文件讀寫.................................................192

15.多語(yǔ)言................................................................193

內(nèi)容概述...................................................................193

詳細(xì)介紹...................................................................193

15.1.1.生成資源文件..................................................194

15.1.2.代碼調(diào)用......................................................194

16.補(bǔ)丁與安裝盤..........................................................195

內(nèi)容概述195

詳細(xì)介紹...................................................................195

16.1.安裝盤結(jié)構(gòu)....................................................195

16.2.產(chǎn)品結(jié)構(gòu)......................................................196

16.3.模塊結(jié)構(gòu)......................................................196

16.4.制作補(bǔ)丁......................................................199

17.設(shè)計(jì)開(kāi)發(fā)規(guī)范..........................................................202

內(nèi)容概述..................................................................202

詳細(xì)介紹..................................................................202

3

用友軟件股份有限公司

17.1.SQL規(guī)范.....................................................202

17.2.java開(kāi)發(fā)規(guī)范..................................................205

18.開(kāi)發(fā)常見(jiàn)問(wèn)題與技巧....................................................218

內(nèi)容概述.....................................................................................................................................218

詳細(xì)介紹..................................................................218

18.1.環(huán)境變量類nc.ui.pub.ClientEnvironment.....................................................218

18.2.發(fā)送待辦消息..................................................220

18.3.模板中下拉框的值..............................................221

4

用友軟件股份有限公司

第一篇入門篇

歡迎您成為用友NC開(kāi)發(fā)隊(duì)伍中的一員！如果您從未接觸過(guò)NC的開(kāi)發(fā)，本篇將從NC

產(chǎn)品使用開(kāi)始,序漸進(jìn)的帶您步入精彩的NC產(chǎn)品世界.本學(xué)時(shí)教程是在完成NC產(chǎn)品使用入

門閱讀的最佳起點(diǎn)。在開(kāi)始學(xué)習(xí)之前，您需要掌握以下基本技能：

>Eclipse使用

>JAVA和JE22基礎(chǔ)知識(shí)

本學(xué)時(shí)教程中將會(huì)講述以下內(nèi)容：

NC產(chǎn)品入門，本章旨在為那些對(duì)NC尚不了解的新進(jìn)人員就NC的大體形態(tài)做個(gè)簡(jiǎn)單

的講解，以便對(duì)NC產(chǎn)品有個(gè)簡(jiǎn)單的認(rèn)識(shí)，并學(xué)習(xí)到與NC產(chǎn)品二次開(kāi)發(fā)有關(guān)的產(chǎn)品操作技

術(shù)入門知識(shí)。

開(kāi)發(fā)環(huán)境的安裝和搭建，本章是為第一次使用NC的人員做準(zhǔn)備，達(dá)到迅速的安裝和搭

建NC環(huán)境。

NC技術(shù)框架筒介，本章您將會(huì)學(xué)習(xí)NC技術(shù)框架理論概念，通過(guò)學(xué)習(xí)范例代碼掌握

VO\BO\遠(yuǎn)程接口的概念。

NC5.X的數(shù)據(jù)建模，使用PowerDesigner進(jìn)行數(shù)據(jù)庫(kù)建模。

1.建立NC環(huán)境

內(nèi)容概述

第一次在NC環(huán)境中做開(kāi)發(fā)，需要首先建立一個(gè)數(shù)據(jù)庫(kù)環(huán)境，這個(gè)數(shù)據(jù)庫(kù)環(huán)境中指

定了NC所要使用的表空間，并預(yù)先建立了NC的系統(tǒng)表、視圖、索引等，并預(yù)置了大

量的初始化數(shù)據(jù)。然后，在Eclipse中建立一個(gè)開(kāi)發(fā)項(xiàng)目，引用UAP的jar包即可。經(jīng)

過(guò)這兩步，就完成了NC開(kāi)發(fā)環(huán)境的建立。

NC環(huán)境安裝完成后還需要對(duì)系統(tǒng)進(jìn)行初始化，包括參數(shù)，組織結(jié)構(gòu)，權(quán)限，基本

檔案的建立，這樣一個(gè)系統(tǒng)才算真正可以使用。

5

用友軟件股份有限公司

詳細(xì)介紹

1.1.1,建立數(shù)據(jù)庫(kù)

在數(shù)據(jù)庫(kù)服務(wù)器(Oracle,MSSQLServer,DB2)中新建一個(gè)空數(shù)據(jù)庫(kù)，并執(zhí)行數(shù)

據(jù)庫(kù)腳本建立NC需要的表空間，不同的數(shù)據(jù)庫(kù)使用的腳本不一樣(正式安裝盤下有安

裝說(shuō)明)，以MSSQLServer為例：假設(shè)新建的數(shù)據(jù)庫(kù)叫ncdemo,MSSQLServe的數(shù)據(jù)

文件存放在D:\MicrosoftSQLServer'data下，那么數(shù)據(jù)庫(kù)腳本為

ALTERDATABASE|NCDEMO|ADDFILEGROUP|NNC_DATA01]

go

ALTERDATABASE|NCDEMO|ADDFILEGROUP|NNC_DATA02|

go

ALTERDATABASE|NCDEMO]ADDFILEGROUP|NNC_DATA03]

go

ALTERDATABASE[NCDEMO]ADDFILEGROUP|NNCJNDEX01]

go

ALTERDATABASE[NCDEMO]ADDFILEGROUP(NNCJNDEX021

g。

ALTERDATABASE|NCDEMO|ADDFILEGROUP|NNCJNDEX03]

go

ALTERDATABASE[NCDEMO]ADDFILE(NAME=N'nnc.dataOT,FILENAME=

N'D:\MicrosoftSQLServer\data\nnc_dataO1_Data.NDF',SIZE=500,FILEGROWTH=

200)TOFILEGROUP|NNC_DATA01|

go

ALTERDATABASE[NCDEMO]ADDFILE(NAME=N'nnc_data02',FILENAME=

N'D:\MicrosoftSQLServer\data\nnc_dataO2_Data.NDF',SIZE=500,FILEGROWTH=

200)TOFILEGROUP|NNC_DATA02]

g。

ALTERDATABASE[NCDEMO]ADDFILE(NAME=N'nnc_data03',FILENAME=

N'D:\MicrosoftSQLServer\data\nnc_dataO3_Data.NDF',SIZE=500,FILEGROWTH=

200)TOFILEGROUP|NNC_DATA03]

go

6

用友軟件股份有限公司

1.1.2.安裝NC

該步驟的目的是建立NC測(cè)試服務(wù)器，并利用它建表，并初始化數(shù)據(jù)表。

運(yùn)行UAPV5安裝盤下的ncsetup.bat文件，會(huì)進(jìn)入下面的安裝向?qū)В?/p>

1）選擇NC服務(wù)器端環(huán)境根目錄：

UFIDA用友軟件

二X

1.歡膽艮用用發(fā)歆件

2:依做中明

4坦彈安獻(xiàn)

5理產(chǎn)品p.i￡nMronmtnt?5damo|

u：送iMi三方電業(yè)aia伴

I型"II上"]ITI

協(xié)同商壬堂中轉(zhuǎn)理

2）選擇要安裝的UAP產(chǎn)品模塊:

用反新世紀(jì)（NC）管理軟件UFIDA用友軟件

3）開(kāi)始NC環(huán)境的安裝

7

用友軟件股份有限公司

己(NC)管理軟件UFIDA用友軌件

協(xié)同商務(wù)修中

4)選擇第三方中間件，如果沒(méi)有則默認(rèn)使用NC自帶中間件。

uP?oFTXcwCeBturyMoitageaicai

用反新也紀(jì)（NC）管理軟件UFIDA用友軟件

執(zhí)行完此向?qū)Ш?，可以在你指定的NC_HOME目錄中創(chuàng)建NC服務(wù)器端環(huán)境，如

下圖:

8

用友軟件股份有限公司

KttD)|jE：\Err.iawrt\vMeno

名稱

文蹤

4J口城200662810:59

豚

文

一Dbn20066281LO3

豚

爻

v5demo口corf200^-2810:59

豚

爻

'□ejb2002261Ml

游

文

餌翎目可以薪耳配功ZjeHWls306281059

蹤

文

3extem?i20064-281059

游

另鼬御：文

口franewak2006^-2810:59

蹤

文

Jlerp2m281059

聯(lián)

文

恥齷2jr*(kenfe20066281059

蹤

文

翔電由小2002281059

豚

文

Jrriiiw?e20)5^-281059

牌

爻

ZjmodJes200228IKE

游

義

：2]nc$(r(t2006^-2811^1

麻

文

Opta20K4-2810S9

蹤

□resources文

骸20056281059

三

聯(lián)2(?海2811:00

文

□webw2002281059

i|.r)ewnsUi