UAP开发红皮书系列UAP6.3报表平台技术红皮书UAP中心编著UAP6.3报表平台技术红皮书UAP技术红皮书系列第1/206页目录第一章前言..........................................................................................................................41.1背景................................................................................................................................................................51.2总体介绍........................................................................................................................................................51.2.1报表平台技术框架................................................................................................................................51.2.2应用流程................................................................................................................................................61.3入门................................................................................................................................................................81.3.1自由报表的新建....................................................................................................................................81.3.2自由报表的格式设计............................................................................................................................91.3.3语义模型的使用..................................................................................................................................101.3.4可扩展区域...........................................................................................................................................111.3.5数据预览功能......................................................................................................................................141.3.6分析功能..............................................................................................................................................151.4小结..............................................................................................................................................................16第二章基本功能................................................................................................................172.1可扩展区域管理..........................................................................................................................................182.2排序..............................................................................................................................................................212.3筛选..............................................................................................................................................................252.3.1单值筛选..............................................................................................................................................252.3.2筛选......................................................................................................................................................252.3.3筛选条件..............................................................................................................................................262.4页维度..........................................................................................................................................................292.4.1页维度的生成......................................................................................................................................292.4.2页维度的删除......................................................................................................................................312.4.3页维度的设置对话框..........................................................................................................................312.4.4页维度过滤按钮事件..........................................................................................................................412.5固定成员......................................................................................................................................................412.6分组..............................................................................................................................................................452.7统计..............................................................................................................................................................472.8区域设置向导..............................................................................................................................................502.9排名函数......................................................................................................................................................592.10TopN分析....................................................................................................................................................622.11同比环比......................................................................................................................................................682.12树形展示......................................................................................................................................................712.13NC数据格式...............................................................................................................................................742.14条件公式......................................................................................................................................................78UAP6.3报表平台技术红皮书UAP技术红皮书系列第2/206页2.14.1满足以下条件的单元设置格式..........................................................................................................782.14.2使用公式确定要设置的格式单元格的格式......................................................................................802.14.3基于各自值设置所有单元的格式......................................................................................................822.14.4删除条件格式......................................................................................................................................852.15单元公式......................................................................................................................................................852.16交叉..............................................................................................................................................................922.16.1交叉表的简单制作..............................................................................................................................922.16.2交叉小计..............................................................................................................................................952.17隐藏管理......................................................................................................................................................972.18分栏显示......................................................................................................................................................982.19数值型字段的小数....................................................................................................................................1022.20报表参数和变量的使用............................................................................................................................1042.20.1参数和变量的定义............................................................................................................................1042.20.2参数和变量的使用............................................................................................................................1052.20.3参数和变量的赋值............................................................................................................................1062.21图标设置....................................................................................................................................................1062.21.1图表类型页签....................................................................................................................................1072.21.2数据定义页签....................................................................................................................................1092.21.3图标属性页签.....................................................................................................................................1112.21.4其他需要注意的地方.........................................................................................................................1122.22打印............................................................................................................................................................1132.22.1常规打印.............................................................................................................................................1132.22.2打印扩展接口.....................................................................................................................................118第三章分析功能综合应用..............................................................................................1503.1分组功能的应用........................................................................................................................................1513.1.1列表中的多级分组............................................................................................................................1513.1.2交叉表结合分组应用........................................................................................................................1543.2数据依赖处理区域拼接............................................................................................................................155第四章报表发布节点......................................................................................................1594.1报表的发布................................................................................................................................................1604.1.1发布为查询型节点............................................................................................................................1604.1.2发布为报表型节点............................................................................................................................1624.2发布后节点................................................................................................................................................1624.2.1查询节点............................................................................................................................................1634.2.2报表节点............................................................................................................................................1674.3另一种报表节点的实现............................................................................................................................1704.4报表订阅中心............................................................................................................................................175UAP6.3报表平台技术红皮书UAP技术红皮书系列第3/206页4.4.1订阅报表报表....................................................................................................................................1764.4.2报表组合订阅....................................................................................................................................1784.4.3订阅维护............................................................................................................................................1794.5报表的导入导出........................................................................................................................................179第五章穿透、联查和联动..............................................................................................1815.1报表穿透....................................................................................................................................................1825.2报表联查....................................................................................................................................................1845.2.1报表联查更深的一点理解................................................................................................................1855.2.2业务联查的实现步骤........................................................................................................................1855.2.3工具方法............................................................................................................................................1915.3区域联动....................................................................................................................................................193第六章报表节点的扩展..................................................................................................1986.1查询动作扩展............................................................................................................................................1996.2查询条件....................................................................................................................................................2016.3区域条件....................................................................................................................................................2026.4业务格式....................................................................................................................................................2036.5格式调整器................................................................................................................................................2056.6报表订阅相关接口....................................................................................................................................2066.7报表变量的赋值实现................................................................................................................................2086.8工具方法....................................................................................................................................................210第七章辅助开发工具......................................................................................................2307.1安装盘脚本................................................................................................................................................2317.1.1构造平台中支持自由报表（以及语义模型）................................................................................2317.1.2发布的报表节点导出........................................................................................................................2327.2安装程序....................................................................................................................................................232UAP6.3报表平台技术红皮书UAP技术红皮书系列第4/206页第一章前言本章内容概要：背景总体介绍入门小结UAP6.3报表平台技术红皮书UAP技术红皮书系列第5/206页1.1背景本文针对V6.3报表平台功能进行介绍，这是为满足各类用户在报表分析方面的综合要求，提供的一个分析型报表的解决方案。其核心是基于语义模型定义自由报表，其格式设计中可进行各类分析设置；设计好的自由报表可发布为节点，供用户进行实时查询分析和定时订阅发布等各种方式的使用。报表平台具有以下特点：针对企业不同业务角色，提供多样使用方式：报表数据查询人员可以在基于自由报表发布的查询节点中直接进行查询分析，而不需具备较深技术背景；专业的分析报表设计人员则可以全面使用设计功能实现复杂报表的定义和发布；支持多种数据来源：系统支持多种语义模型定义方式，还支持注册其他类型语义模型提供者，多来源数据都可以在一张自由报表中进行数据分析和展现；报表支持多区域模型，多个区域按照数据分析结果各自动态展开；多区域和多数据来源之间均可以设置依赖关系，能灵活组合拼装出各类样式的复杂报表；格式设计和报表展现效果一致：各种数据分析和格式设置都在设计界面有直观展现，特别是交叉表的设计方式突破以往，能够可视化的直接定义维度指标及各类展现效果；提供了分析图表功能：提供了各类常见图表分析功能；分析功能和交互性加强：全面支持排序/过滤/分组/统计/交叉/排名函数/TopN等分析功能，并具有页维度和待定参数等交互特性。支持数据追踪：自由报表中的明细数据和统计数据都支持追踪到原始数据。针对大数据量的处理：利用数据库的处理能力进行多级汇总数据的处理，展现层在电子表格中实现平滑分页，可以分页加载明细数据。1.2总体介绍1.2.1报表平台技术框架报表平台的框架如图1所示：UAP6.3报表平台技术红皮书UAP技术红皮书系列第6/206页图1-2-1自由报表框架在资源管理中，通过目录/对象编辑进入格式设计，对数据进行分析，格式设计等。对于发布节点，可发布为查询节点和报表节点，对于发布为报表节点，可以进行订阅，或者对历史报表进行数据分析，输出等。对于发布为查询节点，可以通过报表执行器订阅发布，也可以在报表执行器后进行数据分析。对于订阅发布后的报表，则只可以输出。1.2.2应用流程自由报表的应用流程如下图所示：UAP6.3报表平台技术红皮书UAP技术红皮书系列第7/206页图1-2-2自由报表应用流程分为四大场景：实时浏览场景实时浏览场景是业务员进入业务场景，选择进入查询节点还是报表节点，如果进入查询节点，则直至分析输出位置。如果是报表节点，在设置查询条件后，进行执行方式的选择，执行实时报表，则直至分析输出，若选择异步，则进入异步设置场景。异步设置场景异步设置场景实际上是一个报表订阅场景，该场景创建了一个订阅任务，包含查询按规则，异步定时规则和发布规则。报表取阅场景主要分为三种情况中层消费者进入业务系统进入业务系统，若进入我的报表库或者进入报表节点，则可以选择历史订阅，查看订阅报表，，分UAP6.3报表平台技术红皮书UAP技术红皮书系列第8/206页析输出。若收到系统消息，则直接查看订阅报表，分析并输出。高管进入门户高管进入门户，会收到系统消息，则直接查看订阅报表，分析并输出。高管收到邮件高管收到邮件则是直接查看订阅报表并输出，没有分析过程。订阅管理场景订阅管理场景主要是管理员进入业务系统，进入报表订阅中心，进行选择，设置，清理任务，生成数据。1.3入门使用自由报表的基本流程介绍。1.3.1自由报表的新建1．选择自由报表功能节点，就会出现如下界面：图1-3-1报表功能节点2．接下来我们选中左面目录树中的一个目录，选择工具栏上的“新增”，如下图：图1-3-2新增报表3．报表卡片界面中填写“自由报表名称”、“自由报表编码”，如下图：UAP6.3报表平台技术红皮书UAP技术红皮书系列第9/206页图1-3-3添加新增报表信息4．点击工具栏中“保存”之后，该目录下的报表列表中就会出现刚才新建的报表，如下图：图1-3-4新增加的报表1.3.2自由报表的格式设计1．在自由报表界面选中需要格式设计操作的报表，点击工具栏中的“格式设计”如下图：图1-3-5报表格式设计2．报表的“格式设计”主界面如下：UAP6.3报表平台技术红皮书UAP技术红皮书系列第10/206页图1-3-7格式设计界面3．主界面中主要包含菜单、工具栏、自由报表导航区域、数据显示区域以及语义模型视图等部分。如下图：图1-3-8格式设计界面各个组成部分1.3.3语义模型的使用1．点击“数据源”上方的工具栏中的“插入语义模型”，出现选择语义模型界面，如下图，选中已经定义好的语义模型“销售管理”。UAP6.3报表平台技术红皮书UAP技术红皮书系列第11/206页图1-3-9插入语义模型2．点击“确定”，报表设计界面的语义模型信息框中就会出现被选择的语义模型，如下图：图1-3-10语义模型树1.3.4可扩展区域1．可扩展区域是为了放置语义模型的区域，有两种定义方式，一种是选中一定区域，然后右键菜单中选择“设置可扩展区域”，如下图：UAP6.3报表平台技术红皮书UAP技术红皮书系列第12/206页图1-3-11设置可扩展区域2．可扩展区域定义界面如下图，填写相应的信息。图1-3-12可扩展区域定义界面UAP6.3报表平台技术红皮书UAP技术红皮书系列第13/206页3．点击“确定”之后，数据显示区域就会出现此可扩展区域，如下图：图1-3-13显示定义的可扩展区域4．拖动右面语义模型信息框中语义模型的元数据，放入设置的可扩展区域中，如下图：图1-3-14元数据拖入可扩展区域5．设置可扩展区域的另一种方式：直接拖动右面语义模型信息框中的语义模型，放入数据显示区域，如下图：UAP6.3报表平台技术红皮书UAP技术红皮书系列第14/206页图1-3-15语义模型拖入可扩展区域1.3.5数据预览功能1．定义完可扩展区域，并且放置语义模型之后，就可以对数据进行查看了，点击工具栏中的“预览”按钮，如下图：图1-3-16预览图标及工具栏中的位置2．点击“预览”之后，数据就会显示在数据显示区域，如下图：UAP6.3报表平台技术红皮书UAP技术红皮书系列第15/206页图1-3-17预览后展示的数据1.3.6分析功能以排序功能为例，介绍分析功能的使用方法。1．选中可扩展区域中的某一元数据，然后选择工具栏上的数据分析功能按钮，如下图：图1-3-18工具栏中的数据分析工具2．点击工具栏中的“排序”，数据显示区域显示如下：UAP6.3报表平台技术红皮书UAP技术红皮书系列第16/206页图1-3-19排序功能的应用3．点击“预览”，会看到数据按升序来显示，如下图。如果此时保存了报表格式，则报表浏览时也会按照此排序设置进行报表数据展开。图1-3-20排序功能的应用后的预览1.4小结自由报表基于语义模型，以电子表格的方式进行报表格式设计，并可以设置各种分析功能。在报表浏览状态依然可以更改各类分析功能，达到实时交互分析数据的效果。UAP6.3报表平台技术红皮书UAP技术红皮书系列第17/206页第二章基本功能本章内容概要：可扩展区域管理排序筛选页维度固定成员分组统计区域设置向导排名函数TopN分析同比环比树形展示NC数据格式条件格式单元公式交叉隐藏管理分栏显示数值型字段的小数位数问题报表参数和变量的使用图表设置打印UAP6.3报表平台技术红皮书UAP技术红皮书系列第18/206页2.1可扩展区域管理下面详细介绍可扩展区域的定义，拆分，合并，移动，复制，删除等管理介绍。1．定义可扩展区域选择一个区域，右键设置可扩展区，即可定义个可扩展区。图2-1-1可扩展区域定义各设置项说明：可扩展区名称：用于标识和区分各可扩展区，为空时系统默认名称为其扩展区域。可扩展区区域：标记可扩展区在自由报表中的区域。扩展方向：标记区域是横向扩展还是纵向扩展。默认为纵向扩展UAP6.3报表平台技术红皮书UAP技术红皮书系列第19/206页限定区域大小：用来限制区域展开后的大小（数据态）。按区域大小，扩展区有多大展开后就多大，多余数据将自动截断；自定义，用户也可以自己定义展开后的行数和列数。扩展依赖：定义当前区域扩展时依赖的可扩展区域以及依赖扩展点。主要用于两个扩展区的对齐。如A扩展区的左上点依赖于B扩展区的左上点，则意味着希望A,B两个扩展区的左上点在同一条直接线。需要注意的是，对于定义了扩展依赖的，目前只会尝试让其对齐，如果A，B上方各自有扩展区，则展开后很可能会不对齐。这块还需要继续完善。其他属性：标题区域，分栏显示是分栏显示时所用到的，具体见第三章的分栏显示。2．拆分可扩展区域定义好可扩展区域后，可以对可扩展区域按行或按列进行区域拆分，将当前可扩展区拆分成两个可扩展区域。图2-1-2按行分割可扩展区域3．合并可扩展区域UAP6.3报表平台技术红皮书UAP技术红皮书系列第20/206页选中两个或两个以上的可扩展区域，可以对这多个可扩展区域进行区域合并，可以指定新合并区域的名称，并指定要合并到主合并区域，用于可扩展区模型的处理。图2-1-3合并可扩展区域定义图2-1-4合并可扩展区域设置UAP6.3报表平台技术红皮书UAP技术红皮书系列第21/206页4．管理可扩展区域右键管理可扩展区域，用于快速管理多个可扩展区域，包括添加，修改，删除等管理功能。图2-1-5可扩展区域管理5．移动可扩展区域可通过修改可扩展区域的区域设置来进行区域移动，也可以直接剪切然后粘贴来移动可扩展区域。6．复制可扩展区域全选可可扩展区域，然后复制，粘贴即可完成可扩展区域的复制粘贴。可以用ctrl+c,ctrl+v进行快速操作。7．删除可扩展区域选择需要删除的扩展区，右键删除可扩展区域即可删除该扩展区。2.2排序通过以下三种方式设置排序：语义模型中设置排序字段。选择字段后点排序按钮。选择扩展区后，点排序管理。UAP6.3报表平台技术红皮书UAP技术红皮书系列第22/206页第一种属于语义模型范畴，这里不再多述。着重讲下后两种。1.字段排序用户可以选择一个或多个字段，然后点击工具栏中的排序按钮，进行排序设置。排序工具按照：升序，降序，取消排序的顺序依次循环切换，可以通过多次点击来设置需要的排序效果。如果只通过这种方式设置过排序，则排序将按照从上至下，从左至右的顺序进行。若有分组，则在组内排序，对分组字段也可以排序，也可以按照分组统计字段进行排序。2.排序管理a)1中的字段排序是有缺陷的，无法完成以下需求：b)对于不在扩展区中的字段无法设置排序对于排序顺序也无法控制，只能按照从上至下，从左至右的顺序进行为了满足上述两种需求，同时为系统提供一个统一管理排序的地方，我们提供了排序管理，界面如下：图2-2-1排序管理设置界面UAP6.3报表平台技术红皮书UAP技术红皮书系列第23/206页各项设置说明如下：可扩展区域：显示当前报表的所有扩展区，可以在此切换扩展区，从而完成不同扩展区的排序设置。数据集：扩展区对应的语义模型名称，这是不可编辑的，只是提供给用户看。排序管理：在这里可以设置排序类型，也可以通过新增，删除按钮来增加或删除排序字段，还可以上移下移等按钮来调节字段的顺序。这里的唯一难点是排序类型的选择，需要重点讲解下：按界面顺序：如果设置的排序字段在扩展区中存在，则遵循“从上至下，从左至右”的顺序进行排序，当然对于扩展区外的字段，设置的顺序还是起作用的。按自定义顺序：严格按照上图表格中设置的字段顺序进行排序。分组管理暂时先不讲，等到讲分组专题时再细说。下面两个图分别是针对上图的排序设置，按界面顺序和按自定义顺序排序的结果，对照结果能更好的了解这两个设置的区别：UAP6.3报表平台技术红皮书UAP技术红皮书系列第24/206页图2-2-2按界面排序后的效果图2-2-3按自定义顺序排序后的效果UAP6.3报表平台技术红皮书UAP技术红皮书系列第25/206页2.3筛选自由报表的筛选总共有三种：单值筛选和筛选以及筛选条件（页维度也算一种筛选，又有些不同，单独放在一节中进行讲解），这三种是同时起作用的（即同时设置时会同时起过滤作用）。单值筛选只在数据态可用，其它两种数据态格式态均可用。2.3.1单值筛选单值筛选只在数据态起作用，选中列表中的一个单元格，则会拿着这个单元格的值去过滤，只保留与此单元格值相等的行。图2-3-1要应用单值筛选的数据如上图，选中“数码产品”后点单值筛选，则结果如下：图2-3-2单值筛选后的效果图再次点击该按钮时，作用是“取消筛选”。会显示全部数据。2.3.2筛选这个是单值筛选的升级版，可以选择多个值进行筛选，在数据态格式态中都是可用的。UAP6.3报表平台技术红皮书UAP技术红皮书系列第26/206页图2-3-3筛选条件设置及说明2.3.3筛选条件筛选条件是最复杂的筛选，可以分别针对可扩展区域和表内的语义模型进行设置，在设置时还可以选择覆盖还是追加。继续讲解前有必要对自由报表中的筛选条件的优先级作深层次的分析：图2-3-4筛选条件说明要点：1.筛选会把该所有的值列出来，用户可以选择一个或多个。2.复选框选上的说明是用户想看到的值，也就是说会把没打上勾的值过滤掉。3.全部都没打上勾时，不会进行任何过滤。相当于显示全部。4.筛选与后面要讲到的筛选条件是同时起作用的，如果值筛选完后感觉不对劲，可以检查下是否设置了其它筛选条件。5.在数据态时，界面中显示的只是当前显示给用户的值，如果想获得更多的值进行筛选设置，需要点击【读取数据】，这样才会把该字段对应的所有值列出来。UAP6.3报表平台技术红皮书UAP技术红皮书系列第27/206页如上图所示，可以在两个地方设置三种级别的筛选条件：定义语义模型时，可以对语义模型设置筛选条件，记为模型级筛选1；在自由报表设计中，可以对语义模型设计筛选条件（即点筛选条件，筛选范围选“数据集”），记为模型级筛选2；在自由报表设计中，可以对可扩展区域设计筛选条件（即点筛选条件，筛选范围选“可扩展区域”），记为区域级筛选3.这三种筛选条件在过滤时是有一定规则的：模型级筛选1始终生效区域级筛选3的优先级高于模型级筛选2叠加过滤：两种筛选同时起作用重新过滤：模型级筛选2不起作用模型级筛选对表内各扩展区都起作用，区域级筛选只对所在的扩展区起作用图2-3-5筛选条件设置UAP6.3报表平台技术红皮书UAP技术红皮书系列第28/206页各项筛选设置说明如下：筛选条件：就是设置你增加的筛选条件是模型级还是区域级的。可扩展区域：对应区域级筛选3。数据集：对应模型级筛选2。可扩展区域名称：当【筛选条件】选择的是【可扩展区域】时可用...
