U8UAP開發(fā)手冊資料

UAP開發(fā)樣例指導

用友研發(fā)中心U8平臺技術部

〈本文檔適用于U871版本＞

目錄

一、摘要3

二、樣例開發(fā)前提3

三、建立UAP項目3

四、建立表單模型5

（一）新建實體6

（二）新建實體屬性8

五、建立表單布局14

六、行為對象開發(fā)15

（一）表單開發(fā)17

（二）列表開發(fā)30

（三）生單二次開發(fā)36

（四）聯(lián)查報表37

（五）聯(lián)查UAP列表38

（六）UAP列表聯(lián)查U8單據(jù)39

（七）用戶自定義控件開發(fā)42

（八）U8單據(jù)引用UAP檔案43

七、行為對象注冊56

功能介紹：56

使用說明：56

應用技巧：58

八、建立數(shù)據(jù)引擎59

功能介紹：59

使用說明：60

應用技巧：82

九、設置過濾條件82

功能介紹：82

使用說明：82

應用技巧：87

十、設置欄目88

功能介紹88

使用說明88

應用技巧89

H^一'、權限89

功能權限89

記錄級權限90

字段級權限91

十二、部署93

附錄：功能介紹93

1、行為對象升級說明93

2、Logininfo對象介紹95

一、摘要

本文以U8-ERP中的銷售訂單為應用原型，介紹了如何通過UAP進行軟件開發(fā)，文中

給出了開發(fā)方法和豐富樣例。內(nèi)容包括：

■UAP表單開發(fā)原理

■UAP項目的建立和導入、導出

■UAP表單的模型設計和布局設計

■UAP表單的行為對象開發(fā)

IUAP表單列表設計與開發(fā)

■UAP表單列表的行為對象開發(fā)

■如何對UAP表單的缺省按鈕進行擴展性開發(fā)

■如何對UAP表單的缺省按鈕進行取代性開發(fā)

■如何為UAP表單增加新的按鈕及行為

■如何用程序代碼調(diào)用UAP報表

■如何用程序代碼調(diào)用UAP表單列表

■如何在UAP表單中增加權限控制：功能權限、字段權限、記錄權限

■如何為UAP表單開發(fā)自定義控件

■如何開發(fā)樹形檔案

■如何維護UAP數(shù)據(jù)引擎

■如何維護欄目

■如何維護過濾條件

■如何調(diào)用U8API

■U8單據(jù)自定義項如何引用UAP檔案

本文檔中使用的示例文件為“銷售訂單二次開發(fā)"，可以通過UAP將該文件導入到帳

套中。項目名稱為“SaleVoucher"，導入后在項目中包括幾個自定義單據(jù)：“銷售訂單”

為二次開發(fā)的Dem。示例；“零售日報”為自定義空間二次開發(fā)的Demo示例；“列表檔

案示例”、“樹形編輯檔案示例”、“樹形導航檔案示例”分別為各個對應的檔案類型的

示例。

二、樣例開發(fā)前提

首先，需要安裝U8產(chǎn)品，并建立一個帳套。

其次，您需要向用友公司購買UAP表單設計許可；不過您可以使用UAP的演示版

本，但是演示版本不能新建UAP項目，也不能注冊行為對象。

三、建立UAP項目

使用UAP登錄您的帳套后，在系統(tǒng)界面上的新建項目選項卡，選中“供應鏈”后，在

右邊的列表中選擇“銷售管理”，在界面下方的幾個文本框中輸入項目名稱，編號，描述

等；順序選擇框使用“默認”即可。點擊“確定”如果輸入信息與先前創(chuàng)建的項目信息不

沖突，項目就可被成功創(chuàng)建。

您也可以導入我們?yōu)槟峁┑腢AP樣例項目,導入方法如下。

1、登錄UAP；

2、打開菜單“文件一導入和導出”；

3、選中“導入項目數(shù)據(jù)到目前的服務器”，點“確定”按鈕;

4、點“導入”按鈕，選取U8安裝目錄下的“uap'sdk”目錄中的文件

“Samplefile”；

5、導入成功后;

UAP導入操作

導人...|關閉|

詳細信息:

Info(2006-11-07T21:16:40)：開始導/保1in?uiers的數(shù)據(jù)...

