U9报表资料.doc

文档名称报表开发资料建立日期: 2010-03-01修改日期: 2010-03-01文控编号: 作者: 文档信息项目编号*文档编号*项目名称*标题*类别参考手册摘要当前版本V1.0日期2010-01-20作者*文档拥有者送交人员文件修改历史日期版本作者修改内容2010-03-011.0苗庆波初始版本目 录1参考资料82报表控件82.1报表分区82.2控件概述82.3表格92.3.1表格布局组合92.3.2对象说明102.3.3使用方法102.4矩阵132.4.1矩阵对象组合132.4.2对象说明132.4.3使用方法142.5图表142.5.1特性142.5.2对象说明142.5.3其他182.6报表分组182.6.1特性182.6.2示例182.7子报表202.8数据绑定及布局计算212.8.1理解数据绑定212.8.2布局计算212.9组合布局平行组合（多控件）嵌套组合222.10常见问题233报表个性化：布局字段扩展233.1解决的问题233.2实现实体扩展操作步骤233.2.1UBF登录233.2.2选择要修改的报表243.2.3增加字段243.2.4编辑字段表达式表达式编辑框添加根实体拖拽显示字段拖拽条件表达式字段2返回表达式273.2.5OQL表达式中使用自定义函数2编写SQL Server函数2SQL Server函数注册2表达式编辑框2使用自定义函数303.3注意问题303.4附件304多表头表格314.1设置步骤314.2示例315多控件报表315.1设置步骤315.2注意问题325.3示例326OBA FI-Excel取数函数326.1操作说明326.2简单示例326.3参考资料326.4常见问题337OQL使用338工具类使用348.1常用工具类348.1.1DataViewQuery报表使用的查询类3说明3示例3关键方法348.1.2DataSource3DataSource说明3数据源工作原理：3.1实体别名Map3.2字段别名Map3.3在Oql中使用 Top,distinct 等关键字3.4手工关联其他实体378.1.3SimpleOqlTool3说明3示例3关键方法3SimpleOqlTool 重用398.1.4TempTableUtil40说明40示例40关键方法408.1.5DataSource新建关联4使用步骤4示例418.2报表API41IDictionary dic = new Dictionary();419常见函数使用方法429.1报表函数429.1.1全局上下文4Contexts!LoginDateTime4Contexts!UserID4Contexts!UserName4Contexts!UserCode4Contexts!OrgID4Contexts!OrgName4Contexts!Culture4Contexts!EnterpriseID4Contexts!EnterpriseName439.1.2聚合函数4报表合函数使用方法4Sum(expression)4Avg(expression)4Max(expression)4Min(expression)4Count(expression)4StDev(expression)4StDevP(expression)4Var(expression)40VarP(expression)41First(expression)42Last(expression)43Previous(expression)44CountDistinct(expression)45CountRows()46RowNumber()47RunningValue(expression,function)479.1.3数学函数4Abs(numeric_expression)4Ceiling(numeric_expression)4Floor(numeric_expression)4Round(numeric_expression,length)4Sqrt(float_expression)4Sin(float_expression)4Cos(float_expression)4Tan(float_expression)4ASin(float_expression)40ACos(float_expression)41ATan(float_expression)42Log(float_expression)43Log10(float_expression)44Exp(float_expression)499.1.4日期与时间4Day(Date)4Month(Date)4Year(Date)50Now()50Weekday(Date)509.1.5文本处理50Left(character_expression,integer_expression)50Right(character_expression,integer_expression)50Trim(character_expression)5LTrim(character_expression)5RTrim(character_expression)5LCase(character_expression)5UCase(character_expression)5Mid(expression,start,length)5Replace(expression,findString,replaceString)529.1.6页号及页数5Globals!PageNumber5Globals!TotalPages529.1.7基本扩展函数5U_DF.GetSegName(fullName,seg)5U_DF.GetLevelName(fullName,level)5U_DF.ValueToString(value)5U_DF.IsNull(value)539.1.8其他5IsNumeric(expression)5IsDate(expression)5IsNothing(expression)5IIf(bool_expression,truePart,falsePart)539.2函数操作5310常见格式处理5410.1背景色5410.2除0判断5410.3DataCommand枚举处理5411参数5411.1枚举参数541 参考资料1) U9研发体系（U9报表开发手册）.PDF2) U9研发体系（自定义报表开发手册）.PDF2 报表控件2.1 报表分区报表模板控件布局结构，分为以下控件。2.2 控件概述1 报表区域加制表项组合成报表布局，区域是绘制内容的背景，制表项显示报表内容。2 报表分表头、表体、表尾、页眉、页脚和分组区域六种逻辑区域，继承报表区域。3 制表项包含文本框、线条、矩形、图形、表格、矩阵、图表七种具体对象，分为两类：a) 基础绘图对象（文本框、线条、矩形、图形），b) 数据分析对象（表格、矩阵、图表）。4 页眉、页脚区域：与Word的页眉、页脚区域使用方式类似。2.3 表格 表格是数据分析对象，可用于展示明细数据。2.3.1 表格布局组合1 表格有若干个有限的区域组成，a) 这些表格区域分为：表头、表体、表尾、分组区域。i. 表头：用于显示标题名称；可以设置多层表头；在策略中可以修改其中的显示内容。ii. 表体：显示数据的明细；每个单元格可以直接绑定到显示的数据字段；可以在其中填写表达式，显示计算结果。iii. 表尾：显示数据的汇总，合计、平均值等。b) 这些区域分动态区域和静态区域两类：表体区为动态区域，其余为静态区域。动态区域根据数据行滚动显示表格行，静态区域展现跟设计时保持一致。2 表格区域由表格行（Row）集合组成，表格行则由表格单元(TableCell)组成;表格单元可以嵌入文本框、矩形、图形、子报表。若要删除嵌入的图像、子报表，再拖放一个文本框覆盖一下即可。3 表格列：描述了表格布局中各列的宽度和是否显示控制。2.3.2 对象说明1 表控件属性序号属 性显示名称说 明1Name名称表格对象名称2Top位置Y描述文本框的位置和大小，如果文本框在表格或矩阵中则其位置和大小受容器的相对位置控制。3Left位置X4Width宽5Height高6ToolTip提示信息用于当鼠标滑过文本框时显示信息7Visible显示是否显示8HoldTableHeader 表头固定显示如果为TRUE，报表客户区滚动时表头不动。9HeadPrintModel表头打印模式PrintOnEachPage 每页打印PrintOnFirstPage 只在第一页打印10FooterPrintModel表尾打印模式PrintOnEachPage 每页打印PrintOnLastPage 只在最后一页打印11DatasetName绑定数据查询表格绑定的数据查询名称12PageBreakAtFirst开始位置拆页初始打印报表时新启一页打印13PageBreakAtEnd结束位置拆页在表格打印结束后新启一页，本页没有打印完成则留白。2 行序号属 性显示名称说 明1Height行高2Visibility隐藏True 隐藏当前行，默认为False或为属性为空可以设置条件表达式，根据数据来判断是否隐藏，如：Fields!Money.Value （当金额小于零时隐藏当前行）3 列序号属 性显示名称说 明1Width列宽2Visible是否隐藏3Holded冻结当表格左右滚动时左侧列不变4Name列名列唯一标记5Tag列标记编程时扩展属性2.3.3 使用方法操作：1. 拖放一个表格控件到模板2. 拖放字段到表格列。可以同时选中左侧字段中多个字段同时拖放到表格控件，放在表格表体行。3. 在左侧字段列设置字段的扩展属性的栏目、分组、排序特性，不必把所有字段都拖放到表格控件上。4. 上下文菜单表格左侧图标处点击右键弹出上下文菜单，菜单说明：1) 在上方插入行：在当前焦点行上方插入一行，行的类型与焦点行相同，如图中情况是插入一个表体行。若需要添加多个表头，在表头行使用上下文菜单。2) 在下方插入行：在当前焦点行下方插入一行，与“在上方插入行”类似。3) 删除（行）：删除焦点行。4) 增加（表头）：在表格中没有表头时增加表头行，若表格中有表头则不处理。若需要添加多个表头，在表头行使用上下文菜单。5) 增加（表体）：在表格中没有表体时增加表体行，若表格中有表体则不处理。若需要添加多个表体，在表体行使用上下文菜单。6) 增加（表尾）：在表格中没有表尾时增加表尾行，若表格中有表尾则不处理。若需要添加多个表尾，在表尾行使用上下文菜单。7) 增加（组）：表格控件内的组，类似与Excel的分级汇总行。8) 编辑（组）：编辑分组信息。9) 删除（所有组）：删除分组。5. 表格属性属性：1) 位置：在模板中的位置，可以直接在模板设计器中拖放表格的位置，可以在此设置表格的位置。2) 表头打印模式：此处是表格控件的表头，注意与模板表头的区别。a) PrintOnEachPage：在每页都显示。b) PrintOnFirstPage：在首页显示。c) PrintOnGroupFirst：在分组的首页显示。此处的分组是报表模板打开，菜单/报表/分组，参考“2.6报表分组”。3) 表尾打印模式：此处是表格控件的表尾，注意与模板表尾的区别。此处的分组是报表模板打开，菜单/报表/分组。4) 数据查询：表格控件使用的数据源。2.4 矩阵表格是数据分析对象，可用于展示汇总交叉计算数据。2.4.1 矩阵对象组合2.4.2 对象说明1 矩阵序号属 性显示名称说 明1Name名称文本对象名称2Top位置Y描述文本框的位置和大小，如果文本框在表格或矩阵中则其位置和大小受容器的相对位置控制。3Left位置X4Width宽5Height高6ToolTip提示信息用于当鼠标滑过文本框时显示信息7Visible显示是否显示8DataSetName数据查询名矩阵绑定的数据查询名称2 列（Column）序号属 性显示名称说 明1Width矩阵列宽3 行组（Grouping）序号属 性显示名称说 明1Name名称分组名称2GroupExpression分组表达式3Expressions分组表达式集合4 列组（ColumnGroup）序号属 性显示名称说 明1Height行高文本对象名称2DynamicColumns动态列组集合2.4.3 使用方法操作：1. 拖放一个矩阵控件到模板。2. 在左侧字段列设置字段的扩展属性的栏目、分组、排序特性，不必把所有字段都拖放到矩阵控件上。3. 矩阵中若要使用矩阵控件的小计功能，需要在模板上的行分组、列分组添加上小计列，如下图：4. 上下文菜单：在列、组，不同的位置。菜单不同，具体功能点击看效果。2.5 图表2.5.1 特性图表(Chart):用图形展现数据分析结果。支持18种图表类型：柱状图、堆积柱状图、百分比柱状图、条形图、堆积条形图、百分比条形图、折线图、曲线图、饼图、分离型饼图、气泡图、面积图、增积面积图、百分比堆积面积图、环形图、分离环形图、股价图、K线图。灵活的展现效果设置：可为图表各部分添加修饰效果，如背景、前景、标题、坐标轴等。支持二维和三维展现效果。支持在图表上钻取。支持图例显示。支持多维度、多系列、多度量的数据分析。2.5.2 对象说明示例图表类型：柱状图示例图表类型：条形图设置步骤：1. 数据源：在数据页签中设置，与表格、矩阵方式报表的数据一样。2. 拖放一个图表控件。3. 在图表控件上点击右键，选择“属性”，打开“图表属性”。1) “名称”页签a) 名称：图表控件名称b) 标题：图表控件内显示的图表标题。可设置标题样式：字体格式等。c) 图表类型：支持18种图表类型。d) 图表背景样式：图表控件的背景样式，设置填充颜色、边框样式。e) 绘图区样式：图表绘图区域的样式，设置填充颜色、边框样式。2) “数据”页签a) 查询名称：提供数据源的数据查询。b) 变量/度量：直观理解为显示的刻度值。如：柱状图的Y轴。条形图的X轴。属性:i. 值：变量/度量的值，即是刻度值。是SUM、COUNT等聚合函数结果。（可以自己写表达式如Avg）ii. 标题：具体显示区域标题。如：一条红色区域表示是产品A的销售数量。iii. 钻取：具体显示区域钻取到其他单据或报表。iv. 系列样式：a) 边框：None：系统使用默认设置。比较重要的设置。如：若要使折线图系列颜色自动分配，需要设置为None。折线图的在非None时，宽度设置为0，在UBF设计器中看不到图表预览，在Portal中可以显示，并且是细线。b) 填充：基准色：白色系统使用的默认设置。比较重要的设置。如：若要使饼图扇区的颜色自动分配，需要设置为白色。c) 维度类别：直观理解为统计的分类。如：柱状图的X轴。条形图的Y轴。属性：i. 分组表达式：是“变量/度量”使用的聚合函数依据的分组条件，有Group by的作用。与“变量/度量”结合起来理解，是select sum(colA) as变量/度量 from table group by维度类别。d) 系列：可以理解为在“维度类别”下的再次分类。3) “X轴”页签对X轴方向信息显示设置。注意：“X轴方向”是指在柱状图时与标准的X轴方向相同，其他图形，如：条形图时，“X轴”页签设置的信息影响纵向格式。与“数据”页签的维度类别一致。a) 标题：轴方向的显示标题。b) 显示标签：控制“维度类别”的内容是否显示。c) 显示主网格间隔：依据“维度类别”显示网格。d) 显示辅网格间隔：显示更明细的网格，便与数据查看、对比。e) 标题对齐方式：本页签中标题的对齐方式。f) 刻度：设置轴方向的数值范围。0表示自动调整。g) 主刻度标记：轴上主刻度的显示方式。主刻度与主网格间隔一致。显示方式：None：不显示；Outside：在绘图区域外显示；Inside：在绘图区域内显示：Cross：穿过轴显示。h) 辅助刻度标记：轴上辅助刻度的显示方式。辅助刻度与辅助网格间隔一致。显示方式：None：不显示；Outside：在绘图区域外显示；Inside：在绘图区域内显示：Cross：穿过轴显示。i) 绘图时使用余白：在绘图区域边界显示部分空间，修饰显示效果。j) 坐标反转：坐标轴的正反方向反转。k) 样式：设置对于属性的显示样式。4) “Y轴”页签对Y轴方向信息显示设置。注意：“Y轴方向”是指在柱状图时与标准的Y轴方向相同，其他图形，如：条形图时，“Y轴”页签设置的信息影响横向格式。与“数据”页签的变量/度量一致。a) 标题：轴方向的显示标题。b) 显示标签：控制“变量/度量”的内容是否显示。c) 显示主网格间隔：依据“维度类别”显示网格。d) 显示辅网格间隔：显示更明细的网格，便与数据查看、对比。e) 标题对齐方式：本页签中标题的对齐方式。f) 刻度：设置轴方向的数值范围。0表示自动调整。g) 主刻度标记：轴上主刻度的显示方式。主刻度与主网格间隔一致。显示方式：None：不显示；Outside：在绘图区域外显示；Inside：在绘图区域内显示：Cross：穿过轴显示。h) 辅助刻度标记：轴上辅助刻度的显示方式。辅助刻度与辅助网格间隔一致。显示方式：None：不显示；Outside：在绘图区域外显示；Inside：在绘图区域内显示：Cross：穿过轴显示。i) 绘图时使用余白：在绘图区域边界显示部分空间，修饰显示效果。j) 坐标反转：坐标轴的正反方向反转。k) 样式：设置对于属性的显示样式。5) “图例”页签a) 显示图例：在图表控件中显示图例。图例：颜色表示的维度类别、系列。b) 布局：图例的排列方式。c) 图例显示在图形区域：表示图例是否显示在绘图区域内，否则与绘图区域分离。d) 图例显示样式：图例的显示格式。e) 在图表背景的显示位置：与绘图区域的相对位置。6) “3D效果”页签“3D效果”仅是对显示效果的修饰，数据还是二维数据表。a) 使用3D效果：选中后“3D效果”才可以设置。b) 水平旋转：水平方向旋转角度。c) 透视：3D透视比例。d) 背景墙厚度：3D背景厚度。e) 垂直旋转：垂直方向旋转角度。f) 阴影：阴影效果。g) 预置效果：垂直效果、立体坐标、柱状效果。h) 默认效果：设置为默认3D效果。7) “过滤”页签a) 对“数据”页签中数据查询的数据再次过滤。4. 示例附件2.5.3 其他1) 每个图形的特点2) 折线图a) 使用折线图时，数据页签的维度类别、系列对图表的影响：如果两个维度类别之间有其他类别间隔而又没有系列数据，则不能绘制折线。3) 修改系列折线图线条的宽度修改位置：图表/属性/数据/变量度量/修改/系列样式/边框a) 样式：None：颜色就会自动分配。颜色相同时可能是没有选择None。折线图的在非None时，宽度设置为0，在UBF设计器中看不到图表预览，在Portal中可以显示，并且是细线。b) 宽度、颜色：是在样式不是None的情况下起作用，但是当样式不是None时，所有系列的颜色都是相同的。4) 修改饼图扇区颜色：修改位置：图表/属性/数据/变量度量/修改/系列样式/填充a) 基准色：白色时扇区颜色就会自动分配。b) 绘制方向：在柱状图时起作用。c) 终止色：颜色渐变终止色。2.6 报表分组2.6.1 特性设置位置：报表模板打开，菜单/报表/分组。可以按照分组栏目设置，把相同栏目值的记录显示在一个控件中。2.6.2 示例1. 分组设置：2. 分组设置后模板：3. 显示效果：4. 示例附件2.7 子报表子报表可直接放在报表布局区域，也可嵌入表格单元，可多层嵌套，但层次太多会影响效率。序号属 性显示名称说 明1Name名称表格对象名称2Top位置Y描述文本框的位置和大小，如果文本框在表格或矩阵中则其位置和大小受容器的相对位置控制。3Left位置X4Width宽5Height高6ToolTip提示信息用于当鼠标滑过文本框时显示信息7Visible显示是否显示8SubReportID子报表ID9SubReportName子报表名称10Parameters关联参数集合可以用当前行的值作为子报表查询的参数。如果在表格控件中已经添加了子报表，若要删除嵌入的子报表，再拖放一个文本框覆盖一下即可。2.8 数据绑定及布局计算2.8.1 理解数据绑定报表用绑定的方式在布局对象中显示数据集内容，布局对象不直接参与计算(文本框除外)，布局计算的本质是将数据集计算的结果绑定到报表对象展现。如下图所示：2.8.2 布局计算布局对象的属性可引用表达式返回的结果，1) 可参与布局计算的操作数：操作数引用语法数据集字段Fields!xxxxxx.Value xxxxxx表示字段名系统函数（参数） ，如：Now() , Year(New() 自定义函数U_DF.（参数） 如：U_DF.GetSegName(fullName,seg)内嵌VB.NET过程Code.（参数） 条件值语法：Parameters!.Value 取条件第一项的值Parameters!.Value 取第n个条件值Parameters!.Values 取全部条件值组成的表格Parameters!.Value# 当有两个条件值时返回区间表达方式例：Parameters!ShowMode.Value Parameters!Date.Value#系统上下文Contexts!UserID.Value全局变量Globals!PageNumberGlobals!TotalPages文本框值ReportItems!xxxxx.Value xxxxxx为报表项目名，如引用文本框TextBox1值参与计算： ReportItems!TextBox1.Value & “报表”常量例：0 、“性别”2) 可绑定表达式返回结果的对象及属性对象类型属性名说明TextBoxTextFormat例：条件格式 iif（Fields!精度.Value2,”#,#.000”,”#.#0.00”）FrontWarnningColor例：预警显示iif（Fields!金额.Value0,”Red”,”Black”）BackWarnningColorRowVisibility例：发生额为空时隐藏当前行Fields!cr.Value=0 AND Fields!.dr.Value=0GroupingGroupExpression2.9 组合布局 平行组合（多控件）数据分析对象允许平铺在报表区域。第一个控件内容显示完毕后，再显示第二个控件内容。 嵌套组合子报表允许嵌入Table的单元格，支持多级嵌套。报表实体扩展功能使用说明2.10 常见问题3 报表个性化：布局字段扩展3.1 解决的问题当系统报表提供的栏目不够用时，可以利用此功能直接从实体中取值。实体扩展单元既可放在表头表尾；也可以放在明细行，用当前行的其它字段作为查询键值。3.2 实现实体扩展操作步骤3.2.1 UBF登录实体扩展功能只能在自定义报表设计工具中设置,登录企业库，打开系统报表。3.2.2 选择要修改的报表从报表资源管理中打开要修改的报表，如下图所示： 3.2.3 增加字段在左侧点击字段，在字段列表中任意一个字段上点击右键 选择扩展属性，弹出字段扩展属性对话框。在字段列表的空白处 ，点击右键 选择 “添加用户自定义字段”。鼠标点击新加的字段进行重命名。在右侧的默认标题名称中填写 默认标题，选中备选栏目和默认栏目，这样查询时就把新加的字段放到了结果中了 如下图所示3.2.4 编辑字段表达式 表达式编辑框点击显示字段后面的fx标记按钮 （见上图）弹出下面的对话框 添加根实体在新弹出的对话框中点击 fx按钮 （如上图）弹出 用户打印字段表达式对话框，点击 左上角的 添加根实体对象 ，如下图 ： 输入要查找的实体名称 ，点击查找 ，从列表中选中该实体，双击即可在 根实体页签中显示选中的实体。 拖拽显示字段按照下图所示 在左边的根实体页签中点击选择的实体前面的加号展开，选择要参与运算的字段，并拖拽该字段 到显示字段文本框中。 拖拽条件表达式字段拖拽实体字段到条件表达式列表中 ，如下图所示这里的字段就是来对该实体进行过滤的。 条件可以来自报表参数，或者当前行的某个字段的值。 特别注意： 这里的的条件必须保证查询出结果是一条记录，如果是多条，则只取第一条的值。 返回表达式设计完成后点击确认 ，设计表达式就会返回对话框中，点击确认关闭对话框。结果如下图所示。返回的语法格式是OQL语句（OQL语句与SQL 非常相似，附件说明）。在下面的对话框中点击标记的按钮，可以根据需要对刚才设计的表达式再次进行编辑（和已经有的字段进行运算。）注意： 双击即可选择 左边的字段到 右边的对话框中 。点击确认按钮，保存模板后就可以重新进入Portal 中查看了。3.2.5 OQL表达式中使用自定义函数如果扩展字段不能直接从实体属性上找到，是经过取数逻辑处理后的计算字段，可以使用添加自定义函数的方式实现。 编写SQL Server函数编写标准SQL Server值函数部署到Portal数据库中。如：GetOLValue（参数：料号）。函数内容编写需要的数据取数逻辑。 SQL Server函数注册标准SQL Server函数需要在Portal的配置文件中注册，以便在OQL语句中使用。注册方法：附件 OQL语言.pdf第11页。 表达式编辑框打开表达式编辑框 使用自定义函数使用自定义函数的方式是U_DF.函数名，如：U_DF.GetQLValue(Fields!字段)；函数内容编写需要的数据取数逻辑。3.3 注意问题注意问题：由于添加的字段是依据每条记录到数据库取数，在记录数很多时较影响性能。请根据需要使用。3.4 附件附件：OQL语言.pdf4 多表头表格4.1 设置步骤1) 表格控件中添加多行表头。2) 栏目中每层的表头信息由“_”分割。3) 在策略中写如下代码： protected override void ProcessFormat() base.ProcessFormat(); if (m_case = null) return; IDynamicTemplateGenerator generator = DynamicTemplateGenerator.GetInstance(m_reportTemplate); ITableSchema tableSchema = generator.GetDefaultTableSchema(); if (tableSchema != null) /合并表头标题行 tableSchema.MergeBaseTableRegion(enuTableRegionType.Head); tableSchema.AdjustTableHead(AdjustTableHeadType.FromTop); 4.2 示例5 多控件报表5.1 设置步骤1) 若使用DataCommand做为数据源，DataCommand的dll拷贝到UBFStudioRuntime。2) 在报表设计器的数据页签添加多个数据查询。如果数据查询是DataCommnd，编辑区填写的格式是：bo: DataCommnd程序集. DataCommnd类，如bo:UFIDA.U9.UserDefine.DemoC.GL.Report.DataCommand.GrossProfCmd，可以使用导入DataCommand方式得到串，导入后，点击数据编辑区工具栏上的“预览查询结果”按钮。3) 预览后模板设计器左侧字段就出现多个查询，使用下拉框切换，每个查询有不同的字段。4) 在设计器中拖放多个数据分析对象（表格、矩阵、图表）。设置每个分析对象的数据源。5.2 注意问题1) 只能实现同时若干张普通表格，同一个报表中如果同时存在矩阵和普通表格，只能显示矩阵，不能同时显示。2) 虽然提供数据的数据查询不同，但是每个数据查询都是接受的报表全部参数，所以需要在DataCommand的条件处理中选择需要的条件项，即对每个查询是其中的部分条件有意义。5.3 示例6 OBA FI-Excel取数函数6.1 操作说明V2.0文档上市版DocDocFI-Excel取数函数.pdf6.2 简单示例安装OBA后，所有程序UFIDA U9 OBA模版取数函数常用财务模版。6.3 参考资料1) V2.0文档上市版DocDocFI-Excel取数函数.pdf。2) OBA菜单：用友财务帮助。3) 示例模版：安装OBA后，所有程序UFIDA U9 OBA模版取数函数常用财务模版。4) 前提：了解U9中的office集成OBA。6.4 常见问题1) 参数设置：参数是否可以在增加？a) 参数是固定的，这里的参数可以理解为是下面函数的公共参数。b) 在具体函数中的“默认”即是指参数设置中设置的参数。2) 如何开发新函数？部署？a) 有扩展的接口，可以扩展。b) 函数是在每个单元格中计算的，在公式很多时，效率是比较低的。c) 函数开发有点难度。d) 基于以上几点，OBA开发函数手册未发布，如果是合理公用的函数功能，可以提需求增加产品功能。e) 其他需求可以使用报表开发，导出Excel后分析。开发效率、运行效率都较高。3) 凭证函数的查询条件中的记账期间，无法作为查询条件，是因与参数中的期间冲突？a) 原因未明确，正常应该可以带回来。（2010年2月25日 14:03:43 李天一）4) 发版盘中的模版，是Excel另存为的模版？a) 是Excel的模版。b) 发版盘中的模版是个示例，参考发版盘中的FI-Excel取数函数.pdf可以做新的模版。5) 打开模版时显示 #MSG0002 是表示？a) Excel Excel选项公式工作薄计算：自动重算。在打开模版时自动计算，但此时未登录U9系统，导致显示此类信息。b) 登录后，点击菜单重新计算即可。6) FI-Excel取数函数.pdf中 点击取数函数菜单？a) FI-Excel取数函数.pdf的取数函数就是菜单【粘贴函数】。7) 静态报表a) 点击“静态报表”，可以把当前表发布为一张只有数据没有公式的报表。这个功能主要是为了没有安装客户端的用户也能正常的浏览财务报表。7 OQL使用参考：培训课件：课件03-OQL语言PDF课件OQL语言.pdf。8 工具类使用8.1 常用工具类8.1.1 DataViewQuery报表使用的查询类 说明1) 是报表使用的查询类：主要用于操作临时表。2) 利用该对象执行Oql时，需要使用一个数据库连接，该连接的状态有基类 BaseReportDataCommand来维护，在报表子类中不要处理，在整个报表业务逻辑处理要确保使用一个EntityViewQuery，不要使用 New EntityViewQuery 来创建。 3) 操作临时表：update temptable set cola=xxx，语法格式是OQL语法。 示例 StringBuilder strb = new StringBuilder();strb.Append( update ARTable set Seller_Code = SrcSO.SellerCode, Seller_Name = SrcSO.SellerName);strb.Append( from ARTable inner join SrcSO );strb.Append( on ARTable.SOLine_SrcDocNo = SrcSO.DocNo );viewQuery.ExecuteTempCollection(strb.ToString(), null); 关键方法 ExecuteTempCollection()8.1.2 DataSource DataSource说明该类主要是为DataCommand提供拼装Oql的功能 ，简化其复杂度。所有数据源都必须继承该类。DataSource属性/方法说明：类/接口属性/方法说明IQueryParameter/QueryParameter查询参数描述属性属性名：Selection语法：public SelectFields Selection get;set;功能：Oql栏目部分属性类型：读写属性名：Conditions语法：public ConditionFields Conditions get;set;功能：Oql 条件部分属性类型：读写属性名：Orders语法：public OrderFields Orders get;set;功能：Oql排序部分属性类型：读写属性名：Groups语法：public GroupFields Groups get;set;功能：Oql分组部分属性类型：读写属性名：Havings语法：public HavingFields Havings get;set; 功能：Oql分组条件部分属性类型：读写方法方法名：AddSelect语法：public virtual void AddSelect(string exp)功能：给Oql添加栏目部分说明：该方法有多个重载，请视情况使用方法名：AddCondition语法：public virtual void AddCondition(string exp)功能：给Oql添加条件部分说明：该方法有多个重载，请视情况使用方法名：AddGroup语法：public virtual void AddGroup(string exp)功能：给Oql添加分组部分说明：该方法有多个重载，请视情况使用方法名：AddOrder语法：public virtual void AddOrder(string exp)功能：给Oql添加排序部分,默认是升序说明：该方法有多个重载，请视情况使用方法名：AddHaving语法：public virtual void AddHaving(string exp)功能：给Oql添加分组条件部分说明：该方法只能把拼好的条件传进去方法名：RemoveCondition语法：public void RemoveCondition(string conditionName)功能：删除指定的条件方法名：RemoveGroup语法：public void RemoveGroup(string groupExp)功能：删除分组部分方法名：RemoveSelect语法：public void RemoveSelect(string fildsAliasName)功能：删除栏目部分方法名：RemoveOrder语法：public void RemoveOrder(string orderE