U9研發(fā)體系(自定義報表開發(fā)手冊)

U9研發(fā)體系（自定義報表

開發(fā)手冊）

文件編號：U9-SE-UBF-SPEC-REP0RT

版本號：

修改狀態(tài)：0

編寫人：郭玉平（二開總部）

審核人：X小東

適用對象

該規(guī)X適用于U9實施顧問二次開發(fā)人員。

版本記錄

【此部分要記錄該文檔形成過程中的歷次版本變更過程及變更的內(nèi)容】

版修改與

修改時間修改原因修改概述審批人

本參與人

1.0郭玉平2008-07-15原始文檔速立X小東

相關文檔

U9研發(fā)體系（報表開發(fā)手冊）

U9研發(fā)體系（報表開發(fā)規(guī)X）

名詞解釋

手冊前3章介紹報表開發(fā)準備工作。

從第4章到第10章介紹了報表《林月生產(chǎn)計劃與實績統(tǒng)計》實際開發(fā)流程，在流程中的每

個步眺中介紹了使用UBF平臺開發(fā)報表所涉及到的知識總。

第11章是一些知識點的詳細介紹。

目錄

第1章開發(fā)基礎篇一U9系統(tǒng)的環(huán)境配置.......................................................8

1?1系At8

1.1.1Window2003標準版、企業(yè)版....................................................8

1.1.2Microsoft.netFraiaeworkV3.0.............................................................8

1.1,3IIS6.0.........................................................................................................8

1.1.4IE7.0...........................................................................................................9

1.1.5MSSQLServer2905......................................................................................9

1.2開發(fā)環(huán)境............................................................................10

1.3運行時環(huán)境..........................................................................11

1.3.1需要運行兩個服務...............................................................11

1.3.2設置I1S中的玷*.............................................................11

1.3.3配置U9站點、企業(yè).............................................................13

1.4數(shù)據(jù)庫的導出、導人.................................................................15

1.4.1數(shù)據(jù)犀導出....................................................................15

1.4.2數(shù)據(jù)導入....................................................................20

.使用“用友_數(shù)據(jù)管理工具”還原....................................20

.使用“用友_系統(tǒng)管理工具”還原....................................25

1.5模板的導入、導出...................................................................28

1.5.1配置IDEConfig............................................................................................28

1.5.2新建解決方案..................................................................29

1.5.3建分析項目....................................................................29

1.5.4打開模型元數(shù)據(jù)管理..........................................................29

1.5.5連接報表元數(shù)據(jù)庫..............................................................30

1.5.6模板導入、導出................................................................31

1.6報表服務器的配置...................................................................32

1.6.1安裝運行SqlServerReportingServices.....................................................32

1.6.2配置報表服務站點Reportserver...................................................................33

1.6.3部署自定義報表的Dataoand..........................................................................33

第2章報表開發(fā)環(huán)境........................................................................34

2.1UBF介紹.............................................................................34

2.2報表開發(fā)環(huán)境.......................................................................35

2.3報表開發(fā)環(huán)境參數(shù)配置.............................................................35

2.3.1UBF環(huán)境設置...................................................................35

2.3.2UBF迨接到數(shù)據(jù)庠..............................................................36

2.3.3啟動兩個服務..................................................................36

2.3.4運行UBFdevenv.exe.....................................................................................37

2.3.5登錄數(shù)據(jù)庫服務品.............................................................38

2.3.6連接報表元數(shù)據(jù)庫..............................................................39

第3章報表開發(fā)基礎...................................................................41

3.1.1實體......................................................................41

3.1.2OQL..................................................................41

3.1.3報表制作流程的簡單介紹....................................................42

.Datanand設計...................................................42

,報表模板設計....................................................42

3.1.3.3.報表模板發(fā)布............................................42

.部署Datanand的dll?策略的dll...............................42

第4章命名規(guī)X...................................................................43

4.1概論............................................................................43

4.2ReportTemplate（報表模版）...................................................43

4.3解決方案命名規(guī)則...............................................................43

4.4Datamand（報表數(shù)據(jù)）.........................................................43

第5章需求、設計......................................................................44

5.1需求............................................................................44

5.1.1樣表......................................................................44

5.1.2裝興......................................................................45

5.1.3表體......................................................................45

