自定义报表、打印模板开发学习笔记
一、基础了解
1、UBF开发工具的了解
Ideconfig.xml配置
True：打印、报表设计模式
False：单据设计模式
2、开发环境试用
BE：实体项目
BF：操作项目
SV：服务项目
分析项目：打印模板
报表应用项目：报表
二、简单设计报表
1、登录连接
（1）、登录UBF后，连接报表元数据库。
1个报表容器下只能存放1张报表。每新建1张报表，需新建1个报表容器。
（2）、增加数据源
选择“BusinessEntity”表示采用实体建立报表；
选择“StoredProcedure”表示采用存储过程建立报表；
选择“Text”表示采用SQL语句建立报表。
2、实体建立报表：
（1）、新建报表容器、报表
（2）、连接数据源
技巧：server name这个里面输入数据库服务器IP地址比点倒进行三角选择，速度快得多噢！
（3）、增加数据查询
（4）、选择实体（可以选择，也可以选择查找实体，使用查询实体会更快一点）
（5）、选择需要的字段
点击保存后字段即可出现在左边的“字段”栏目中。
将上面在BE中查询的字段选择显示到列表后，可以点击UBF自动的查询功能来预览数据，可以用UBF自带的工具翻译成SQL语句到MSSQL查询里面去查询。（OQL语句支持SQL语句的格式，可根据SQL语句格式自动编辑）如下图：
（6）、字段扩展属性
a、字段扩展属性说明
备选栏目：发布后在报表查询方案的栏目字段中显示在“待选项”列表中；
固定栏目：显示显示在“已选项”列表中；
默认栏目：系统默认显示在“已选项”列表中；
选择了“备选栏目”后，选择了“固定栏目”则此字段用户无法从“已选项”中移去（此字段为必选项）；
选择了“备选栏目”后，选择了“默认栏目”，则此字段会默认显示在“已选项”中，但用户可以自行移去此字段。
如果三个栏目都选择了，则与选择了“备选栏目”和“固定栏目”的效果相同。
b、行分组
（7）、建立查询条件
a、选择菜单上的“报表参数”建立查询条件。
在弹出的报表参数设置窗口中左边点击右击“添加条件项”，在基本属性页签中点击fx，选择条件表达式。点击参照页签，选择该条件的相应字段。
允许为空：选择后，此查询条件可以不输入，不选择则为必输项。
是否可见：不出现此字段。
是否固定条件：此条件字段不可删除（一定要使用此字段），用户可以设置成无需输入，但根据实际情况这样无意思，设置成固定字段肯定是必输项。
选择绑定的字段！
b、参照
参照标签可以设置多种参照方法（根据相应的英文字母可知意思）；
nothing：表示无
reference：可以调协参照值。
实际ID：选择参照的实体；
参照ID：选择一个类型样子的参照即可。（可理解为当作模型使用）
c、建立完查询条件后，到报表主页上“数据”页签中，修改数据查询。在查询参数页签上，点击“添加默认”按钮，确认退出。如不操作，查询条件将不起作用。
报表查询设置的结束如下图所示。
（8）、报表页面布局
根据用户想要实现的模样、拖动报表控制到右边的布局窗口，同样将字段根据用户想要的模样、顺序依次进行拖到表格中。用户可以利用右边的报表属性进行调整报表的样式。
（9）、技巧：BE实例查询可当数据字典使用
上述用BE实体建立报表，在平时做报表时这个功能用的非常少，现在我多半用这个功能来当数据字典来用。原因：
A、U9数据库更新频繁，但数据字典不能及时更新，有时会出现在数据字典中找不到字段的情况。
B、个人觉得BE实体查字段速度及效果比较直观。
C、只有需要知道字段意义的时候方需要翻翻数据字典，但是这个方法也可以省略。技巧：
IE打开的U9单据页面，用IE自带的开发功能(F12)就能捕捉到对应的字段名称，而且前台字段名称与后台字段名称是相同的，这样很方便。如下图：
3、sql语句建立报表
（1）、建立数据源、数据查询
建立数据源方法与上述建立实体查询一样，数据查询时，因为是sql语句建立报表，固选择“Text”。
（2）、根据需求编写SQL语句
a、根据需求可以先编写OQL语句，再翻译成SQL语句，将编译成功后的SQL语句，复制到窗口中。
b、点击预览查询结果，下面的窗口中可查询结果，左边的“字段”窗口中会显示出SQL查询语句中选择的字段。
（3）、同样可以根据需求设置已选字段的扩展属性（此步方法同实体建立报表时的字段扩展属性）
（4）、查询方案（报表参数设置）
报表参数设置方法也同实体报表中的报表参数设置方法。
（5）、报表页面布局方法也与上述实体报表项目时页面布局方法相同。
（6）、分析实际需求编码OQL语句，编写OQL语句可以参照辅助资料，数据字典、实体查询工作（classview）等；有时这些工具更新的比较慢，建议大家可以建立一个实体查询的报表，利用实体查询报表中的查询实体来查询实体名称。这样比较准确。
用户可以使用UBF自带的OQL翻译工具（报表菜单中）来翻译编写的OQL语句，经本人测试，UBF自带的OQL翻译工具比classview带的翻译功能执行速度快的多。
4、存储过程建立报表
三、复杂报表
（1）、DataCommand代码生成向导
（2）、选择服务品名称，生成路径。
（3）、往下根据向导进行选择字段。
（4）、VS打开生成的DataCommand，点击生成。
（5）、UBF中导入Data Command（在导入之前需要新建报表容器）
（6）、发布应用。
（7）、找到生成发布在Portal下的dll文件，用U9管理控制台工具上传到SQL报表服务器目录中。
ClientSystemManage目录下：UFIDA.U9.MO.Report.DataCommand.dll
UBFV21目录下：UFIDA.U9.UserDefine.MO.Report.DataCommand
（也可以将生成的DataCommand\Bin\Debug中的这两个文件用来上传即可）
修改Buildup.xml中的地址，可以使用UBF发布工具。
四、查询二开
1、BE查询
2、列表查询
3、DTO查询
（1）、将：D:\UFIDA\UBFV21\U9.VOB.Product.Component\Unconfiged\Component中的
复制到：D:\UFIDA\U9V21\Portal\ApplicationServer\Libs
（2）、将：D:\UFIDA\UBFV21\U9.VOB.Product.Component\Unconfiged\Component中的
复制到：
D:\UFIDA\U9V21\Portal\ApplicationLib
（3）、布置UI，将D:\UFIDA\UBFV21\U9.VOB.Product.WebPart中的
复制到：D:\UFIDA\U9V21\Portal\UILib
（4）、执行源数据。地址在：D:\UFIDA\UBFV21\U9.VOB.Product.Other中的两个文件中的SQL脚本都要执行。执行时先执行Metadata，再执行Resource。
五、开发实例
单据打印分组
UBF中打印单据分组有两种方法，一种是用菜单上“报表”－分组，一种是表行是右击添加分组，两种方法各有优异。以出货单按品名分组汇总出货数量为例子！
1、菜单上的分组功能
（1）、选择菜单“报表——分组”，找开分组设置局面。
（2）、选择依据字段，这里面是“品名”，选择结束拆页，即可在一个品种结束时，下一个品种显示在下一页。
（3）、确定返回到主设置界面，设置合计字段，这里面是出货数量。本页合计函数是：PageSum，本单合计函数是：Acc PageSum。
、
（4）、格式调整调整，正常保存、发布即可使用了！
说明：菜单中的分组功能有两点不足：
（1）、在最后打印的单据时的效果有不足之处，比如当一个料品在第一页显示时表头上会留有空行，如果这个品种行数多了显示到第二页去，则在第二页时表头就没有空行了，这样显示的效果欠佳。
（2）、报表分组后，每遇到一个新的品种就会分页显示，如果一些品种行数少，一页上打印了几个就换下一个品种下一页了，那么就会造成纸张的浪费。（当然了这需要根据客户要求，如果客户一定要一个品种一份，那也没办法）。此功能上有“结束处是否拆页”，如果设置成不分页，就会出现分断显示了。
针对上述不足，使用地“表行”中的分组功能可以一一得到解决。
2、表行分组
（1）、在表行上右击选择“增加（组）”打开增加组窗口。
（2）、选择分组表达式（分组依据），记下分组名称“Table_Group_1”，分组结束后拆页，根据实际情况选择，如果需要一种品种结束分页，就选择上，如果不需要一个品种结束时拆页就不选择。如果未选择，则就会在同一张单据上打印，共用表头也不会留空白，能解决上面方法一中浪费纸张的问题。
（3）、确定后会默认出来两行分组行，根据需求，是将分组数放在上面还是下面，删除其中一行，这里面要求将分组数据放在下面，则我们删除第一行。
（4）、这里面的函数选择group sum，格式如下。
（5）、调整好格式，正常保存发布即可。
注意：行分组函数是groupsum，数据源为此报表中的table序号，有的时候我们同时打开多张报表模板，table的序号会自动连续编写下去，我们一定要以当前报表中的table序号为准，否则就会报错。这里面一张报表中只有一个table，在分组时就会显示table_group_1
如果用户不想在行中显示以品种合并的数量，也可以右击把合计行删除了，删除合计行并没有将分组依据删除，依据仍然还在，如果真正想删除分组依据，需要右击选择“删除所有分组”。
需要技术支持：飞翔信息技术科技有限公司 - 公司介绍