Info(2006-11-07T21:16:40)：構建網(wǎng)Ftefrom

[BFNeta_003].[dbo].[Uap_Vouchers]jectNo

InfoC2006-11-07T21:16:40)：刪除舊,

Info(2006-11-07T21:16:41)：插入新,

Info(2006-11-07T21:16:41)：單據(jù).UI營人結(jié)束

Info(2006-11-07T21:16:41)：開始導,數(shù)據(jù)…

Info(2006-11-07T21:16:41)：構建郵tefrom

[UFData_003_2006].[dbo].[AAEnum]ojectNo

Info(2006-11-07121:16:41)：刪除I檢

InfoC2006-11-07T21:16:42)：插入新數(shù)據(jù)？

Info(2006-11-07T21:16:42)：單據(jù),UFData.AA_Enum數(shù)據(jù)導入結(jié)束

Info(2006-11-07T21:16:42)：數(shù)據(jù)導入結(jié)束，

6、在UAP已存在的項目中產(chǎn)生了一個名稱為“SaleVbucher”的項目;

四、建立表單模型

選中“自定義表單”節(jié)點，單擊右鍵，使用“新建自定義表單”功能創(chuàng)建一個新的表

單。然后在彈出的選擇界面中選擇“表單類型”下的“單據(jù)”，在名稱文本框中輸入一個

表單名字，不要與以前創(chuàng)建的表單名字重復。在成功創(chuàng)建后，系統(tǒng)界面會如下圖（圖表

1）所示：

圖表1

在上圖所示的實體節(jié)點，默認有兩個子節(jié)點，分別為“主表和第一子表”，根據(jù)當前表單

的需要設計實體，包括增加實體和實體屬性等。

（一）新建實體

需要為實體填寫“實體名稱”，和選擇“實體類型”。除此以外，還可以通過實體的屬性

編輯窗口為實體設置各項信息。

實體的相關屬性：

?名稱：實體顯示的名稱，僅用于設計時。

?發(fā)布狀態(tài)：實體是否已發(fā)布，只讀。

?功能：為實體定義自定義功能，在運行時顯示為表格對應的工具欄按鈕。

?狀態(tài)設置：設置實體屬性、功能在表單運行時的狀態(tài)，決定實體屬性、功能在不

同的環(huán)境下是否可用。

?物理表模式：設置實體物理表的創(chuàng)建模式，默認為由UAP在發(fā)布時自動創(chuàng)建。在

特殊的應用場景中可以使用“使用已存在的對象”或“無”。后兩種情況下UAP

不負責實體物理表的維護。

?物理表：設置該實體在數(shù)據(jù)庫存儲時使用的物理表，一般情況下一個實體對應一

個物理表。

?數(shù)據(jù)引擎模式：設置實體運行時數(shù)據(jù)的訪問方式。默認為UAP系統(tǒng)在發(fā)布時自動

創(chuàng)建，特殊的應用場景中可以使用“使用已存在的對象”或“無”，這兩種情況

下系統(tǒng)不負責實體數(shù)據(jù)的讀取，只能通過用戶定義的接口獲取數(shù)據(jù)集。

?數(shù)據(jù)引擎：當數(shù)據(jù)引擎模式為“使用已存在的對象”時，設置要使用的數(shù)據(jù)引擎

對象。

?主鍵：設置實體物理表的主鍵字段名。

?主鍵類型：設置實體物理表主鍵字段的類型，可選“整數(shù)”或“GUID”或“字符

曳“

H-1o

?行模式：多行或單行。一般主表設置為單行。

（二）新建實體屬性

實體必須包含實體屬性時才有效?？梢栽赨AP界面“表單”窗口中，右鍵點擊實體對

應的節(jié)點，選擇“新建實體屬性”菜單向?qū)嶓w添加實體屬性：

實體屬性通用屬性：

?類型：該實體屬性的類型。

?描述：對該實體屬性的單體描述。

?屬性名稱：實體屬性的名稱。

?默認值：實體屬性的默認值。

?使用默認值：用戶未提供數(shù)據(jù)時，是否使用實體屬性的默認值。

?發(fā)布：該實體屬性是否已經(jīng)發(fā)布。

