U9自定义报表U9客户化开发支持部苗庆波2009年06月18日课程编号：DataCommand设计DataCommand编程导入DataCommand，设计模板报表处理策略发布部署DataCommand概念DataCommand使用场景数据源涉及到多个实体，实体间无强关联，需要建立连接数据业务逻辑复杂，需要中间计算过程，使用OQL或SQL实现逻辑不清晰从多个数据源取数DataCommand是构建报表数据源的程序集为复杂的u9报表组织数据的代码逻辑单元,它继承抽象基类AbsReportDataCommand（定义了报表的执行过程），可以通过UBF中实现报表数据扩展来实现对DataCommand的调用，最终返回报表展现需要的数据BaseReportDataCommand生存周期DataCommand编程-DataCommand生存周期AbsReportDataCommand基类应用DataCommand类DataCommand设计—继承关系设置解决方案信息选择实体信息选择字段信息设置DataCommand信息确认信息生成DataCommand设计—利用向导创建报表报表代码生成向导，弹出 解决方案对话框DataCommand设计—利用向导创建(1)服务组名称：请在列表中选择一个服务组，该服务组名称决定了项目的名称。如：选了Base : 则项目名称是： UFIDA.U9.Base.Report.DataCommand.如果以前生成过该项目，再次选择时会列出该项目的 生成路径，DataCommand模型，现有项等信息。并会把本次生成的 DataCommand,DataSource ,DataCommandTest 等文件加入到当前选中的项目中。生成路径：生成的报表项目的存放路径。DataCommand模型：如果选择了DataCommand模型，就会把您上一次选择的信息，显示出来，可以在该基础上进行修改。现有项：现有项中列出了 该项目中已经存在的DataCommand和DataSoruce的名称如果只想生成DataSource .,选择 只生成 DataSource复选框点击下一步就会直接跳到 DataCommandInfo对话框选择一个数据源，然后填写 DataCommand名称，控制参数后，点击确定即可。DataCommand设计—利用向导创建(2)选择字段在实体名称中输入要查询的实体点击查询会列出你查询的实体信息注意： 粗体部分表示可以双击，进入该实体或者属性类型来选择它下面的字段属性。点击下一步 弹出 选择字段信息对话框点击 选择字段 按钮 ，弹出 选择实体信息对话框DataCommand设计—利用向导创建(3)报表参数：表示该字段是否作为报表参数。结果栏目： 表示是否作为结果集临时表列。缺省列: ：如果选了该复选框，则在导入DataCommand时生成报表模板时生成该列。是否排序：对应查询方案的排序待选项。是否可选：对应查询方案的栏目待选项。是否行组：对应查询方案的行分组待选项。是否列组：对应查询方案的列分组待选项。点击 确认 弹出 选择的所有属性对话框DataCommand设计—利用向导创建(4)在该对话框中输入 DataCommand ，DataSource 名称 ，如果该DataCommand有控制参数 ，则在控制参数DataGrid中添加 控制参数添加控制参数的名称，标签，是否多值(表示该控制参数从UI过来是一个值还是多个值),类型。选择完成后，注意： 对于多值的参数，类型现在只能选择字符串类型，选择了其它类型也不起作用。在该对话框中如果你选择了只生成 DataSoruce复选框 ，则将只生成DataSource .点击下一步 弹出 DataCommand信息对话框DataCommand设计—利用向导创建(5)利用向导创建DataCommand的工作已经完成点击下一步 弹出信息确认对话框DataCommand设计—利用向导创建(6)DataSource主要是为DataCommand提供拼装Oql的功能，继承自基类SimpleOqlToolDataCommand在 u9DataCommand中 除了 操作 实体外，还经常使用 临时表 ，操作临时表时也需要手工拼Oql，在这种情况下，可以使用Oql辅助类 SimpleOqlTool 拼写OqlDataCommand 和 DataSource 关系介绍U9 DataCommand 是基于OQL和UBF实体引擎开发的后台取数逻辑,由于u9的报表业务比较复杂，字段，条件都特别多，手工拼写Oql 字符串非常繁琐，所以在UFIDA.UBF.Report.App.Data 中提供了 一种方便拼写Oql的工具类 DataSourceDataCommand编程—结构DataCommand编程—开发过程使用代码生成工具生成报表的框架代码DataCommand类中的 GetOqlString() 方法中，添加必要的业务处理逻...
