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

U9研发体系（自定义报表

开发手册）

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

版本号：

修改状态：0

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

审核人：X小东

适用对象

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

版本记录

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

版修改与

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

本参与人

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

相关文档

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

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

名词解释

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

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

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

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

目录

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

1.1系统环境8

1.1.1Window2003标准版、企业版8

1.1.2Microsoft.netFrameworkV3.08

LL311S6.08

1.1.4IE7.09

LL5MSSQLServer20059

1.2开发环境10

1.3运行时环境11

1.3.1需要运行两个服务11

1.3.2设置HS中的站点11

1.3.3配置U9站点、、企业13

1.4数据库的导出、导人15

L4.1数据摩导出15

L4.2数据导入20

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

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

1.5模板的导入、导出28

1.5.1配置IDEConfig28

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安装运行SqlServerReportingServices32

1.6.2配置报表服务站点ReportServer33

1.6.3部署自定义报表的Dataioand33

第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.exe37

235整录数据库服务器38

23.6连接报表元数据库39

第3章报表开发基础41

3.1.1实体41

3.1.2OQL41

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

.Datamand设计42

3.1.3.2,报表模板设计42

3.1.3.3.报表模板发布42

.部署Datamand的dll，策略的dll42

第4章命名规X43

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章新建Dadamand50

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.cs55

8.1.2MODsExtend.cs56

8.1.3MOCmdExtend.cs57

8.1.4PubFunction.cs58

8.2Datamand主要属性、方法58

8.2.1ShowMode参数58

8.2.2EntityViewQuery•viewQuery59

8.2.3报表相关集合59

8.2.4ExecuteDataReaderO59

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导入Datamand69

9.2模板布局设计70

9.2.1删除系统预定义布局70

9.2.2设计表头70

9.2.3设计表体71

9.3报表参数设计73

9.3.1基本属性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

ILL1打开报表发布向导77

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

ILL3报表发布向导第二步:程序集部署79

ILL4报表发布向导第三步：发布菜单80

IL1.5报表发布向导第四步：报表部署81

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

11.2部署Datamand82

11.3菜单授权83

11.3.1进入U9页面83

11.3.2分配权限84

11.3.2.1.进入路径84

11.3.2.2.执行操作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

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

12.5.4.2,简单条件过滤93

12.,简单条件：94

12..多EntityJoin条件：94

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

12..Betweenand94

12..逻辑或条件+参数94

.6.in94

.7.like¬like95

12.5.4.3,复杂报表查询95

.1.兼容性注意问题95

12..基本语法95

12.5.4.3.3.使用实体类95

12..from子句96

.5.leftjoin96

.6.innerjoin96

.7.Crossjoin96

.8.Distinct关键字97

12..数据库函数97

12.0.Count97

12.1.Min-Max97

12.2.Groupby97

.13.子查询97

.14.子查询97

.15.对dateadd/datediff/datepart/datename中关键字的支持99

12.6.对cast类型转换函数的支持99

12.7.leftright字符串函数99

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

12.5.4.4.OQL风格指南100

12..别名形式100

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

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

12.5.4.6.临时表102

12.5.4.7.全景体验104

12.5.5API编程接口105

12.5.5.1.QueryParser105

12.5.5.2.Querypiler、piledQuery实例105

12.5.5.3.QueryBuilder、piledQuery实例107

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

1.1系统环境

1.1.1Window2003标准版、企业版

操作系统安装过程。

1.1.2Microsoft.netFrameworkV3.0

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

1.1.3IIS6.0

IIS6.0的安装位置在：

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

(IIS)。

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

事添加或删除程序

Windows馈件向导厂显示更新①)樗序方式《

Yindovs组件

可以添加或删除Tindows的组件.

要添加或删除某个姐件，请单击旁边的复选椎.灰色檐表示只会安装该犯件的

翻一部分。要查看蛆件内容，语单击“详细信息”.

蛆件©:

|加索引服务

添加/■赊

Windows网络服务

组件®ea曾应用程序服务需

［匚事证书服务1