5.2設計............................................................................46

5.2.1查找條件..................................................................46

5.2.2欄目說明..................................................................46

5.2.3算法說明..................................................................47

第6章新建報表模板...................................................................48

6.1第一步：新建報表目錄...........................................................48

6.2第二步：新建報表容器...........................................................49

6.3第三步：新建報表頁面...........................................................49

第7章新建Dadamand..............................................................50

7.1打開Dadamand工具集..........................................................51

7.2建立Dadamand目錄............................................................51

7.3選擇字段.......................................................................52

7.3.1查詢實體..................................................................52

7.3.2選擇屬性（字段）............................................................52

7.4配置字段信息...................................................................53

7.5數(shù)據(jù)源命名.....................................................................53

7.6信息確認.......................................................................54

第8章編寫Dadamand業(yè)務邏輯........................................................54

8.1主要編程界面簡介...............................................................55

8.1.1MoDs.cs..............................................................55

8.1.2MODsExtend.cs........................................................56

8.1.3JfOCmdExtend.cs........................................................57

8.1.4PubFunction.cs........................................................58

8.2Datamand主要屬性、方法......................................................58

8.2.1ShovMode參數(shù)..............................................................58

8.2.2EntityViewQuery:viewQuery.........................................59

8.2.3舍?????????????????????????????????????????,???????????????59

8.2.4ExecuteDataReaderO...........................................................................................59

8.2.5其它集合61

8.3緘寫實例業(yè)務邏輯...............................................................61

8.3.1第一步：選取生產(chǎn)訂單字段..................................................61

8.3.2第二步：選取完工報告字段..................................................64

8.3.3第三步：連接后時表.........................................................66

8.3.4第四步：定義臨時表.........................................................66

8.3.5第五步：生成解決方案.......................................................67

第9章報表模板設計...................................................................68

9.1導入Datamand................................................................................................................69

9.2模板布局設計...................................................................70

9.2.1刪除余統(tǒng)瓊定.義布局.........................................................70

9.2.2設計表頭..................................................................70

9.2.3設計表體..................................................................71

9.3報表參數(shù)設計...................................................................73

9.3.1墓#4性..................................................................74

9.3.2拿照.......................................................................74

9.3.3操作符列裊................................................................75

9.4字段的擴展屬性.................................................................75

第10章報表欠理策略...................................................................76

10.1策略概念.......................................................................76

10.2編寫策略方法...................................................................76

10.3配置策略文件...................................................................76

第11章發(fā)布瀏覽........................................................................77

11.1發(fā)布報表模板...................................................................77

11.1.1打開報表發(fā)布向?qū)?..........................................................77

11.1.2報表發(fā)布向?qū)У谝徊剑哼x擇報表類型..........................................78

11.1.3報表發(fā)布向?qū)У诙剑撼绦蚣渴?...........................................79

11.1.4報表發(fā)布向?qū)У谌?發(fā)布菜單..............................................80

11,1.5報裊發(fā)布向?qū)У谒牟剑簣蟊聿矿?...........................................81

11.1.6報表發(fā)布向?qū)У谖宀?蘢成.................................................82

11.2部署Datamand.....................................................................................................................82

11.3菜單授權...........................................................................83

11.3.1進入U9頁面...............................................................83

11.3.2分配權限..................................................................84

.進入路徑........................................................84

.執(zhí)行操作........................................................84

11.4效果預覽...........................................................................85

11.4.1查詢界面..................................................................85

11.4.2效果界面..................................................................85

第12章高城話題........................................................................86

12.1報表中嵌入代碼.................................................................86

12.2彈性域..........................................................................88

12.2.1彈性域概念....................................................................88

12.2.2在模板中使用彈性域............................................................88

12.3存儲過程的訓用................................................................91

12.4任意條件的擷取.................................................................91

12.5Oql的使用方法................................................................92

12.5.1基本功能......................................................................92

12.5.2優(yōu)勢與比枚...................................................................93

12.5.3安裝..........................................................................93

12.5.4語言指南......................................................................93

.對象查詢語言OQL有兩種風格...................................93

.筒單條件過濾...................................................93

.1.符單條件：...................................94

.2.多EntityJoin條件：........................................94

.3.OPath風格指定條件：...........................94

