U9研发体系(自定义报表开发手册)

U9研发体系（自定义报表

开发手册）

文件编号：U9-SE-UBF-SPEC-REP0RT

版本号：

修改状态：0

编写人：郭玉平（二开总部）

审核人：X小东

适用对象

该规X适用于U9实施顾问二次开发人员。

版本记录

【此部分要记录该文档形成过程中的历次版本变更过程及变更的内容】

版修改与

修改时间修改原因修改概述审批人

本参与人

1.0郭玉平2008-07-15原始文档速立X小东

相关文档

U9研发体系（报表开发手册）

U9研发体系（报表开发规X）

名词解释

手册前3章介绍报表开发准备工作。

从第4章到第10章介绍了报表《林月生产计划与实绩统计》实际开发流程，在流程中的每

个步眺中介绍了使用UBF平台开发报表所涉及到的知识总。

第11章是一些知识点的详细介绍。

目录

第1章开发基础篇一U9系统的环境配置.......................................................8

1•1系At8

1.1.1Window2003标准版、企业版....................................................8

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

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

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

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

1.2开发环境............................................................................10

1.3运行时环境..........................................................................11

1.3.1需要运行两个服务...............................................................11

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

1.3.3配置U9站点、企业.............................................................13

1.4数据库的导出、导人.................................................................15

1.4.1数据犀导出....................................................................15

1.4.2数据导入....................................................................20

.使用“用友_数据管理工具”还原....................................20

.使用“用友_系统管理工具”还原....................................25

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

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

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

1.5.3建分析项目....................................................................29

1.5.4打开模型元数据管理..........................................................29

1.5.5连接报表元数据库..............................................................30

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

1.6报表服务器的配置...................................................................32

1.6.1安装运行SqlServerReportingServices.....................................................32

1.6.2配置报表服务站点Reportserver...................................................................33

1.6.3部署自定义报表的Dataoand..........................................................................33

第2章报表开发环境........................................................................34

2.1UBF介绍.............................................................................34

2.2报表开发环境.......................................................................35

2.3报表开发环境参数配置.............................................................35

2.3.1UBF环境设置...................................................................35

2.3.2UBF迨接到数据庠..............................................................36

2.3.3启动两个服务..................................................................36

2.3.4运行UBFdevenv.exe.....................................................................................37

2.3.5登录数据库服务品.............................................................38

2.3.6连接报表元数据库..............................................................39

第3章报表开发基础...................................................................41

3.1.1实体......................................................................41

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

3.1.3报表制作流程的简单介绍....................................................42

.Datanand设计...................................................42

,报表模板设计....................................................42

3.1.3.3.报表模板发布............................................42

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

第4章命名规X...................................................................43

4.1概论............................................................................43

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

4.3解决方案命名规则...............................................................43

4.4Datamand（报表数据）.........................................................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数据源命名.....................................................................53

7.6信息确认.......................................................................54

第8章编写Dadamand业务逻辑........................................................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参数..............................................................58

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

8.2.3舍・♦♦♦・・♦・♦・♦・・♦・・・♦・♦♦•・・♦・♦・・♦・♦・♦・・♦・♦・♦,♦♦♦♦・♦•♦・・♦・♦•♦59

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

8.2.5其它集合61

8.3缄写实例业务逻辑...............................................................61

8.3.1第一步：选取生产订单字段..................................................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删除余统琼定.义布局.........................................................70

9.2.2设计表头..................................................................70

9.2.3设计表体..................................................................71

9.3报表参数设计...................................................................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章发布浏览........................................................................77

11.1发布报表模板...................................................................77

11.1.1打开报表发布向导...........................................................77

11.1.2报表发布向导第一步：选择报表类型..........................................78

11.1.3报表发布向导第二步：程序集部署............................................79

11.1.4报表发布向导第三步:发布菜单..............................................80

11,1.5报袅发布向导第四步：报表部箸............................................81

11.1.6报表发布向导第五步:茏成.................................................82

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

11.3菜单授权...........................................................................83

11.3.1进入U9页面...............................................................83

11.3.2分配权限..................................................................84

.进入路径........................................................84

.执行操作........................................................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优势与比枚...................................................................93

12.5.3安装..........................................................................93

12.5.4语言指南......................................................................93

.对象查询语言OQL有两种风格...................................93

.筒单条件过滤...................................................93

.1.符单条件：...................................94

.2.多EntityJoin条件：........................................94

.3.OPath风格指定条件：...........................94

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

.5.逻辑或条件+参数..........................................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.数据库函数..................................................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类型转换函数的支持................................99

.17.leftright字符串函数.....................................99

.18.对Update&Delete语句的支持.............................100

.OQL风格指南....................................................100

.1.别名形式...................................................100