?常用條件：該實體屬性是否可以在過濾中作為常用條件使用。

?區(qū)間條件：該實體屬性是否可以在過濾中作為區(qū)間條件使用。

?值更新事件：設置該實體屬性值更新時需要處理的腳本列表。

基礎資料類型字段共有三種類型的值更新事件：“攜帶當前字段相關參照屬性到

指定列”、“計算定義公式的值到指定列”、“表達式為真/假時改變指定欄目編

輯狀態(tài)”；其余類型字段比基礎資料類型字段缺少第一種類型的值更新事件。

1.攜帶當前字段相關參照屬性到指定列

2.計算定義公式的值到指定列

定義公式

公式中不能使用全角字符作為操作符。作為常量使用時，諳確保全角字匚蛾二口取消

符只出現(xiàn)在被引號包含的字符串內(nèi).

3.表達式為真/假時改變指定欄目編輯狀態(tài)

定義公式X

公式中不能使用全角字符作為操作符.作為常量使用時，請確保全角字確定取消

符只出現(xiàn)在被引號包含的字符串內(nèi).I

表單式為真'假時修改指定欄目的編輯狀態(tài)

定義公式

公式中不能使用全角字符作為操作符。作為常量使用時，語確保全角字確定取消

符只出現(xiàn)在被引號包含的字符串內(nèi).I

表單式為真'假時修改指定欄目的顯示狀態(tài)

定義公式X

公式執(zhí)行條件

廠只有在滿足以下條件時執(zhí)行公式&)：

［主表.業(yè)務類型］!='0'

公式內(nèi)容來源字段

欄目|［主表.發(fā)運方式］三］的狀態(tài)更新為:［主表.收貨地址編碼］

［主表.收貨單位］

［主表.收貨聯(lián)系人］

［主表.收貨聯(lián)系電話］

「顯不⑤)［主表.收貨聯(lián)系人手機］

［主表.現(xiàn)存件數(shù)］

［主表.可用件數(shù)］

3隱藏兇［主表.iverifystate］

［主表.ireturncount］

［主表.icreditstate］

［主表.iswfcontrolled］

［主表.發(fā)貨單號］

［主表.發(fā)貨日期］

［主表.業(yè)務類型］

［主表.銷售類型］

［主表.訂單號］

i主袤.盅:票號i二J

公式中不能使用全角字符作為操作符。作為常量使用時，語確保全角字取消

符只出現(xiàn)在被引號包含的字符串內(nèi)-

表單式為真'假時修改指定功能狀態(tài)

表單功能

定義公式

公式中不能使用全角字符作為操作符。作為常量使用時，語確保全角字確定I取消

符只出現(xiàn)在被引號包含的字符串內(nèi)-

實體功能

定義公式

公式中不能使用全角字符作為操作符.作為常量使用時，話確保全角字

確定取消

符只出現(xiàn)在被引號包含的字符串內(nèi).I

?唯一約束：是否檢查該實體屬性的值在整個表單范圍內(nèi)唯一。

?文本對齊：實體屬性文本的顯示位置。

?顯示文本：實體屬性的不同語言環(huán)境中顯示的文本。

?允許空值：實體屬性的值是否可以為空。

?物理表：實體屬性對應物理字段的表名，即該實體屬性所屬實體的物理表。

?字段：實體屬性對應的物理字段名。

除了支持以上通用屬性外，不同類型的實體屬性還具有不同的特性：

1.表單編號

表單編號只能出現(xiàn)的主表實體中，并且只能有一個表單編號類型的實體屬性。

2.表單名稱

表單名稱類型的實體屬性只能在檔案類型的表單中使用，同表單編號一樣，表單

名稱類型的實體屬性只能出現(xiàn)主表實體中，并且只能出現(xiàn)一次。

3.整數(shù)和正整數(shù)

?可否為0：數(shù)值型的值是否可為0。

?錄入長度：限制用戶可錄入數(shù)值的最多位數(shù)。

?數(shù)據(jù)格式：數(shù)值類型的顯示格式。

?最大值和最小值：數(shù)據(jù)的有效范圍。正整數(shù)的最小值必須等于或大于0。

4.小數(shù)和正小數(shù)