.4.Betweenand..................................94

.5.邏輯或條件+參數(shù)..........................................94

.6.in.........................................94

.7.like¬like................................95

.復雜報表查詢....................................................95

.1.兼容性注意問題.............................................95

.2.基本語法....................................................95

.3,使用實體類..................................................95

.4.from子句...................................................96

.5.leftjoin....................................96

.6.innerjoin..................................96

.7.Crossjoin...................................96

.8.Distinct關鍵字...........................................97

.9.數(shù)據(jù)庫函數(shù)..................................................97

.10.Count......................................97

.11.Min，Max...................................97

12.5.4.3.12.Groupby.............................97

.13.子查詢......................................................97

.14.子查詢.....................................................97

.15.對dateadd/datediff/datepart/datename中關鍵字的支持....99

.16.對cast類型轉換函數(shù)的支持................................99

.17.leftright字符串函數(shù).....................................99

.18.對Update&Delete語句的支持.............................100

.OQL風格指南....................................................100

.1.別名形式...................................................100

.2,主實體+相對于主實體開始的導航表達式....................101

.用戶自定義函數(shù)與SQL標準函數(shù)..................................102

.臨時表.........................................................102

12.5.4.7,全景體驗...........................................104

12.5.5API娛程接口................................................................105

12.5.5.1.QueryParser...................................................105

.Querypiler、piledQuery實例..................................105

.QueryBuiIder、piledQuery實例................................107

第1章開發(fā)基礎篇一U9系統(tǒng)的環(huán)境配置

1.1系統(tǒng)環(huán)境

l.l.lWindow2003標準版、企業(yè)版

操作系統(tǒng)安裝過程。

1.1.2Microsoft.netFrameworkV3.0

一個安裝包，執(zhí)行安裝即可。

1.1.3IIS6.0

IIS6.0的安裝位置在：

添加或刪除程序/添加刪除Windows組件/應用程序服務器/詳細信息/Internet信息服務

(IIS)o

按照下圖紅色數(shù)字順序，安裝IIS6.0。

A下加秋田

r顯示史?、?排序方式c

VlBdoVS組群

可以添加或Bi除Yindcvx的組件.

上一次

細件位)

「齊索引取務0.0MBJtl

添加/拄除

Kindovs網(wǎng)絡服務2.6NB

組件如

3<應用程序摳哥胃34.4NB

中證書服務14MB-'

，終端解臺熟0.0MB二J

筠迷豕囪皿小，?z信函務aw弧用崢服務器出

所需班盒空間3.31?

4詳細信息依).

可用磁盤空間23153.5HB

〈上一步G)|下一步Qp>|取消

園MicrosoftNETFrsnork2,0語言包-簡體中文

MicrosoftNETFrsevrork3.0ServicePack1

LglMicrosoftNET

Yrsrork3.0僧體中爻譜言包

MicrosoftD?ric?Enulfttorvarsion1.0-CMS

MicrosoftDocumentExplorer2005

gglllicrosoftDocu??ntExplorer2005語言包-福體中文

%MicrosoftOffice2003V?bCo?pon?nt:

點擊【確定】、【下一步】后，系統(tǒng)提示插入操作系統(tǒng)光盤，可以插入系統(tǒng)光盤，如果沒有系

統(tǒng)光盤，可以定位到操作系統(tǒng)文件夾的i386文件夾。

1.1.4IE7.0

一個安裝包，執(zhí)行安裝即可。

1.1.5MSSQLServer2005

SQLServer安裝過程中，安裝到步驟“要安裝的組件”時，請注意：

單擊上圖中的【高級】，打開下圖：

|自MicrosoftSQLServer2005安據(jù)S序

功靠選擇

話選擇要安裝的程序功能。

單擊下列圖標之一以更改功能的安裝方式0

功能說明

國

數(shù)據(jù)庫服務安裝報表服務器，用于管理、執(zhí)

SH-AnalysisServices行、呈現(xiàn)和分發(fā)報表。還清安裝報

ReportingServices表生成器以即席生成報表.

_J將安裝到本地硬盤上

:整個功能將安裝到本地硬盤上]

S---------整個功能將不可用

由……-X

此功能要求硬盤上有硬盤

由…?9466KB

S文檔、示例和示例數(shù)據(jù)庫空間。選擇了此功能的2項子功能

