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

U9研发体系（自定义报表开发手册）文件编号：U9-SE-UBF-SPEC-REPORT版本号：修改状态：0编写人：郭玉平（二开总部）审核人：刘小东适用对象该规范适用于U9实施顾问二次开发人员。版本记录【此部分要记录该文档形成过程中的历次版本变更过程及变更的内容】版本修改与参与人修改时间修改原因修改概述审批人1.0郭玉平2008-07-15原始文档建立刘小东相关文档U9研发体系（报表开发手册）U9研发体系（报表开发规范）名词解释手册前3章介绍报表开发准备工作。从第4章到第10章介绍了报表XX月生产计划与实绩统计实际开发流程，在流程中的每个步骤中介绍了使用UBF平台开发报表所涉及到的知识点。第11章是一些知识点的详细介绍。 目 录第1章 开发基础篇-U9系统的环境配置1.1 系统环境1.1.1 Window 2003 标准版、企业版操作系统安装过程。1.1.2 Microsoft .net Framework V3.0一个安装包，执行安装即可。1.1.3 IIS6.0IIS6.0的安装位置在：添加或删除程序/添加删除Windows组件/应用程序服务器/详细信息/Internet信息服务(IIS)。按照下图红色数字顺序，安装IIS6.0。点击【确定】、【下一步】后，系统提示插入操作系统光盘，可以插入系统光盘，如果没有系统光盘，可以定位到操作系统文件夹的i386文件夹。1.1.4 IE7.0一个安装包，执行安装即可。1.1.5 MS SQL Server 2005SQL Server安装过程中，安装到步骤“要安装的组件”时，请注意：单击上图中的【高级】，打开下图：对需要安装的组件“数据库服务”、“Reporting Services”请选择“整个功能将安装到本地硬盘上”。数据库、报表服务安装前请先浏览以下资料：SQL Server 联机丛书(帮助文档)1、安装 SQL Server 2005 ms-help:/MS.SQLCC.v9/MS.SQLSVR.v9.zh-CHS/instsql9/html/3c580cdd-1a4b-40b1-bf6b-3c1ee31ee1be.htm2、安装 SQL Server 组件帮助主题 ms-help:/MS.SQLCC.v9/MS.SQLSVR.v9.zh-CHS/instsql9/html/b920fba6-9822-4db7-a84d-7bc306004b8c.htm3、Reporting Services 安装帮助主题ms-help:/MS.SQLCC.v9/MS.SQLSVR.v9.zh-CHS/instsql9/html/bba36555-7ad7-4a17-ac3e-dd092d62372c.htm4、报表服务ReportServe的详细配置介绍请参考报表服务配置.ppt。1.2 开发环境开发必备软件请先安装下列软件并正确的配置UBF Studio的配置文件才能使用UBF Studio：n Window 2003 标准版。n Microsoft .net Framework V3.0。系统需要安装 M Framework V3.0。一定要注意Framework的版本，只有版本匹配UBF Studio V2.0才能正常运行。小技巧：由于Framework 2.0和3.0可以共存，如果UBF Studio V2.0 不能正常运行，可以考虑检查一下当前启用的Framework版本。n MS SQL Server 2005（可选）如果使用本地数据库，则需要安装SQL Server 2005；否则可以使用统一的数据库服务器而无需在本机安装。n 版本管理工具（可选）如果需要使用UBF Studio V2.0进行团队开发，则需要安装相应的版本管理工具。UBF Studio V2.0支持的版本管理工具有MS Visual SourceSafe V6.0（或更高版本），以及IBM Rational ClearCase 2003及以下版本。安装配置好版本管理工具的服务端以后，在安装UBF Studio的机器上需要安装版本管理工具的客户端。如果本地运行Portal，还需要安装以下软件：n IIS 6.0n Sql Server Reporting Services提供报表服务。n IE7.0U9客户使用，浏览器版本要求是IE7.0及以上。1.3 运行时环境1.3.1 需要运行两个服务PortalSysManageServer ServiceHostingConsole.exe。PortalApplicationServer ServiceHostingConsole.exe。1.3.2 设置IIS中的站点n 必需的两个站点： Portal：U9的portal，U9产品的入口。Portal站点的对应的本地路径是U9产品中的文件夹U9ProductU9.VOB.Product.U9Portal，如果没有此站点，请创建。 ReportServer：报表服务站点。Sql Sserver 2005安装时如果选择安装报表服务，安装程序会创建此站点，如果没有安装报表服务功能，请安装。自定义报表开发后，需要把自定义报表的DataCommand部署到此站点下。n 站点权限设置请设置Portal、ReportServer站点的访问权限。设置步骤按照下图标注的红色顺序号1234，第1步需在站点名称上单击右键，第4步：用户名中填写的用户帐号需要对站点中的文件有完全访问权限。设置后确定。报表服务ReportServe的详细配置介绍请参考报表服务配置.ppt。1.3.3 配置U9站点、企业打开系统管理工具PortalClientSystemManageUFIDA.UBF.SystemManage.exe登录：n 系统管理工具系统管理工具是管理企业和系统监控的工具。U9的系统管理工具包括两部分，有系统管理工具和数据管理工具。这些功能用来对U9进行分布式部署和运行期的监控，该工具部署在控制服务器上。系统管理工具功能结构图：系统管理工具可以做很多管理工作，我们只需关注以下两点：n 配置U9站点：按照下图红色数字顺序，配置数据库服务器。同配置数据库服务器类似配置Web服务器。n 配置企业按照下图红色数字顺序，配置企业。一个企业实际是一个数据库，配置企业的过程就是用系统管理工具恢复数据库的过程，需要注意的是数据库中需要一个CLR配置文件，CLR是dll文件，与数据库备份文件bak同时管理，U9系统中对数据库的访问有的是通过CLR配置文件实现。配置完站点、企业后，请重启： IIS：iisreset PortalSysManageServer ServiceHostingConsole.exe PortalApplicationServer ServiceHostingConsole.exe系统管理工具的详细手册请参考帮助文档，位置如下图所示：1.4 数据库的导出、导入U9中每个公司对应一个数据库，产品的运行需要先创建数据库，但是自定义报表开发的过程中需要一些数据，所以直接导入一个有数据的数据库对开发报表、代码调试方便。1.4.1 数据库导出数据库导出、导入工具是“用友_数据管理工具”。位置：ProductPortalClientSystemManageUFIDA.UBF.SystemManage.DataManageTool.exe，初始密码：123456单击单击确认后，再单击“系统工具/数据管理”进入如下界面：单击企业数据维护下的数据备份单击上图企业数据维护下的数据备份进入界面：单击单击目标按钮选择bak文件或选择目录填写bak文件名，单击确定回到前面页面，并单击页面选项：单击单击根据需要选择追加到现有备份集或者覆盖所有现有备份集，单击确认进行数据备份生成.BAK。1.4.2 数据导入数据库的导入还原有两种途径：1、使用“用友_数据管理工具”还原。2、使用“用友_系统管理工具”还原。. 使用“用友_数据管理工具”还原使用“用友_数据管理工具”还原，方法如下：企业数据维护下的数据还原，进入如下界面：单击选择原文件BAK单击源文件按钮，进入选择后缀为bak的文件页面单击选择CLR配置按钮，进入选择UFIDA.u9.SQL.CLRlib.dll 文件单击确定选中将还原checkbox 框选中，单击确认进入如下界面选择.mdf与.ldf 文件后，单击确认进行数据库恢复. 使用“用友_系统管理工具”还原“系统管理工具”位置：PortalClientSystemManageUFIDA.UBF.SystemManage.exe登录：初始密码：123456单击企业管理单击右边企业管理中的新增按钮单击单击“基本信息设置”数据库创建，打开创建界面：创建数据库填写信息：1、“数据库”(标识1)需要填写创建的数据库名称。2、“数据文件”(标识2)是创建的数据库的数据文件，单击选择数据文件的存储位置，如：D:DB， 后面的“U9ERP_JDF.mdf”是工具自动添加上的。3 “日志文件”(标识3)是创建的数据库的日志文件，单击选择日志文件的存储位置，如：D:DB， 后面的“U9ERP_JDF_log.ldf”是工具自动添加上的。4、“CLR配置”(标识4)是数据库使用的DLL文件，一般情况是与备份文件(标识5)一块保存。5、“备份文件”(标识5)是数据库导出的备份文件。6、“还原checkbox”(标识6)：请注意不要忘记选择。填写完成后，单击【创建】。1.5 模板的导入、导出自定义报表模板的导入导出是利用UBF平台的报表模型元数据管理工具。报表模型元数据管理工具的位置比较隐蔽，需要按照以下步骤找到打开。1.5.1 配置IDEConfig设置UBFUBFStudioIDEConfig.xml文件中的Options节 RuntimeForReportDesigner属性为false，即：。1.5.2 新建解决方案1.5.3 建分析项目方案类型必须是分析项目，如下图：1.5.4 打开模型元数据管理上面界面点击确定后，就会出现一个报表开发界面，暂时不要关注其他信息，请打开菜单 报表/模型元数据管理，操作过程如下图：1.5.5 连接报表元数据库操作过程如下图：报表元数据库连接后1.5.6 模板导入、导出单击选择报表目录、报表容器或报表模板，右键单击打开菜单，选择导出、导入命令，操作过程如下图：导出界面：导入界面：模板的导出、导入使用场景一般是： 在从开发环境导出，导入到测试环境或导入到正式生产环境。 从一个开发人员的机器导出，导入到另外一个开发人员的机器，模板交流使用。1.6 报表服务器的配置1.6.1 安装运行Sql Server Reporting Services 请查看提供报表服务的机器是否已经安装Sql Server Reporting Services，因为自定义报表最终要调用sql server的报表服务(Sql Server Reporting Services)实现。如果未安装，请先按安装。1.6.2 配置报表服务站点ReportServer配置报表服务站点ReportServer，配置过程请参考。1.6.3 部署自定义报表的DataCommand复制自定义报表的DataCommand到文件夹：U9.VOB.Product.U9ReportServerReportServerLib运行报表服务器配置工具，界面如下图位置：U9.VOB.Product.U9ReportServerToolReportServerSetting-WinformReportServerSetting-Winform.exe配置介绍：1、U9门户安装目录：是指Portal站点的“本地路径”。2、报表服务Dll目录：是指U9.VOB.Product.U9ReportServerReportServerLib，注意：当前运行的报表服务配置工具的目录是U9.VOB.Product.U9ReportServerToolReportServerSetting-Winform注意二者关系。3、报表服务安装目录：是指Sql Server Reporting Services安装目录，安装时如果选择默认，是：C:Program FilesMicrosoft SQL ServerMSSQL.3Reporting ServicesReportServer4、报表服务目录安装时如果选择默认，是：C:Program FilesMicrosoft SQL ServerMSSQL.3Reporting ServicesReportServer与3相同。5、报表服务URL：是报表ReportServer站点的位置。请参考。设置好后，单击配置。此配置过程就是把DataCommand的dll部署到报表服务的ReportServerbin文件夹下，并且修改Reporting ServicesReportServerrssrvpolicy.config文件的配置。配置完站点、企业后，请重启： IIS：iisreset PortalSysManageServer ServiceHostingConsole.exe PortalApplicationServer ServiceHostingConsole.exe第2章 报表开发环境2.1 UBF介绍报表开发是UBF开发平台的一个子模块，先了解一下UBF平台。UBF(Ufida Business Framework)开发平台：采用元数据驱动的、分布式的、面向服务的架构，它提供了统一的编程抽象模型，是一个适合应用软件开发及部署的全角色平台。UBF Studio是一套完整的基于模型驱动开发的可视化开发工具，用于建立企业应用产品业务分析模型。UBF Studio开发工具包中包含业务模型开发工具、用户交互界面开发工具、流程设计开发工具、报表设计工具、打印风格格式设计器、规则开发工具、商业智能元模型开发工具等，全部集成在集成开发环境中（IDE），该环境允许用户在其中完成全部应用开发的关键工作。UBF Studio可以和VSS和CC联合起来以支持大规模团队的离散式开发。如需详细了解UBF的使用，请参考UBF2.0使用手册(环境搭建）.doc、UBF2.0使用手册（简介）.doc、UBF2.0使用手册（使用）.doc。2.2 报表开发环境自定义报表开发是在UBF平台上进行的U9相关报表的开发工作。自定义报表开发主要包括三部分内容：报表模板开发、报表数据源选择、报表业务逻辑编写。报表模板开发：是利用UBF开发平台中的报表开发功能实现。报表数据源选择：是利用UBF开发平台中的DataCommand生成工具找到业务逻辑所涉及到的实体，选择出所需实体、所需属性作为报表的数据源。生成工具会创建一个项目，项目中的文件保存着数据源的信息。报表业务逻辑编写：主要是在生成的数据源项目中的ProcessData()方法中添加所需业务逻辑。报表模板是一个XML文件集，存储在数据库中。DataCommand生成工具生成的项目，其中包含数据源信息文件，业务逻辑方法，就统称为DataCommand。DataCommand是一个有固定文件结构、代码结构的Visual Studio 2005的项目，可用Visual Studio 2005编写、编译。报表模板是报表的展示模板。DataCommand是报表展示的内容。对报表的总体介绍请参考A04 用友技术大会UAP_U9报表_070606.ppt。2.3 报表开发环境参数配置2.3.1 UBF环境设置设置UBFUBFStudioIDEConfig.xml文件中的Options节 RuntimeForReportDesigner属性为。，UBF开发自定义报表项目。，UBF可以开发其他项目，详细资料请参考UBF2.0使用手册（使用）.doc。2.3.2 UBF连接到数据库因为开发中使用的报表模板文件、实体模型等相关信息都是存储在数据库中，做自定义报表开发的前提是把UBF环境连接的到一个存储着模板文件、实体模型等信息的数据库上。这个数据库就是U9中的公司对应的数据库。打开UBF Studio V2.0的安装目录中的UBF UBFStudioRuntime environment.xml文件，编辑environment.xml文件修改数据库配置。该配置文件中有关数据库连接的内容示例如下：packet size=4096;user id=u9test;Connection Timeout=150;Max Pool size=1500;data source=u9ubfdb;persist security info=True;initial catalog=u9test;password=u9test其主要配置项的含义如下： data source=u9ubfdb：表示数据库的服务器名 initial catalog=u9test：表明数据库名 user id=u9test：表示数据库的用户名 password=u9test：指明登录密码请根据所使用数据库的具体情况配置。2.3.3 启动两个服务1、PortalSysManageServer ServiceHostingConsole.exe2、PortalApplicationServer ServiceHostingConsole.exe这两个服务是UBF、Portal运行的基础，每次打开UBF或访问Portal都需要保证服务已经启动。为方便创建快捷方式到桌面。2.3.4 运行UBFdevenv.exe运行UBFUBFStudioUBFdevenv.exe运行后2.3.5 登录数据库服务器点击登录菜单登录界面一个企业对应一个数据库。组织是企业下的组织，在同一个数据库中。详细信息在2.1节中介绍。用户、密码U9中用户、密码，不是sql server的“登录名”以及对应密码。用户、密码可以为空。2.3.6 连接报表元数据库单击报表资源管理中的连接，点击报表元数据库报表元数据库打开后，系统报表、用户自定义报表显示如下图：我们以后所开发的自定义报表都属于用户定义报表。到此，开发环境配置完成。第3章 报表开发基础3.1.1 实体从实际角度理解：实体：实际业务的基本单元在U9中称为实体。简单实体可以理解为是数据库中的一张表的一条记录。但是如果实体有些复杂，用一个表结构无法准确、完整描述，或者可以描述但是比较复杂，就需要设计多个表关联描述一个实体。从程序角度理解：实体：实体就是一个对象。对实体属性的读取、赋值类似于对程序中类对象的使用。实体与数据库表记录间的关系：可以理解为的对象、关系映射，即ORMapping，是模型层的一种处理对像的方式。3.1.2 OQLOQL：Object Query Language是UBF中操作实体的语言，类似于sql，但比sql简单、方便。具有以下特点：1、Object Query Language提供了一种基于对象的查询语言。 2、支持OPath语法风格的路径表达式。3、支持属于多个Entity的多列。4、OO风格指定列：如OrderLine.Order.Customer.ContactName。5、支持聚合函数，SQL99标准函数（基于Entity语义）。6、支持列间表达式计算。7、支持Group & Order & As(列别名)。8、支持Entity View定义，可以在Query定义中使用已有的Entity View!9、支持名空间的使用，支持中文。10、引入from子句，可支持left join, right join, full join, cross join。11、在select, from, where子句中支持子查询。12、用OQL别名指代OPath, 使OQL的表达更加简洁。13、UDF(User Defined Function)的直接支持。14、union, union all。15、临时表的支持。16、OQL风格指南。17、对风格a ？b ：c 条件表达式和Case When 表达式的支持。18、对标准日期时间函数的支持。19、对cast/convert类型转换函数的支持。20、支持Update & Delete语句。详细介绍请参考 3.1.3 报表制作流程的简单介绍. DataCommand设计新建一个空报表模板打开DataComand代码生成工具，应用设计器设计DataComand模型。生成代码，添加业务逻辑。. 报表模板设计导入DataCommand生成缺省报表模板。应用报表设计器设计报表模板。. 报表模板发布报表模板发布后，需要给帐号授权。. 部署DataCommand的dll，策略的dllDataCommand的dll是查询数据，策略是控制报表格式/数据处理的功能（调用报表元数据服务）。第4章 命名规范4.1 概论报表的开发，涉及策略、业务编程、报表工具多个方面的设计。为了保证报表开发模式的一致性，制定了该规范。4.2 ReportTemplate（报表模版）解决方案命名规则名称：领域名称名称+RptTemplate组成。粒度：一个领域一个解决方案项目命名规则名称：服务组名称；粒度：一个服务组一个项目报表命名规则名称：报表名称4.3 解决方案命名规则名称：领域名称名称+RptProcessStrategy组成。粒度：一个领域一个解决方案项目命名规则名称：UFIDA.U9.服务组.Report.ProcessStrategy粒度：一个服务组一个项目项目装配件属性命名规则名称：UFIDA.U9.服务组.Report.ProcessStrategy命名空间属性命名规则名称：UFIDA.U9.服务组.Report.ProcessStrategy4.4 DataCommand（报表数据）解决方案命名规则名称：领域名称+RptDataCommand组成。粒度：一个领域一个解决方案项目命名规则名称：UFIDA.U9.服务组.Report.DataCommand粒度：一个服务组一个项目项目装配件属性命名规则名称：UFIDA.U9.服务组.Report.DataCommand命名空间属性命名规则名称：UFIDA.U9.服务组.Report.DataCommand类命名规则DataCommand类命名 ：报表名称CmdDataSource类命名 ：报表名称Ds第5章 需求、设计从本章起将完整的介绍一个报表的开发过程，报表的名称是XX月生产计划与实绩统计，此报表是京东方茶谷项目的自定义报表。报表功能：查询符合过滤条件的生产订单、与其匹配的完工报告，统计以下内容：计划投入、计划产出、标准产出率、实际完成、合格数量、良率、实际入库，按“客户部门分类物料”分类汇总。5.1 需求5.1.1 样表XX月生产计划与实绩统计的需求描述文档是Excel表，如下表：XX月生产计划与实绩统计统计期间：起始时间 2008-01-01 截止时间 2008-01-31部门客户分类机种（料品）计划投入计划产出标准产出率实际完成合格数量良率实际入库制造一科友达小尺寸 59.01A16.01110000900090.00%9000890098.89%900059.02A16.00210000900090.00%9000890098.89%900059.02A16.00610000900090.00%9000890098.89%900059.02A16.01410000900090.00%8990890099.00%899059.02A16.01510000900090.00%8990890099.00%8990小计5000045000449804450044980中尺寸59.08A16.015500004990099.80%4990049900100.00%4990059.08A16.016500004990099.80%499004980099.80%4990059.08A16.017500004990099.80%499004988099.96%4990059.08A16.020500004990099.80%500004990099.80%5000059.08A16.024500004990099.80%499904987099.76%4999059.08A16.027500004990099.80%499994989099.78%49999小计300000299400299689299240299689客户小计60000 58900 58989 58790 58989 部门小计60000 58900 344669 343740 344669 制造二科林光小尺寸 林光2.0-0210000.0 10000.0 100.00%99900.0 99000.0 99.10%90000.0 林光2.5-0110000.0 10000.0 100.00%99900.0 99000.0 99.10%90000.0 林光2.5-0210000.0 10000.0 100.00%99900.0 99000.0 99.10%90000.0 林光2.5-0310000.0 10000.0 100.00%99900.0 99000.0 99.10%90000.0 林光2.5-0410000.0 10000.0 100.00%99900.0 99000.0 99.10%90000.0 林光2.5-0510000.0 10000.0 100.00%99900.0 99000.0 99.10%90000.0 小计10000.0 10000.0 99900.0 99000.0 90000.0 客户小计70000.0 70000.0 699300.0 693000.0 630000.0 松下中尺寸松下1.55000.0 4900.0 98.00%5000.0 49900.0 998.00%5000.0 松下1.85000.0 4900.0 98.00%4990.0 4990.0 100.00%4990.0 小计5000.0 4900.0 98.00%4800.0 4800.0 100.00%4800.0 客户小计15000.0 14700.0 14790.0 59690.0 14790.0 部门小计85000.0 84700.0 714090.0 752690.0 644790.0 合计145000.0 143600.0 1058759.0 1096430.0 989459.0 5.1.2 表头报表标题：XX月生产计划与实绩统计。统计期间：统计期间的起始日期、结束日期。5.1.3 表体报表栏目数据来源：部门：生产订单生产部门 。客户：料品档案品名所属客户。分类：根据完工报告单物料.版本 后续处理料品分类库存分类。机种（料品）：生产订单料品.版本。计划投入：生产订单“生产数量”。计划产出：生产订单“MRP数量”。标准产出率：计划产出/计划投入。实际完成：根据生产订单“单号.版本”和当前统计期间取得 完工报告单“完工数量”。合格数量：根据生产订单“单号.版本”和当前统计期间取得 完工报告单“合格数量”。良率：合格数量/实际完成。实际入库：根据生产订单“单号.版本”和当前统计期间取得 完工报告单“实际入库数量”。5.2 设计5.2.1 查找条件以下为查询条件默认说明，未做特殊说明均表示：l 遵循多组织查询规范l 条件间为and关系。l 条件为空表示全部。l 条件默认值为空。l 条件参照对应档案值列表（须有查询权限）l 均包含失效过期档案。l 档案记录参照选择的合法范围，应遵循多组织查询规范约定：条件指定单一物流组织，则选取该组织下的档案记录条件指定了多个物流组织，则只能选取当前组织下的档案记录查询条件来源取值方式内容约束生产部门生产订单实体.生产部门多选当前登录组织所属的部门客户物料.品名.客户段多选当前登录组织的料品分类分类.分类编码分类名称多选只能选择分类.分类体系“库存”的分类机种物料.料号编码多选当前登录组织的物料档案统计日期日期FromTo用户输入5.2.2 栏目说明栏目名称对应数据项算法显示顺序行分组列分组排序备选栏目表头统计期间从条件画面带入表体部门A.部门Y客户A.客户Y分类A.分类Y机种（料品）A.物料计划投入A.计划投入计划产出A.计划产出标准产出率计划产出/计划投入实际完成A.实际完成合格数量A.合格数量良率合格数量/实际完成实际入库A.实际入库5.2.3 算法说明A查找生产订单实体，生成集合A栏目：生产订单：生产订单实体.ID 部门：生产订单实体.生产部门 客户：生产订单实体.物料.客户段 分类：生产订单实体.物料.分类 物料：生产订单实体.物料 计划投入：生产订单实体.生产数量 计划产出：生产订单实体.MRP数量 实际完成： 合格数量： 实际入库：条件：生产订单实体.组织当前登录组织 生产订单实体.生产部门 in （条件.生产部门） 生产订单实体.物料.客户段 in （条件.客户） 生产订单实体.物料.分类编码 in （条件.分类） 生产订单实体.物料 in （条件.机种） 生产订单实体.计划完工日 between （条件.统计日期从，统计日期到） 生产订单实体.业务类型 “计划生产” 生产订单实体.状态 “开立”B查找完工报告实体，统计集合A的其他值条件： 循环集合A的每一条记录 完工报告实体.生产订单A.生产订单 完工报告实体.完工日期 between（条件.统计日期从，统计日期到） 完工报告实体.状态 “开立”计算： A.实际完成sum（完工报告实体.完工数量）注意计量单位的一致。 A.合格数量sum（完工报告实体.首检合格数量）注意计量单位的一致。京东方增加：描述性弹性域增加两个扩展字段，分别叫做首检合格数量和累计返工数量，该报表合格数量直接取首检合格数量。 A.实际入库sum（完工报告实体.实际入库数量）注意计量单位的一致。C处理集合A，生成报表数据：将集合A按“客户部门分类物料”分类汇总，生成报表数据，并按行分组栏目生成小计和合计。第6章 新建报表模板本章介绍如何新建报表模板。进入路径：用友集成开发环境菜单文件登录，输入用户名，密码，如图所示：点击文件,登录 进入路径： 用友集成开发环境窗体右侧 报表资源管理连接报表元数据库，打开报表资源管理6.1 第一步：新建报表目录在窗口右侧的ReportRootCatalog目录下单击右键，选择新建报表目录，建立新目录报表制作;如图所示6.2 第二步：新建报表容器定位到 报表制作 单击右键，选择，新建报表容器，弹出如图所示对话框：6.3 第三步：新建报表页面在生产计划与实绩统计目录下，单击右键，选择 新建报表， 如图所示：打开创建报表对话框，输入 生产计划与实绩统计报表制作，点击确定,完成报表条目的建立。最终效果如下图所示：第7章 新建DadaCommand本章介绍如何新建DadaCommand。DadaCommand是为报表提供数据集的项目，DadaCommand中需要选择实体字段、编写业务逻辑，本章主要介绍如何选择实体字段，业务逻辑编写在 中介绍。7.1 打开DadaCommand工具集点选菜单报表DadaCommand工具集DadaCommand代码生成7.2 建立DadaCommand目录按照命名规则，输入服务器名称： MORptTemplate;指定磁盘路径:D:MO，点击下一步：指定DadaCommand的服务组名称和生成路径7.3 选择字段7.3.1 查询实体输入实体名称，当前实体信息即可在下方显示出来，同时可指定该实体的别名。7.3.2 选择属性(字段)界面操作：在选中实体信息的下方打勾，即代表选中此字段，将设计文档中所需字段全部选中后，点击确认。点此选中点击此按钮可以返回上级目录模糊查找实体实体层次结构选择实体字段所选这段根据文档需求列表如下：生产订单.生产部门MO_Department生产订单.IDMO_ID生产订单.料品MO_ItemMaster生产订单.MRP数量MO_MRPQty生产订单.生产数量MO_ProductQty生产订单.组织MO_Org生产订单.计划完工日MO_CompleteDate生产订单.业务类型MO_BusinessType生产订单.状态MO_DocState料品.名称段2ItemMaster_NameSegment2料品.库存分类ItemMaster_StockCategory料品.品名ItemMaster_Name料品.料号ItemMaster_Code精度MO.ProductUOM.Round7.4 配置字段信息各参数代表含义：报表参数进入报表前的查询参数结果栏目在报表界面中固定展示栏目缺省列系统自动设置，默认值是否排序所选字段是否排序是否可选所选字段是否是可选的是否行组所选字段是否以行进行分组是否列组所选字段是否以列进行分组行列分组动态选定指定列排序默认列固定栏目查询参数指定各字段的参数信息若有遗漏，点选选择字段，若检查无误后，点选下一步。7.5 数据源命名建立数据源 根据命名规则，指定DataSource名称：MODs;指定DataCommand名称： MOCmd;指定DataSource和DataCommand名称7.6 信息确认确认无误后，点击完成。第8章 编写DadaCommand业务逻辑DadaCommand代码生成工具完成后， 系统自动生成以下目录：目录层次如下：Xml文件公共函数调试代码实体字段业务逻辑编写系统类库引用8.1 主要编程界面简介8.1.1 MoDs.cs主要预定义了在DadaCommand代码生成工具中选取的字段及其参数等的设置。如图所示：8.1.2 MODsExtend.cs主要提供了可扩展功能，可在此文件里添加用户自定义字段如图所示：8.1.3 MOCmdExtend.cs用户可以扩展业务逻辑。也是我们主要的工作部分。如图所示：业务逻辑是显示在这里定义的8.1.4 PubFunction.cs程序所用到的公共函数，可以定义在这里，如图所示：8.2 DataCommand 主要属性、方法DataCommand 是利用 报表服务传递过来的 报表参数，Selects，Groups ，Orders 等集合组织一个取数的逻辑。在编写DataCommand业务逻辑前需要先了解DataCommand的结构，本节简单介绍DataCommand结构中的主要属性、方法。8.2.1 ShowMode 参数ShowMode0：表示返回空的临时表，在报表第一次展现或者报表业务处理逻辑出现错误时，返回空的临时表。ShowMode1 ，执行正常的报表逻辑，该常数在AbsReportDataCommand的已经做过处理。8.2.2 EntityViewQuery ： viewQuery EntityViewQuery：viewQuery该对象主要用来执行Oql返回数据，创建临时表。注意：利用该对象执行Oql时，需要使用一个数据库连接，该连接的状态有基类 BaseReportDataCommand来维护，在报表子类中不要处理，在整个报表业务逻辑处理要确保使用一个EntityViewQuery，不要使用 New EntityViewQuery 来创建。8.2.3 报表相关集合报表处理过程中UI、DataCommand