1.4MB--应用程序服务器

IJ终端服冬寒0.0MB.Ll

某个蛆件，调单击旁边的尊忠S・灰色桩表示F

触ASP.NET,Int.rn.t信息服务(IIS)和应用程序服务疆控制犯件内容，值单密“评油荷瓦”.

所需磁盘空间:应用程序服务器的子组件C)：

4详细信息也)...

可用磁盘空间:|一金)ASFNET

号£Internet信息服务,QIS)

▼多启用网络C0i+访问

<上一步@|下一步⑨>|取消|帮助□⑥启用网络DTC访问

二誓消息队列

Z箍应用程序服务器控制台

得JMicrosoft.NETFramework2.0语言■包-简体中文

Microsoft,NETFrM«work3.0S*rv>c«Pack1描逑：IIS包括V«b,FTP,SMTP和NNTP支持，以及对F>

Extension和ActiveServerPage(ASP)的支持.

序Microsoft.HETFr»ework3.0简体中文语言包

押MicrosoftDeviceHaulatorversion1.0-CHS

.MicrosoftDocumentExplorer2005所需磁盘空间:3.3MB

可用磁盘空间：23153.5MB

DocumentExplorer2005遥言包-简体中文

Microsoft16确定

%MicrosoftOffice2003WebComponents

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

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

1.1.4IE7.0

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

1.1.5MSSQLServer2005

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

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

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

硬盘上”。

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

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

1、安装SQLServer2005

ms-help://MS.SQLCC.v9/MS.SQLSVR.v9.zh-CHS/instsql9/html/3c580cdd-la4b-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/instsql9/html/bba36555-7ad7-4al7-ac3e

-dd092d62372c.htm

4、报表服务ReportServe的详细配置介绍请参考《报表服务配置.ppt）。

1.2开发环境

开发必备软件

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

■Window2003标准版。

■Microsoft.netFrameworkV3.0°

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

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

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

■MSSQLServer2005（可选）

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

无需在本机安装。

■版本管理工具（可选）

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

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

ClearCase2003及以下版本。

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

具的客户端。

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

■IIS6.0

■SqlServerReportingServices

提供报表服务。

■IE7.0

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

1.3运行时环境

1.3.1需要运行两个服务

Portal\SysManageServer\ServiceHostingConsole.exe。

Porta1\App1icationServer\ServiceHostingConsole.exe°

1.3.2设置IIS中的站点

■必需的两个站点：

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

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

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

令ReportServer:报表服务站点。

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

报表服务功能，请安装。

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

■Internet信息服务（IIS）管理器

文件更）操作。）查看9窗口也）帮助但）

包函|X直国通图回|空►■n

F.Internet信息服务名称__________________

E-JMIAOQB住地计算机）」AgentConfig

S一J应用程序池一JAJAX

白」网站ApplicationLib

□管默认网站」ApplicationServer

国•占ClassView

」App_Code

由¥Portal二App_GlobalResources

Reports

App_LocalResources

ReportServer

二App_Themes

Saspnet_client

」bin

国-」jWeb服务扩展

ClientSystemManage

Configuration

」CS

CSCoilaborationStyle

custom

■站点权限设置

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

设置步骤按照下图标注的红色顺序号1234，第1步需在站点名称上单击右键，

第4步：用户名中填写的用户林需要对站点中的文件有完全访问权限。设置后确定。

fInternet信息服务（ns）管理器

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

0亡|旬国X囱目白畲回空I>・II

「:Internet信息服务名称1路径1状况

白手MIAOQB建地计篁机）bin

日」应用程序池」Pages

国Q&DefaultAppPool」ReportBuilder

由任

ReportServer_JStyles

F一J网站jCatalog.sql

白管默认网站

\C&talogTempDB.sql

S1审ClassView

Iglobal,asax

S-A)Portal

1.ReportsIModelGenerationRules.smgl

|山”JReportServerj工JE1

Easpnet_client

国一JWeb展务扩展虚拟目录I文档I目录安全性limp头I自定义错误|ASP.MTI

