SuccBI+低代码文档中心 — 分析报表

报表设计器界面介绍

报表设计器是用来设计报表的可视化工具，使用类Excel的、基于单元格的、所见即所得的方式设计报表，报表设计器界面如下图：

报表设计器主要包括如下功能板块：
数据源：数据源区域列出了可以用于报表中的数据，可以增加数据模型、添加表内数据加工、定义数据间的关联关系、增加计算字段和删除数据模型
组件区：组件区提供了丰富的输入组件和媒体组件。输入组件主要是参数过滤用途，媒体组件包含富文本，图标，图片等
参数栏：将组件拖入至参数栏，用于对报表数据进行筛选或者进行查询、导出等操作
工具栏：工具栏通过选中单个单元格或多个单元格并点击相应的工具按钮，可实现插入行、插入列、删除行、删除列、设置单元格等功能。通过点击下拉面板中的选项可设置表格样式和条件样式
表格区：类似Excel的Sheet页面，对加入报表表格内容进行编辑，通过拖拽或双击的方式添加数据源中的维度和度量至单元格中，同时支持书写固定文本及表达式：
列表头：选择列表头上的字母即可全选整列，如点击D，可选中该列单元格进行批量操作
行表头：选择行表头上的数字即可全选整行，如点击6，可选中该行单元格进行批量操作
属性栏：显示当前表格区或参数栏中选中对象的属性项和属性值，并可以对属性值进行修改，包括：数据、样式、交互等。

引用单元格写法说明：
单元格被组件等引用：在表达式中写法为工作表名+具体单元格，如main.A4
单元格被其他单元格引用

• 同一个工作表：可以直接写单元格名称，如A4
• 不同工作表：工作表名+具体单元格，如main.A4

报表组件

日期

制作报表

单元格取数

在报表设计器中引入数据模型后，就可以正式开始制作报表了。报表最核心功能是将数据表的数据以表格的形式展示出来，接下来本文将重点围绕取数来介绍。

浮动单元格

在报表中使用浮动设置将数据表中满足条件的数据展示在结果页面，数据表返回的结果集是一个二维数组，该数组中的每一个元素对应报表结果页面的一个单元格。

浮动有如下几个概念需要了解：

• 浮动主单元格：浮动主单元格是浮动的核心，浮动的设置是在该单元格上设置的。例如展示各个省份的销售数量，则这里的省份为浮动主单元格。
• 浮动方向：浮动的方向分为两个，分别是向下扩展和向右扩展。向下扩展即为纵向浮动，向右扩展为横向浮动。
• 浮动区域：浮动的扩展范围。在浮动区域内的行列，会跟随浮动主单元格一起根据浮动方向扩展。在浮动主单元格上设置的过滤条件，浮动区域内的单元格均会继承该过滤设置。

浮动设置可以做分组查询和明细数据查询，两者区别如下：

• 分组查询：将满足条件的数据按照浮动维度进行分类汇总，相当于sql语句中的group by。
• 明细数据查询：查询结果的每条数据，均对应于数据库表原始行的一条数据。适用于查询数据清单场景。
  如何设置分组查询和明细数据查询，可以查看如下章节内容。

查询分组
以制作各省销售情况表为例，操作步骤如下：

• 设置浮动主单元格和浮动方向：
  方法一：从数据模型列表处，展开【门店】，将【省】拖拽到A5单元格中。通过该方法设置的浮动单元格，会根据当前设计器的表格布局自动设置浮动方向，浮动范围为整行。
  方法二：选中单元格B5，点击工具栏>浮动下拉选择纵向浮动。
• 改变浮动范围：选中浮动主单元格A5后，橙色边框圈出了浮动区域，鼠标移至橙色边框处，会出现箭头图标，拖动即可修改浮动范围。

浮动更多说明

• 浮动主单元格有一个蓝色箭头图标，箭头的方向即为浮动方向。
• 当拖入维度到报表设计器中时，系统会根据拖入目标单元格的上侧/左侧单元格设置情况，来决定是否自动将目标单元格设置浮动主单元格及浮动范围。

查询明细数据
查询数据清单时可以使用查询明细数据功能，设置后显示的每条数据都对应于数据库表原始行的一条数据。查询明细数据和分组表查询的区分在于二者对计算结果的处理规则不同：

• 查询明细数据：将满足条件的原始行数据全部显示出来。
• 分组查询：将满足条件的数据按照浮动维度进行分类汇总，相当于sql语句中的group by
  如展示企业基本信息列表，操作步骤如下：
  1、选中浮动单元格，如B4。
  2、在右侧属性栏>单元格>浮动分组下，勾选查询明细即可实现。
  
  设置合并连续单元格

补全维项
补全维项可以将没有数据的维项也在报表中展示出来。例如事实表中只有上装、下装的销售数据，没有套装的数据，希望在报表中将所有类型都显示出来，就可以用补全维项将所有维项展示。补全维项只能在浮动主单元格上进行设置。
选中上下装指标的单元格，在单元格-浮动处勾选补全维项。

过滤不在维项中的数据
过滤不在维项中的数据可以过滤掉维表中不存在的维项数据。例如事实表的【上下装】字段中，有编码为02和99的数据，但在上下装维表中不存在编码为99的维项，如果只希望展示维表中存在的维项，就可以使用该功能过滤掉不在维表中的数据。过滤不在维项中的数据只能在浮动主单元格上进行设置。