?可否為0：數(shù)值型的值是否可為0。

?錄入長度：限制用戶可錄入數(shù)值的最多位數(shù)。

?數(shù)據(jù)格式：數(shù)值類型的顯示格式。

?最大值和最小值：數(shù)據(jù)的有效范圍。正小數(shù)的最小值必須等于或大于0。

?小數(shù)位數(shù)：數(shù)據(jù)保留的小數(shù)位數(shù)。

5.文本

?多行輸入：運行時是否支持錄入多行文本。

?最大長度：最多可錄入的文本長度。

6.日期和日期時間

日期類型運行短日期格式，即只包含年月日。日期時間類型包含年月日和時分

秒。

7.枚舉

枚舉類型的實體屬性需要設置枚舉值列表，枚舉值的顯示值為在界面顯示的文

本，保存值為實際保存到數(shù)據(jù)庫的數(shù)據(jù)，如枚舉類型的實體屬性“銷售類型”的

枚舉值可設置為如下圖所示：

U872中枚舉字段支持選擇“枚舉模式”：使用已存在枚舉、新創(chuàng)建枚舉。選擇

“使用已存在枚舉”后，需要為“枚舉類型”選擇一個U8系統(tǒng)中現(xiàn)有的枚舉中

的一個。

8.基礎資料

基礎資料類型的值來自指定參照檔案的對照值。

?參照對象：設置基礎資料類型實體屬性的參照檔案對象，可以從U8檔案列

表中選擇，包含UAP中定義為檔案類型的表單。

?參照顯示值：該屬性是設置當前就“基礎資料”字段在運行時的文本框里顯

示參照的那個字段的值。如上面的“參照對象”屬性選擇的存貨檔案，如果

不設參照顯示值，則運行時默認顯示為存貨編碼，如果將“參照顯示值”屬

性設置為存貨檔案的“存貨”名稱，運行是該字段就會顯示為存貨的名稱。

?選擇方式：設置在運行時的對照選擇方式。

?自動校驗：是否對錄入的值進入檢驗以確定數(shù)據(jù)是否來自指定的參照對象。

選擇“否”時允許用戶錄入?yún)⒄諏ο笾胁淮嬖诘闹怠?/p>

9.基礎資料屬性

基礎資料屬性類型的實體屬性必須和基礎資料類型的實體屬性結(jié)合使用。

?參照屬性：設置基礎資料屬性類型實體屬性要綁定的基礎資料類型實體屬

性，并指定關聯(lián)的參照字段。當基礎資料類型的實體屬性值變化時，基礎資

料屬性類型的實體屬性值隨之改變。

10.數(shù)量、價格和金額

數(shù)量、價格和金額類型的實體屬性實質(zhì)上為小數(shù)類型，設置等同于小數(shù)類型的實

體屬性。

11.復選框

特殊類型的整數(shù)值，運行時顯示為復選框，保存的數(shù)據(jù)為0（未選擇）或1（選

擇）。

12.制單人

當前單據(jù)的作者，一般設為登錄用戶。

13.制單日期和修改日期

制單日期保存當前表單生成的日期，修改日期保存表單最后一次修改的日期。這兩種類型

的實體屬性實質(zhì)上為日期時間類型，設置等同于日期時間類型的實體屬性。

五、建立表單布局

在完成實體的設計后，可以設計表單布局，UAP支持一個表單多個布局視圖，用戶可

根據(jù)自己的使用習慣選擇一種布局視圖。布局視圖的設計與普通window界面的布局設計

基本一致。

用友ERP-U8UAP□EH

|文件（D|視圖（在項目（D單據(jù)⑧布局⑥工具①窗口如幫助Q!）

JD」,乙H。凸二嵋也嗇同回已K因炒

-3」J」V凹二一吊。觸花多電L5V尚，有昆合正/Q滬;

項目管理|UA落肖售訂單［表單定且UAP銷售訂單［布局視圖］

Q國aB在

UAP銷售訂單-Sile'Zoucher

「“指針二I捐售管理

銷售訂單號銷售類型訂單日期3U8已有表單

A群態(tài)文本sS報表

客戶銷售部門業(yè)務員

O分組頁簽口單據(jù)轉(zhuǎn)換視則