身份验证和访问控制

3___________

身份垃证方法［编辑@）一」

t或

编辑①).…|

用户访问需经过身份跄证

使用以下身嚼幅嘉看下磐件下，要求用户名和密码:

服翎证书⑼.

儒/榔翡需列表限制了访问权限

-11查看证书如一

厂集成Windows身份验证如）编辑S…

报表服务ReportServe的详细配置介绍请参考《报表服务配置.ppt)°

1.3.3配置U9站点、企业

打开系统管理工具Portal\ClientSystemManage\UFIDA.UBF.SystemManage.exe

登录：

■系统管理工具

系统管理工具是管理企业和系统监控的工具。

U9的系统管理工具包括两部分，有系统管理工具和数据管理工具。这些功能用来对U9进行

分布式部署和运行期的监控，该工具部署在控制服务器上。

系统管理工具功能结构图：

系统管理工具可以做很多管理工作，我们只需关注以下两点：

■配置U9站点：

按照下图红色数字顺序，配置数据库服务器。

同配置数据库服务器类似配置呢b服务器。

■配置企业

按照下图红色数字顺序，配置企业。

”吼鼻凝检3妾1

系统（5）帮助Q0

一个企业实际是一个数据库，配置企业的过程就是用系统管理工具恢复数据库的过程，需要

注意的是数据库中需要一个CLR配置文件，CLR是dll文件，与数据库备份文件bak同时管

理，U9系统中对数据库的访问有的是通过CLR配置文件实现。

配置完站点、企业后，请重启：

令IIS：iisreset

令Porta1\SysManageServer\ServiceHostingConsole.exe

令Porta1\App1icationServer\ServiceHostingConsole.exe

系统管理工具的详细手册请参考帮助文档，位置如下图所示：

1.4数据库的导出、导入

U9中每个公司对应一个数据库，产品的运行需要先创建数据库，但是自定义报表开发的过

程中需要一些数据，所以直接导入一个有数据的数据库对开发报表、代码调试方便。

1.4.1数据库导出

数据库导出、导入工具是“用友—数据管理工具”。

位置：

\\Product\Portal\ClicntSysten】Manage\UFIDA.UBF.SystenManage.DataManageTooLexe，

初始密码:123456

登录

单击确认后，再单击“系统工具/数据管理”进入如下界面：

单击上图企业数据维护下的数据备份进入界面：

单击目标按钮

浏览

']U8SourceCode±1

JU8二次开发

B-OU9

OU9

Q]U9.VOB.PD.SCM

u9Data

OV9Test

OV9vleode

-O内开发

Ozjs

U)View

:WindowsApplicationl

WindowsApplication2

口天津

Q客户问题

O工作总结

口程序安装部署

口网站

口虚拟光驱

C1软件备份

选择文件

确定I取消

选择bak文件或选择目录填写bak文件名,单击确定回到前面页面，并单击页面选项：

单击

根据需要选择追加到现有备份集或者覆盖所有现有备份集，

单击确认进行数据备份生成.BAK。

L4.2数据导入

数据库的导入还原有两种途径：

1、使用“用友—数据管理工具”还原。

2、使用“用友—系统管理工具”还原。

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

使用“用友—数据管理工具”迁原，方法如下：

企业数据维护下的数据还原，进入如下界面：

单击选择

原文件

BAK

单击源文件按钮，进入选择后缀为bak的文件页面

单击选择CLR配置按钮，进入选择UFIDA.u9.SQL.CLRlib.dll文件

浏览

!"Ogyp23

BOjdf

Dixd

1Ipxzl

BO产品

，白口京东方数据库备份

UFIDA.U9.SQL.CLRLib.dll

:日口后东方报表源码

Q]U9ReportForJBF

Q自定义报表模板

臼Q京东方需求设计文档

Q京东方报表定制开发

a加密狗驱动

;参照信息-1

口开发工具

O报表容器及报表目录所涉及的数据库表

O文档手册

O用户手册

!补丁