中的0項。這些子功能要求硬盤上

有0KB磁盤空間.

幫助國）＜上一步也）||下一步堡）＞|取消|

對需要安裝的組件”數(shù)據(jù)庫服務"、"ReportingServices”請選擇”整個功能將安裝到本地

硬盤上”。

數(shù)據(jù)庫'報表服務安裝前請先瀏覽以下資料：

（SQLServer聯(lián)機叢書》（幫助文檔）

1、安裝SQLServer2005

ms-help://MS.SQLCC.v9/MS.SQLSVR.v9.zh-CHS/instsq19/htm1/3c580cdd-1a4b-40bl-bf6b

-3clee31eelbe.htm

2、安裝SQLServer組件幫助主題

ms-help://MS.SQLCC.v9/MS.SQLSVR.v9.zh-CHS/instsql9/html/b920fba6-9822-4db7-a84d

-7bc306004b8c.htm

3、ReportingServices安裝幫助主題

ms-help://MS.SQLCC.v9/MS.SQLSVR.v9.zh-CHS/instsq19/html/bba36555-7ad7-4al7-ac3e

-dd092d62372c.htm

4、報表服務ReportServe的詳細配置介紹請參考《報表服務配置.ppi》。

1.2開發(fā)環(huán)境

開發(fā)必備軟件

請先安裝下列軟件并正確的配置UBFStudio的配置文件才能使用UBFStudio：

■Window2003標準版。

■Microsoft.netFrameworkV3.0°

系統(tǒng)需要安裝Microsoft,netFrameworkV3.0。一定要注意Framework的版本?只有版本

匹配UBFStudioV2.0才能正常運行。小技巧：由于Framework2.0和3.0可以共存，如果

UBFStudioV2.0不能正常運行，可以考慮檢查一下當前啟用的Fraiiew3k版本。

■MSSQLServer2005（可選）

如果使用本地數(shù)據(jù)庫，則需要安裝SQLServer2005；否則可以使用統(tǒng)一的數(shù)據(jù)庫服務器而

無需在本機安裝。

■版本管理工具（可選）

如果需要使用UBFStudioV2.0進行團隊開發(fā)，則需要安裝相應的版本管理工具4JBFStudio

V2.0支持的版本管理工具有MSVisualSourceSafeV6.0（或更高版本），以及IBMRational

ClearCase2003及以下版本。

安裝配置好版本管理工具的服務端以后，在安裝UBFStudio的機器上需要安裝版本管理工

具的客戶端。

如果本地運行Portal，還需要安裝以下軟件：

■IIS6.0

■SqlServerReportingServices

提供報表服務。

■IE7.0

U9客戶使用，瀏覽器版本要求是IE7.0及以上。

L3運行時環(huán)境

1.3.1需要運行兩個服務

Porta1\SysManageServer\ServiceHostingConsole.exe。

Porta1\App1icationServer\ServiceHostingConso1e.exe。

1.3.2設置IIS中的站點

■必需的兩個站點：

令Portal：U9的portal，U9產(chǎn)品的入口。

Portal站點的對應的本地路徑是U9產(chǎn)品中的文件夾

U9Product\U9.VOB.Product.U9\Portal，如果沒有此站點，請創(chuàng)建。

令ReportServer：報表服務站點。

SqlSserver2005安裝時如果選擇安裝報表服務，安裝程序會創(chuàng)建此站點，如果沒有安裝

報表服務功能，請安裝。

自定義報表開發(fā)后，需要把自定義報表的Datamand部署至“此站點下，

電Internet信息服務QIS）管理器

文件￡）操作?查看9窗口電）幫助國）

g±H自由Ix囹囪哈國由空|>■ii

布Internet信息服務名航

B>jlMIAOQB沖地討篁機）AgentConfig

EU應用程序池UWAX

□□網(wǎng)站」ApplicationLib

」ApplicationServer

」App_Code

App_GlobalResources

JApp_LocalResources

App_Themes

L?Jbin

國）Web服務擴展

」ClientSystemManage

JConfiguration

LJCS

JCSCoilaborationStyle

!」custom

■站點權限設置

請設置Portal'ReportServer站點的訪問權限。

設置步驟按照下圖標注的紅色順