.2,主实体+相对于主实体开始的导航表达式....................101

.用户自定义函数与SQL标准函数..................................102

.临时表.........................................................102

12.5.4.7,全景体验...........................................104

12.5.5API娱程接口................................................................105

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

.Querypiler、piledQuery实例..................................105

.QueryBuiIder、piledQuery实例................................107

第1章开发基础篇一U9系统的环境配置

1.1系统环境

l.l.lWindow2003标准版、企业版

操作系统安装过程。

1.1.2Microsoft.netFrameworkV3.0

一个安装包，执行安装即可。

1.1.3IIS6.0

IIS6.0的安装位置在：

添加或删除程序/添加删除Windows组件/应用程序服务器/详细信息/Internet信息服务

(IIS)o

按照下图红色数字顺序，安装IIS6.0。

A下加秋田

r显示史骸①)排序方式c

VlBdoVS组群

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

上一次

细件位)

「齐索引取务0.0MBJtl

添加/拄除

Kindovs网络服务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:

点击【确定】、【下一步】后，系统提示插入操作系统光盘，可以插入系统光盘，如果没有系

统光盘，可以定位到操作系统文件夹的i386文件夹。

1.1.4IE7.0

一个安装包，执行安装即可。

1.1.5MSSQLServer2005

SQLServer安装过程中，安装到步骤“要安装的组件”时，请注意：

单击上图中的【高级】，打开下图：

|自MicrosoftSQLServer2005安据S序

功靠选择

话选择要安装的程序功能。

单击下列图标之一以更改功能的安装方式0

功能说明

国

数据库服务安装报表服务器，用于管理、执

SH-AnalysisServices行、呈现和分发报表。还清安装报

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

_J将安装到本地硬盘上

:整个功能将安装到本地硬盘上]

S---------整个功能将不可用

由……-X

此功能要求硬盘上有硬盘

由…•9466KB

S文档、示例和示例数据库空间。选择了此功能的2项子功能

中的0项。这些子功能要求硬盘上

有0KB磁盘空间.

帮助国）＜上一步也）||下一步堡）＞|取消|

对需要安装的组件”数据库服务"、"ReportingServices”请选择”整个功能将安装到本地

硬盘上”。

数据库'报表服务安装前请先浏览以下资料：

（SQLServer联机丛书》（帮助文档）

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开发环境

开发必备软件

请先安装下列软件并正确的配置UBFStudio的配置文件才能使用UBFStudio：

■Window2003标准版。

■Microsoft.netFrameworkV3.0°

系统需要安装Microsoft,netFrameworkV3.0。一定要注意Framework的版本»只有版本

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

UBFStudioV2.0不能正常运行，可以考虑检查一下当前启用的Fraiiew3k版本。

■MSSQLServer2005（可选）

如果使用本地数据库，则需要安装SQLServer2005；否则可以使用统一的数据库服务器而

无需在本机安装。

■版本管理工具（可选）

如果需要使用UBFStudioV2.0进行团队开发，则需要安装相应的版本管理工具4JBFStudio

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

ClearCase2003及以下版本。

安装配置好版本管理工具的服务端以后，在安装UBFStudio的机器上需要安装版本管理工

具的客户端。

如果本地运行Portal，还需要安装以下软件：

■IIS6.0

■SqlServerReportingServices

提供报表服务。

■IE7.0

U9客户使用，浏览器版本要求是IE7.0及以上。

L3运行时环境

1.3.1需要运行两个服务

Porta1\SysManageServer\ServiceHostingConsole.exe。

Porta1\App1icationServer\ServiceHostingConso1e.exe。

1.3.2设置IIS中的站点

■必需的两个站点：

令Portal：U9的portal，U9产品的入口。

Portal站点的对应的本地路径是U9产品中的文件夹

U9Product\U9.VOB.Product.U9\Portal，如果没有此站点，请创建。

令ReportServer：报表服务站点。

SqlSserver2005安装时如果选择安装报表服务，安装程序会创建此站点，如果没有安装

报表服务功能，请安装。

自定义报表开发后，需要把自定义报表的Datamand部署至“此站点下，

电Internet信息服务QIS）管理器

文件£）操作®查看9窗口电）帮助国）

g±H自由Ix囹囱哈国由空|>■ii

布Internet信息服务名航

B>jlMIAOQB冲地讨篁机）AgentConfig

EU应用程序池UWAX

□□网站」ApplicationLib

」ApplicationServer

」App_Code

App_GlobalResources

JApp_LocalResources

App_Themes

L«Jbin

国）Web服务扩展

」ClientSystemManage

JConfiguration

LJCS

JCSCoilaborationStyle

!」custom

■站点权限设置

请设置Portal'ReportServer站点的访问权限。

设置步骤按照下图标注的红色顺