L-CJ表样▼[

选择文件|D:\jd-产品,京东方数据库备份\UF1DA.U9.SQL.CLRLib.dll

确定|取消

单击确定

将还原checkbox框选中‘单击确认进入如下界面

选择.mdf与.Idf文件后,单击确认进行数据库恢复

1.4.2.2.使用“用友—系统管理工具”还原

“系统管理工具”

位置：Porta1\C1ientSystemManage\UFIDA.UBF.SystemManage.exe

登录：

初始密码：123456

单击企业管理

单击右边企业管理中的新增按钮

单击“基本信息设置”数据库——创建，打开创建界面：

创建数据库填写信息：

1、“数据库"（标识1）需要填写创建的数据库名称。

2、“数据文件"（标识2）是创建的数据库的数据文件，单击一J选择数据文件的存储位置，

如：D:\DB\，后面的“\U9ERP_JDF.mdf”是工具自动添加上的。

3“日志文件”（标识3）是创建的数据库的日志文件，单击一J选择日志文件的存储位置'

如：D:\DB\，后面的,,\U9ERP_JDF_log.Idf"是工具自动添加上的。

4、“CLR配置"（标识4）是数据库使用的DLL文件，一般情况是与备份文件（标识5）一块保

存。

5、“备份文件”（标识5）是数据库导出的备份文件。

6、“还原checkbox"（标识6）:请注意不要忘•记选择。

填写完成后，单击【创建】。

1.5模板的导入、导出

自定义报表模板的导入导出是利用UBF平台的报表模型元数据管理工具。

报表模型元数据管理工具的位置比较隐蔽，需要按照以下步躲找到打开。

1.5.1酉己置IDEConfig

设置UBF\UBFStudio\IDEConfig.xml文件中的Options节RuntimeForReportDesigner属性

为false，即：<0ptionsRuntimeForReportDesigner-'falsen>°

地址也)回D:Wie)VOB.Product.UB八UBFStudio1

文件和文件夹任务VIDEConfig.xml2

wIDEMapFunctionTypeList.xml

箕它位置、Tccol「nminnnPicEQ+ORO+OUCL

■IDEConfig.xml一记事本

文件（I）编辑@）格式查看W）帮助鱼）

详细信息

<?xmlversion="1.0"encoding="utf-8"?>

IDEConfig.xal<!—^UFSoft.UBF.CodeGeneratorJejQpUteTransConfig.xmlggc

XML文档<OptionsRuntimeForReportDesigne3

<!-假径配置要求都是相对路径，路径的拴谁是UBFSEdi。的路径

修改日期：2008年।

14:04<!-属性里设置的是测试用例生成路径，目前未用。

n

太小•2RRKR<CommonTestTargetPath=",,\..\..\>

1.5.2新建解决方案

1.5.3建分析项目

方案类型必须是分析项目，如下图：

1.5.4打开模型元数据管理

上面界面点击确定后，就会出现一个报表开发界面，暂时不要关注其他信息，请打开菜单报

表/模型元数据管理，操作过程如下图：

用友集成开发环境

文件查看编辑

FIB

；白手胃uId

工具箱不dDL

报表控件

\指针

\线

□矩形

Rb文本框

L4I图像

周绑定数据块

IB标签

□表

□矩阵

图表

八Kmm

1.5.5连接报表元数据库

操作过程如下图：

报表元数据库连接后

■报表根苴元数据管理

So][ReportRootCatalog]言详钿信息口新建⑥，

由•匕AP

@㈡ARReportRootCatalog

(+1IjJJBen

田」B0MReportRootCat«Log

aocosr

3qCKP名称I类型1创建者I包则间

田心GL

SAP分类目录u9kxi2006-9-114:06.09

3I匚3NyRcport

「AR分类目录u9kxl2006-7-615:4445

SKI

口分类目录udliaoqs2007-9-2021:21.22

川nwoBen

।J|BOM分类目录u9zhoxocn>2007-8-1612:2522

⑷_JPvy

口COST分类目录U9jiaxy2OJ7-8-1115:28.06

3_|SCM

田;「QC_jCRP