条件单元格
当设置某个单元格为条件单元格后，在固定范围内的其他单元格均会继承其在过滤器上设置的过滤条件。设置操作步骤如下：


条件单元格说明：

• 条件单元格标识：E4单元格有一个漏斗图标，表示E4单元格为条件单元格，固定范围是从E4-E6（橙色边框高亮出这片区域）。
• 过滤条件继承：E4单元格上有过滤条件，则该固定范围内的单元格均会继承该过滤条件。

排序属性介绍
在弹出的排序对话框中，可以指定多个字段依次，也可以添加动态表达式：
字段：
排序依据：选择数据模型中的字段作为排序字段
排序方式：按照排序依据选择字段进行升序或者降序排列数据
聚合方式：指定排序依据字段的聚合方式。当为[明细查询]{#query-select}时，不能指定聚合方式
表达式：可以编写表达式作为数据的排序依据，如${[下拉框2].[值]} ${[选择面板1].[值]} 第一个值为排序依据，第二个值是排序字段。
分组表：需要三个动态参数，分别为排序依据、排序字段、聚合方式。
明细表：需要两个动态值，分别为排序依据、排序字段。

点击列标题排序
报表中也可以在单元格列标题上设置排序，即可在查看界面点击列标题上的排序按钮，使当前列的指标数据在升序、降序或不排序三种状态之间切换。排序按钮以图标形式显示当前排序状态。
只需在设计器选中对应列标题，在属性栏>单元格>排序中勾选点击列头排序，并设置相关属性即可：

排序单元格：

• 自动：按照正下方浮动区域的单元格排序，若有嵌套浮动，则按照最上层单元格排序。
• 自定义：可手动输入浮动区域的单元格进行排序，如B5。
  默认排序：设置点击排序按钮后首次的排序方式，提供升序、降序两个选项。
  允许无排序：不勾选，排序按钮只会在升序、降序两种状态间切换，勾选后，会增加不排序状态，即在三种状态之间切换。

更多说明
1、列标题排序只会让浮动区域的单元格生效，如下方没有浮动单元格，也会显示排序按钮，但点击无效。
2、当浮动单元格上设置了默认的字段排序后，点击列标题排序，会以当前列标题指标优先排序。
3、同时只有一个列标题指标排序能生效，当依次点击多个列标题排序时，只生效当前点击的一个。

样式设置

动态斜线单元格
动态斜线适用于报表行列动态变化的场景。
选中A3单元格，在右侧属性栏>样式>边框中，点击设置内部斜线按钮，弹出设置斜线单元格对话框。
类型：下拉选择动态斜线

• 区域文字：可输入动态宏表达式，支持从参数栏组件进行获取。例如，报表行列标题由组件cx1、cx2、cx3决定，${if(cx1!='',cx1+"|")}|${if(参数2!='',参数2+"|")}|${if(参数3!='',参数3+"|")}
  自定义样式：设置显示的边框类型、颜色和粗细。
  
  单元格内边距设置优先级：
  1、单独设置每一个单元格的内边距优先级最高。
  2、一键修改只针对未设置过单元格内边距的单元格，并将内边距值也写入对应单元格下的内边距中。

条件样式

使用条件样式可以实现使用样式标注符合规则的数据，可以帮助直观查看数据、发现关键数据问题和数据的变化趋势。例如：

• 使用红色文字标注同比增幅小于10%的省份。
• 使用不同的图标标注计划完成情况，绿色图标表示完成度超过90%。
  条件样式可以根据指定的条件动态更改单元格的外观，如果满足条件则设置作用范围内单元格的样式，否则不生效。 报表的条件样式包括突出显示、最前最后、数据条、色阶、步进器、图标集这六种，可以根据应用场景选择合适的类型。
  
  
  以下介绍具体的样式设置：
  
  
  
  
  
  

报表属性

报表高级选项，在设计器左上角文件>报表选项中，可以设置报表的全局选项。
默认显示工作表
NULL和0参与运算的规则
查看界面更多菜单是否显示

制作自定义主题的报表

系统支持自定义报表主题，当系统自带的主题无法满足项目需求时，可以根据项目设计并新增主题，本文将介绍如何去新增自定义主题。

新增自定义主题可按如下步骤操作：
确定主题规范：当确定了主题的主色调之后，还需要设计师去设计相关的配色，并产出主题规范
新增主题文件：通过复制或导入的方式，新增主题文件
修改主题色板和风格：根据设计师提供的主题规范，对主题进行自定义配置
更新缩略图：替换thumbnail.png文件
测试主题：测试新增的主题，确保颜色、风格无误

检查主题规范文件
设计师需提供主题规范，需要确认包含如下内容：
主题色板10个颜色
主题渐变10个颜色
6个指定的主题颜色：定义单元格边框、冻结行列线、以及输入组件的下拉面板和选中高亮的颜色
4组色阶（不限于4组）
单元格风格：大标题、行(列)标题_一级标题、表头(尾)、行(列)标题_二级标题、小计、合计(1)、合计(2)、解释性文字、链接单元格、注释。这些是归纳了常见的场景后做成的内置风格，覆盖了报表大多数应用场景。