發(fā)運方式發(fā)往地址付款條件sE3自定義表單

t］分期框nUM銷售訂單

匯率幣種備注

居表格，列表檔案示例

□零售日報

學自定義控件

已綁定實體：[SaleVgch.JM?l_E001]仔樹形編輯檔案示例

岸樹形控件L-a樹形導航檔案示例

才3若全0即次崛勃毒口2至白工。

□面板

貨物編號貨物名稱銷售計量單位銷售計量單位名稱計量單位組類別主計量單位編用

+卜調(diào)整欄

-主表

17銷售訂單號

17訂單日期

1客戶

17銷售部門

*業(yè)務員

發(fā)運方式

發(fā)往地址

付款條件

EI?幣種

17匯率

已綁定實體：［SeleV

訂單狀態(tài)

已綁定實體：[SaleW)uche_O(XM_EO)1]

青景色

設置控件的背景顏色.

當前布局視圖：新視圖界面

就緒開發(fā)模式［已獲取許可」

六、行為對象開發(fā)

行為對象開發(fā)是指增加表單或列表的功能按鈕，除了UAP系統(tǒng)自帶的功能按鈕外，還

可以增加按鈕，這些增加的功能按鈕是UAP表單開發(fā)的基礎。

UAP提供了多種增加功能的途徑，首先通過設計界面的樹形菜單中的“功能”節(jié)點下

的表單功能和列表功能的“功能管理”（圖表2）添加功能按鈕，這些功能按鈕最終在運

行時會被加載到U8產(chǎn)品的門戶上；其次可以為每個表單實體添加功能按鈕（圖表3）,為

實體添加完成這些功能按鈕后，還需要在布局視圖上為該表單實體的“功能”屬性設置使

用這些功能（圖表4）,這些功能按鈕最終在運行時會被加載到該實體的工具欄按鈕上。

圖表2圖表3圖表4

表單0x￥X屬性￥X

主表實體▼

國01電它口▼表格▼

攀僉J

B3銷售訂單

日標識

日一實體編號1SaleYouche_0001_E001《世」

白…自I主表類型列表實體B布局

:…U第一子表名稱主表國尺寸

日鼻敏760,306

白口布局視圖

發(fā)布狀態(tài)是鋪定邊絳Top,Left

日默認布局功能尊合）

?？縁ill

F]：i7功能狀態(tài)設置舞仔,

于占表單功能日數(shù)據(jù)田位置o,o

E數(shù)據(jù)弓擎業(yè)務對象［

1D="1e4T2d￡lB高級

「功能管理數(shù)據(jù)弓1孥模式使用已存在的對象

旨狀態(tài)設置物理表SO_SOMain綁定實體第一子表［SaleVouche

物理表模式使而已存在的對象

EE1回列表功能功能選擇保合）

行模式單行

:…受功能管理

主鍵ID控件口299fd7b5-0d￡d-4192-bd76

■主健類型%BE

顯示工具欄是

V過濾

正顯示

.L?s組件接口功色

編號規(guī)則實體的功能集合.視圖表格

樣式設置

圖表5

功能編輯

成員屬性

保存▲

標識

放

棄分隔條否

分

割

功能IDbtiiLast

提

交

2J末張

審

核

張

棄JJ

審

d22耒

復

制H

生

單

分

割

視

?圖

刷

?新

首

回

張

上

國

張工具欄和菜單

下

?矍是

y

名稱

一該功能按鈕在設計時的標識名稱。

增加區(qū)＞|刪除①）|

3A呻輸出|由中X0*9提交審核棄審復制生單的囹K《AM

|確定|取消|/

增加功能按鈕時，很多工作都可以通過上圖（圖5）的設計界面完成，開發(fā)人員關心

的僅僅是表單開發(fā)業(yè)務邏輯的實現(xiàn)。這些按鈕的作用主要是通過在運行時對模型對象中數(shù)

據(jù)的修改以及最終將修改的數(shù)據(jù)持久化來完成的。

UAP表單開發(fā)分為表單開發(fā)和列表開發(fā)兩種。因此對應了兩種不同的開發(fā)類型定義了

兩種不同的訪問模型對象數(shù)據(jù)的接口。

新增功能開發(fā)（鎖定、解