这是本节的多页打印视图。点击此处打印.

报表设计

数据平台，数据流、数据集、报表设计。

1: 概览

2: 关键步骤

3: 在UDC中使用BI

API文档

数据BI集成开放API文档(V8&V5)

1 - 概览

BI概览

•低代码的BI分析平台，提供了低代码化（BIinside+）的构建低代码应用的BI统计分析决策能力，且支持自定义报表的实施应用能力。

•低代码的BI分析平台，提供大数据接入，采集计算与服务的能力。

应用场景

4大业务场景概览

在各大行业的多种「办公」「协同」「管理」和其他「业务场景」中，如果需要使用报表进行统计、分析、决策等，都可以通过BI报表结果分析：

主要的业务应用场景中，例如：「费控，发票，人事，项目，合同」「办公」「资产、合规」「文会事」等应用的场景中进行决策分析；开箱即用。
在流程管理体系中提供开箱即用的「流程绩效」分析能力，并提供多重个性化统计分析的能力。
管理驾驶舱、其他通用分析场景也可以使用报表进行个性化的决策分析，通过「报表管理」自定义报表或者数据大屏。
通过「数据大屏」所做的「炫酷大屏」的结果叫数据大屏，更常见用在数据或者经营结果监控，行业展览等场景中；企业可以通过辅助动效，3D效果等提升视觉效果。

直接通过「开箱即用」的「现代科技感模板」直接快速生成自己想要的炫酷大屏。

总的来说，低代码的协同BI平台，提供了多种数据源的数据连接和采集能力、数据整合与加工处理能力、一体化的数据管控能力、分析挖掘与可视化展现能力，

可满足客户的各种业务应用的数据分析一体化，也为企业用户提供大数据分析、自助式BI分析、中国式轻报表、移动端报表、数据大屏等。

低代码BI分析简介

低代码应用设计主流程

使用低代码平台进行应用开发，一般分为开发->测试->上线三个阶段。每个阶段都会有独立的环境，让各阶段数据隔离，保证正式上线版本稳定。

应用开发步骤如下图所示。

低代码的应用手册设计的前置应用设计，更多细节可以查看以下的手册:低代码平台操作手册

低代码应用设计使用BI分析

05in"}

自定义报表业务流程图

术语介绍

分析类产品名词

名词	含义
报表	通过BI工具所做的「可视化图表分析结果」的呈现结果称为报表，报表只是统称。一般是为业务，IT, 数据开发，产品，决策者提供统计分析决策的平台型工具。
数据大屏	通过数据大屏所做的「炫酷报表」的结果叫数据大屏，更常见用在数据或者经营结果监控，行业展览等场景中
数据集	在数据工厂，可以一键生成数据集，包括实体数据集、数据库表数据集等。数据集是专门针对数据可视化和分析要求构建的自助数据模型。
数据流	1、必须先创建数据集后，才能创建数据流。2、在数据工厂，可以创建多个数据流，数据流至少包括输入与输出两个节点。3、在输入与输出节点之间可以随意增加数据加工节点：字段设置、过滤、关联、联合、分组汇总等。4、一个数据流可以由多个输入节点，但仅一个输出节点，并最终生成数据流输出表。
数据源	当需要创建第三方数据库表数据集时，必须先配置第三方数据源连接信息。
指标管理	指标管理由指标定义与指标模型组成，缺一不可。根据数据标准规范，可以定义N个指标，再将相同维度的指标统一计算，生成指标模型表。
数据仓库	数据仓库（Data Warehouse，可简写为DW或DWH），是一个很大的数据存储集合，是面向主题、具有集成、随时间相对稳定、反映历史变化的。数据贴源层（ODS）：是数据仓库准备区，为DW层提供基础原始数据。数据仓库层（DW）：是数据仓库的主体，将ODS层中获得的数据按照主题建立各种数据模型。数据集市层（DM）：是基于DW上的基础数据，整合汇总成分析某一个主题域的数据集市层，用于提供后续的业务查询，OLAP分析等。
维度	维度是数据的观察角度，即从哪个维度去分析问题，看待问题。
度量	是从维度的基础上去衡算这个结果的值。
指标	聚合运算的结果。
事实表	事实表是指存储有事实记录的表，且其记录是动态的增长的。
维度表	与事实表相对应的表，它保存了维度的属性值，可以跟事实表做关联。
OLAP	联机分析处理（On-line Analysis Processing），从数据仓库中抽取详细数据的一个子集并经过必要的聚集，存储到OLAP存储器中供前端分析工具读取。
ETL	将业务系统的数据经过抽取、清洗转换之后加载到数据仓库的过程，目的是将企业中的分散、零乱、标准不统一的数据整合到一起，为企业的决策提供分析的依据。
缓慢变化维	随时间发生变化的维度。
X轴	图形上横向展示数据的坐标轴，用来和数据字段进行绑定
Y轴	图形上纵向展示数据的坐标轴，用来和数据字段进行绑定
图例	将数据按不同颜色分类，可以邦定数据字段
标签	固定显示在图形上的数据信息
悬浮提示	鼠标移入后显示的图形数据信息
联动	通过点击图表的局部区域，其他图形的数据会同步变动。
穿透	从报表页面跳转到其他页面，并通过参数对其他页面进行数据过滤或仅做跳转。
数据格式	日期和数值的显示格式，如“2023-01-02”，“100,000万”
排序	按降序或升序排列数据
预警	按照不同的数据值显示数据值颜色或背景颜色
过滤	通过对数据字段设置条件筛选出符合要求的数据，需结合操作符使用
操作符	用来匹配字段的数据值，也可以用于设置两个字段间的匹配关系，按字段类型进行划分：文本类型字段：包括等于、不等于、属于、不属于、包含、不包含、开头是、开头不是、结尾是、结尾不是；日期类型与数值类型字段：等于、不等于、大于等于、大于、小于等于、小于、介于、属于、不属于。

平台通用名词

角色	介绍
报表管理员	拥有该角色才有后台【报表中心】主菜单资源以及【数据工厂】、【指标管理】、【报表管理】三个子菜单资源。根据报表需求在【数据工厂】中进行分析数据准备，制作数据集。如需进行复杂的数据加工处理，则需制作数据流。同时可根据数据标准规范，在【指标管理】中定义指标，将相同维度的指标形成指标模型表。制作报表时，可选择任意选择数据集、数据流、指标模型的数据源，并可通过丰富的图表组件，生成PC报表、移动报表、数据大屏。

角色

介绍

报表管理员

拥有该角色才有后台【报表中心】主菜单资源以及【数据工厂】、【指标管理】、【报表管理】三个子菜单资源。根据报表需求在【数据工厂】中进行分析数据准备，制作数据集。如需进行复杂的数据加工处理，则需制作数据流。同时可根据数据标准规范，在【指标管理】中定义指标，将相同维度的指标形成指标模型表。制作报表时，可选择任意选择数据集、数据流、指标模型的数据源，并可通过丰富的图表组件，生成PC报表、移动报表、数据大屏。

主要场景示例

场景一：设计态UDC应用报表设计步骤 (修改中）

a) 在设计应用时设置报表穿透到UDC页面

应用设计使用报表

使用低代码平台进行应用开发，一般分为开发->测试->上线三个阶段。每个阶段都会有独立的环境，让各阶段数据隔离，保证正式上线版本稳定。

低代码的应用手册设计的前置应用设计，更多细节可以查看以下的手册:低代码平台操作手册, 涉及到到BI模块的使用时，在应用页面可以直接使用报表，具体操作如下：

点击应用菜单栏中的菜单模块，找到要使用报表的页面。

在页面设计器中，找到报表应用组件，拖入页面。

选中组件后，在右侧输入框1出点击选择要使用的报表，在输入框2处点击配置要做联动分析的参数映射，以和页面中的筛选条件进行数据联动。

4) 选择报表：

5) 配置参数：

特殊说明：该处字段映射所选的操作符需要与当前报表组件对应的页面查询区筛选字段操作符类型保持一致。

点击页面保存按钮后，该页面会在整个应用发布时，发布到前台供前端用户使用。

报表穿透到UDC应用页面

点击穿透设置输入框进入穿透设置界面
在设置界面中按照穿透的目标页面进行类型选择，选择直接跳转或条件跳转，并点击穿透页面输入框选择要穿透的应用页面，传递参数一栏，可以设置穿透时传递的参数。

特殊说明:

设置条件跳转时，需并将作为条件判断的选项值手动输入字段值输入框，然后作为选项选择。
应用页面参数如果是作用于应用的选项集、布尔、枚举类型字段，则报表的参数类型或参数值需要为编码而非具体的选项值。
如果是传递固定的值给应用页面参数，则可以使用报表自定义值进行设置。
报表参数列表选项中，@符号表示该参数取自查询区的相应字段值，无@符号则表示该参数值取自组件中已配置的字段值；@符号的字段参数通常适用非配置字段的跳转和返回传参设置。
如果报表的映射参数来自查询区，即带有@符号，则需要注意查询区该字段的操作符设置，需要与UDC页面中报表组件使用的该参数操作符保持一致，否则过滤结果无法生效。

b）设置与应用页面数据联动参数（TBD)

在报表的右侧查询项区域，可以将字段拖入上侧；拖入的字段可以在穿透时作为参数对穿透的目标页面进行数据筛选，也可以经过配置，在使用报表的应用页面中，和应用页面中的筛选条件进行数据上的联动分析。

场景二：如何做自定义报表

设计态和实施态：

创建数据集---》创建数据流（可选）----》指标定义及指标模型（可选）----》报表制作

序号	步骤	步骤说明
1	创建数据集	（1）在数据工厂菜单下–>数据集，新增数据集，选择CAP表单数据集/实体数据集，进入数据集设计页面。（2-1）在V5平台，选择cap3/cap4表单下的表单，进行表单数据集的设计。（2-2）在V8平台，选择应用下的实体，进行实体数据集的设计。（2-3）V5/V8平台，均可选择数据库表，进行数据集设计。（3）发布数据集，经由ETL引擎，生成数据集的数据。（4）数据授权，设置数据集的组织人员数据行列权限。
2	创建数据流（可选）	（1）在数据工厂菜单下–>数据流，新增数据流，进入数据流设计器，拖入输入节点，数据加工节点，输出节点以及更新设置。（2）发布数据流，经由ETL引擎，生成数据流输出表的数据。（3）数据授权，设置数据流输出表的组织人员数据行列权限。
3	指标定义及指标模型（可选）	（1）指标定义，在指标管理菜单下，定义指标，可连续定义多个指标。（2）指标模型，从指标库中选择相同维度的指标，汇总成一张指标模型表。（3）发布指标模型，经由ETL引擎，生成指标模型表的数据。（4）指标数据授权，设置指标模型表的组织人员数据行列权限。
4	BI报表制作	（1）在报表管理菜单下，新增报表，进入报表设计器，拖入图表组件，进行图表设置，并可连续创建多个图表组件。（2）报表布局：从组件设计器中返回报表，设置筛选条件，报表样式等。（3）移动端、大屏端的报表制作。（可选）（4）报表授权，设置报表的组织人员管理权限、使用权限。如大屏端，则需单独设置大屏设置绑定。

场景三. 报表中心如何展示报表

序号	步骤	步骤说明
1	报表分析	有应用报表、自定义报表或数据大屏的「使用权限」权限的人员，在报表中心的报表分析下查看报表数据。
2	分析方案	有报表权限的人员，可定制个性化分析方案（可选）。（1）在现有报表的基础上调整查询条件。（2）在现有报表的基础上可重新定义数据分析，并支持汇总方式与快速计算的重新定义。

查看的效果如下图所示：

点击全屏后查看：

场景四. 门户栏目使用报表

门户栏目报表使用步骤

序号步骤 步骤说明

1 我的报表空间设计器-->栏目选择器，选择"我的报表"栏目。

2 报表栏目空间设计器-->栏目选择器，选择"指定报表"栏目，配置报表。

截图如下：

场景五: 如何快速制作一个优雅的大屏或报表

大屏制作过程

操作步骤请见：2.6 创建数据大屏：

效果图如下

报表制作过程

1）报表中心：

自定义报表---->选择组件（组件布局）---->选择数据集，数据流或者指标模型--->拖拽数据列到维度或者度量区域----->可视化呈现

2）低代码应用

UDC应用---->新建实体数据集--->---->选择数据集，数据流或者指标模型--->拖拽数据列到维度或者度量区域----->可视化呈现

场景六. BI分析和大屏使用场景

1）快速使用区域地图

区域地图支持增强，支持地理角色设置成为「省/市/自治区」，「城市」，「区县」3种

1）选择列，比如说市设置地理角色

2）选择某个具体的「省/市/自治区」比如说云南，将会默认数据值自动匹配对应的地理位置

谨慎使用「全部」的选项

匹配规则中是按照数据列的值完全匹配的。

3）显示云南省的销售数据

4）其他相关效果图

2）快速制作GIS地图（TBD)

选择GIS地图--->普通的地理列-->转换经纬度---->拖拽度量列到度量区域

3）如何制作多指标卡

选择数据源--->配置--->直接将度量列---->拖拽到度量区域，如下所示：

4）如何制作排行榜

5）如何制作报表穿透

7）如何全局自定义报表标签

场景九. 数据建模场景

a）快速用行列转换做一个数据流

场景案例：按列查看每个审批节点的处理时长，目前原始数据是按行存储的

5.1 新建【数据流】，选择要处理的数据集，拖入【行列转换】节点，进行配置。这里行列转换字段选择【approver（处理节点）】，新列的值选择【duration（处理时长）】。通过数据预览可以看到，数据集中已经新增【处理节点-处理时长】组合成的新列，符合转换预期

5.2 新建【报表】，选择上面新建的行转列数据集，可以看到行转列新增的度量，拖拽到报表配置区，即完成行转列的数据处理和报表搭建

height=“2.348946850393701in”}

b）数据如何快速去重

场景案例：
- 场景一：去除指定列重复的数据，比如ID是主键，去除重复ID数据
- 场景二：去除所有列都重复数据

功能

拖入要去重的数据流/数据集节点
拖入去重节点，配置去重方案，按一个或多个字段进行去重
配置输出节点，保存该去重数据集，可以报表搭建等场景使用

c）如何使用实体数据集一键建模

选择「应用名称」-->「实体」--->连接方式，一般推荐方式为抽取，更多详情请见「创建实体数据集」章节。

2 - 关键步骤

BI设计的关键步骤

数据建模

数据集管理

实体数据集设计 (V8)

V8平台，可创建实体数据集、数据库表数据集。
实体数据集的聚合根关联及聚合关系适配：基于COP平台定义的实体元数据，自动识别实体关联关系与聚合关系、实体信息，懂业务即可做数据分析。
选项集适配：自动识别选项集与布尔类型，无需配置，自动显示业务概念。
实体参照适配：自动识别UDC实体参照，自定义参照方案设置。
组织模型及人员实体适配：自动识别复杂的组织模型实体，提供树表展示能力，实现OLAP的展示方式，更方便查看。
UDC应用预置角色适配：自动识别UDC实体预置角色，无需配置，自动实现角色数据权限及报表使用权限控制。

a）关键使用步骤

选择「应用名称」-->「实体」--->连接方式，一般推荐方式为抽取。

b）数据集操作

b.1) 常用操作

数据集字段显示或者隐藏
数据集字段多选显示或者隐藏
树表结构字段的层级展开
多选字段的拆分行
操作
- 字段重命名
- 字段显示| 隐藏

默认勾选显示隐藏字段将会在后台查询出来所有关联实体（包括子孙实体）的前500个字段并执行出来，取消勾选隐藏字段，这些字段的数据将不会被查询执行.

字段批量显示和隐藏
新建表达式
新建日期表达式
字段搜索（支持按照字段名称或者列名称搜索）

b.2）树表实体-层级展开

（实体数据集支持，CAP表单数据集不支持）

当实体字段为树表实体时，在OLAP分析中需将树表结构按层级展开，可最高设置9级展开（树表结构是OLTP，分析数据是OLAP，均需将树表按层级展示）。
组织树表：当实体字段中的组织、机构等树表实体时，仅可选其主键、名称、编号进行层级字段展开。
展开字段名称，默认以level1开头，其level1代表第一级，以此类推，level9代表第九级。

b.3）增加表达式

b.4）新建日期表达式

支持常见的日期周期的表达式如下，如果要支持常见的日期周期做固定报表，建议在数据集上先将这些日期表达式先新建好：

年月日，年周数，年季度，年月，年，

季度，周数，星期，年月日时，年月日时分，年月日时分秒

预览结果如下：

c）数据集的2种连接方式

c.1) 直连和抽取

直连：直连模式为会直连业务数据库查询数据

抽取：将会进行T+1的数据更新，实体数据有历史表的就根据归档时间achiveTime自动增量更新，更新时保持历史数据不变；如果实体无历史表全量更新数据. 支持按照每小时、每天、每周、每月更新。

c.2) 抽取和计算后的任务管理

报表管理员在【数据报表->数据工厂->数据集】数据集列表，点击操作下的创建任务，发布数据集（直连数据集无需创建任务）。一个数据集，只有经过创建任务，才会进行数据处理，生成数据集数据。

创建任务：将数据集定义信息，发布至ETL引擎执行数据加工计算处理，生成数据集数据。可通过数据预览、任务详情，验收任务情况。
下线任务：发布后的数据集可下线，取消ETL引擎执行任务。
任务详情：数据集执行任务的状态信息，如果数据预览无数据时，可检查任务详情中任务状态是否异常。
数据预览：默认取200条数据。

表单数据集设计（V5)

V5平台，可创建CAP表单数据集、数据库表数据集。
CAP数据集的主子表自动识别关联，枚举自动识别。
V5平台组织模型及人员等组织变量自动识别。

创建数据库表数据集

a）创建数据源

第三方库表，主要是用于接入外部数据源。【数据工厂】--》【源】

备注：第三方库表的ip信息，需进行安全认证，在nocas上配置白名单。

b）创建数据库表数据集

选择数据源->表或视图->连接方式（直连或抽取）

创建Excel数据集

应用场景

将线下维护的文件数据导入到BI里面进行可视化分析

功能简介

支持Excel和CSV文件导入
Excel文件支持多Sheet合并导入
追加数据，能够往已经导入的Excel数据集中追加新的Excel数据

导入数据

第一步：选择【数据工厂】->【数据集】->新建【新建Excel数据集】

第二步：选择上传文件或拖入上传文件，支持Excel和CSV格式

第三步：Excel数据集设置

选择添加数据：多工作表的Excel数据，可以在这里选择要导入的工作表，并且点击工作表名称进行工作表数据的预览。只要一个工作表的Excel数据或CSV文件，则无需选择
选择表头：多工作表的Excel数据，可能存在表头不一致的情况，这里可以指定用那个工作表表头
数据详情：点击每个工作表数据，可以预览该工作表导入数据集后的数据
字段信息：可以支持修改字段名称和数据类型
字段映射：Excel多工作表且工作表表头不一致时，保存时会弹出表头映射，选择对应的表头，如果为空的表头则工作表该列导入无数据

a. 表头名称不一致，需要手动选择映射

b. 该工作表无该列，可以为空

第四步：保存预览

查看导入进度：可以在列表页查看进度和导入进度详情
数据预览：数据导入成功后可以进行预览

追加数据

第一步：【编辑】要追加数据的Excel数据集

第二步：点击【追加数据】

第三步：选择要追加的文件或拖入要追加的文件

第四步：预览要追加的数据，点击保存即可追加数据。如果要追加多工作表的数据，可以参考导入文件多工作表配置，如果导入的工作表表头和数据集表头不一致，可以在保存时做表头映射，参考导入文件表头映射

数据流管理

一个数据流，必须有一个或N个输入节点，0或N个数据加工节点，一个输出节点。
数据流输出表生成的是主题宽表，是数据准确的重要部分。
数据流设计器：

输入节点

创建数据流，第一步必须选择输入节点。即将输入节点拖入画布区，选择数据源。

数据加工节点

a）关联节点

关联节点：类似SQL中的join语句，根据关联字段进行关联，其关联数据合并到一张输出表中。单个关联节点支持2个输入表，如果需要多表关联，需增加多个关联节点。

b）联合节点

联合节点：类似SQL中的union语句，将2-5个输入表，相同类型的字段进行字段数据的合并至一张输出表中。

c）分组和汇总节点

分组汇总节点：类似SQL中的group by语句，将相同数据合并成一组，然后按分组后数据进行汇总计算。

d）过滤节点

过滤节点：类似SQL中的where语句，设置过滤条件，过滤掉无用的数据。

e）字段设置节点

字段设置：字段的重命名、增加计算字段、字段选择（含字段顺序调整）。其中增加计算字段是通过公式函数来实现的，函数分为数学与三角函数、日期函数、文本函数、逻辑函数。

f）行列转换

版本

BI版本                               说明

v2.8.0                                无

场景

场景1：按列查看每个审批节点的处理时长，目前原始数据是按行存储的

5.2 新建【报表】，选择上面新建的行转列数据集，可以看到行转列新增的度量，拖拽到报表配置区，即完成行转列的数据处理和报表搭建

功能

拖入要去重的数据流/数据集节点
拖入行转列节点，配置行转列方案，选择行转列字段（只能选择一个）、新列值字段（支持选择多个）
配置输出节点，保存行转列成功数据集，可以报表搭建等场景使用

g）去重

版本

BI版本                               说明

v2.8.0                                无

场景

场景一：去除指定列重复的数据，比如ID是主键，去除重复ID数据

场景二：去除所有列都重复数据

功能

拖入要去重的数据流/数据集节点
拖入去重节点，配置去重方案，按一个或多个字段进行去重
配置输出节点，保存该去重数据集，可以报表搭建等场景使用

输出节点和更新设置

按开始时间，每小时、每天、每周、每月执行更新数据流。默认每天更新。还可以设置任务执行时间及结束日期。

指标管理

指标定义

报表管理员从【右上角->头像->后台管理】进入后台，在【数据报表->指标管理->指标定义->新建】创建指标。指标定义后，必须经过指标模型的发布后，才会生成指标模型表数据。

基本信息：指标名称、数据来源。
指标设置：汇总方式、维度选择、时间维度、过滤条件。

指标模型

在【数据报表->指标管理->指标模型->新建】创建指标模型，即将相同维度的指标模型成一张指标模型表。

基本信息：指标模型表名称。
指标选择：选择基础指标、显示维度选择、添加其他指标并进行维度映射。
定时设置：简单配置、复杂配置

发布指标模型

报表管理员在【数据报表->指标管理->指标模型】指标模型列表，点击操作下的创建任务，发布数据模型。一个指标模型，只有经过发布，才会进行数据加工计算，生成指标模型表数据。

创建任务：将指标模型定义信息，发布至ETL引擎执行数据加工计算处理，生成指标模型表数据。可通过数据预览、任务详情，验收发布情况。
取消任务：发布后的指标模型可下线，取消ETL引擎执行任务。
任务详情：数据流执行任务的状态信息，如果数据预览无数据时，可检查任务详情中任务状态是否异常。
数据预览：默认取200条数据。

指标模型授权

在【数据报表->指标管理->指标模型->数据授权】进行指标模型的数据授权。可设置授权组织对象、行权限设置、列权限设置。

授权对象：可授权组织中的个人、多人。
行权限设置：可设置数据表中第一行的权限条件。
列权限设置：可设置数据表中的每一列，默认是全部列。

任务管理

报表管理员在【数据报表->数据工厂->数据流】数据流列表，点击操作下的创建任务，发布数据流。一个数据流，只有经过发布，才会进行数据加工计算，生成数据流输出表数据。

创建任务：将数据流定义信息，发布至ETL引擎执行数据加工计算处理，生成数据流输出表数据。可通过数据预览、任务详情，验收发布情况。
取消任务：发布后的数据流可下线，取消ETL引擎执行任务。
任务详情：数据流执行任务的状态信息，如果数据预览无数据时，可检查任务详情中任务状态是否异常。
数据预览：默认取200条数据。

资源和数据授权

资源授权

在【数据报表->数据工厂->数据集->数据授权】进行数据集的数据授权。可设置授权组织对象、行权限设置、列权限设置。

授权对象：可授权组织中的角色、部门、个人、多人。
行权限设置：可设置数据表中第一行的权限条件。
列权限设置：可设置数据表中的每一列，默认是全部列。

授权对象-选人界面（V5-BI平台）

授权对象-选人界面（V8-BI平台）

数据授权

在【数据报表->数据工厂->数据流->数据授权】进行数据流的数据授权。可设置授权组织对象、行权限设置、列权限设置。

授权对象：可授权组织中的个人、多人。
行权限设置：可设置数据表中第一行的权限条件。
列权限设置：可设置数据表中的每一列，默认是全部列。

行级数据授权

场景：在一个大型组织中，用户U1需要看到A机构财务部数据和B机构财务部数据

功能：支持行级数据权限嵌套

入口：【数据集】、【数据流】、【数据模型】->【数据授权】->【新建】->【行权限】

创建报表

报表管理员从【右上角->头像->后台管理】进入后台，在【数据报表->报表管理->新建】创建报表。一张报表，包括一个或多个可视化组件。如下报表设计器：

组件区：图表组件、布局组件、过滤组件、其它组件。
复用：制作报表时，支持直接复用已有报表组件，方便简洁。
大纲：方便查看PC端、移动端、大屏端的组件使用情况。
一屏三端：PC端、移动端、大屏端，组件共享，样式独立。
查询项：报表组件的数据模型字段，均可拖入查询区，设置筛选条件。
报表样式：可以设置整体边距、所有组件的标题、全部表格样式风格、查询区样式。

图表组件设计

支持的图表范围说明（总览）

分类	名称	构图
图表组件	垂直表
交叉表
明细表	多个维度、多个度量	都是明细数据列
排行榜	多个维度、一个指标、0个或者多个辅指标
饼图	1个维度、1个度量	维度为颜色分组
环形图	1个维度、1个度量
垂直柱状图	1个维度、1个或者多个度量
垂直堆积图	1个维度、1个或者多个度量
水平柱状图	1个维度、1个或者多个度量
水平堆积图	1个维度、1个或者多个度量
折线图	1个维度或者2个维度、1个或者多个度量
面积图	1个维度或者2个维度、1个或者多个度量
柱折图	1个维度、1个或者多个度量
棒棒图		可以通过柱折图构成
散点图	1个维度、1个或者多个度量
雷达图	1个维度、1个或者多个度量
漏斗图	1个维度、1个度量
仪表盘	2个度量
进度图（进度条或者环形图）	2个度量
区域地图	1个区域维度、1个或者多个度量
指标卡	度量
词云	1个维度、1个度量
布局组件	Tab组件	每页有一个Tab
组合组件	组件框
其他组件	数字时钟	类型和格式
滚动消息	消息类型、滚动方向
文字编辑（富文本）	文本编辑框	可以插入文字说明系统变量和查询项的参数，切换查询项的值时富文本中的值将会随之变化
倒计时	颜色、样式、截止时间
图片	图片选择框

2.4.1.2 使用说明

1）制作垂直表

选择图表类型：垂直表
分组区只允许拖入维度字段。
明细区可拖维度字段、度量字段。明细区的维度，按维度字段内容进行分组计算，但表格自动按明细展示。
过滤区可拖维度字段、度量字段。
表格预览区与数据结构区可按列设置表格内容样式、穿透、条件样式

数据源区

维度转换度量，为维度的计数。度量转维度，为度量转文本类型。
添加计算字段：对已有的字段再计算，从而可以得到新的字段。支持汇总函数、快速计算函数、数学与三角函数、日期函数、文本函数、逻辑函数。

处理数据

数据排序：维度排序、组内排序、度量排序。

维度自定义分组：支持维度值的自定义分组。

日期维度分组：支持年月日、年月、年等多种分组方式。
空值设置：支持自定义空值显示、维度的空值设置、度量的空值设置、度量的0值设置。
过滤-参照：主键参照支持单选、多选，对应运算符为等于、属于。

分析数据

汇总计算：根据维度，求和、最大值、最小值、求平均、计数、标准差、方差。
快速计算-同环比：同期、环期、同比增长值、同比增长率、环比增长值、环比增长率。同环比，分组区的维度字段必须包括日期维度字段。

预警设置

支持度量的数据预警，按操作符设置条件值。
支持预警值的颜色设置、图形设置。
针对单个度量，支持连续添加多个预警设置。

穿透设置

支持报表与报表之间的穿透。
- 可选择报表分类下所有的报表。
- 可传递参数，当前报表分组区、明细区的维度以及报表查询项的维度。
- 报表组件的数据源相同，传递参数才有效，否则无效。不同数据源的报表组件穿透可通过报表与应用页面的参数映射实现。
支持报表与应用页面的穿透。
- 直接跳转，选择应用页面，设置传递参数。
- 条件跳转，按垂直表组件分析区的维度设置条件跳转，可支持跳转多个页面。
支持链接穿透。

样式设置

组件名称命名
表格格式
列表与树状
每页条数设置
边框设置
表头设置
总计/小计
表格设置

数据格式

默认系统格式。
支持千分位、数字、百分比、货币、万、亿以及日期格式。
支持时长的天时分特殊格式。

多表头设置

树状垂直表

树状垂直表，当多维度时，不支持全排序，仅支持组内同层级的排序。
树状垂直表，不支持每页显示设置。
树表显示场景下，支持节点值去重设置。

制作交叉表

选择图表类型：交叉表
行交叉区拖入维度字段，列交叉区拖入维度字段，度量区拖入度量字段。
处理数据、分析数据、预警设置、穿透设置、样式设置均与垂直表相同。

3）制作排行榜组件和明细表组件

支持版本RC2.8.0

用户可以设置序号样式如下图

设置不同样式

设置进度条渐变

4) 制作可视化图表

选择图表类型：拖入可视化组件后，在组件切换区选择图表类型
将数据源区字段的维度字段拖入数据配置区：

饼图、环形图、雷达图、词云图、漏斗图：维度区拖入维度类字段，度量区拖入度量类字段。
垂直柱状图、堆叠柱状图：X轴可拖入1个维度类字段，Y轴可拖入多度量类字段。
水平柱状图、水平堆积图：Y可拖入1个维度类字段，X轴可拖入多度量类字段
折线图、面积图：X轴可拖入1个或2个维度类字段，Y轴可拖入多度量类字段。
柱折图：X轴可拖入1个维度类字段，Y1轴可拖入多度量类字段，Y2轴可拖入多度量类字段。
散点图：维度可拖入一个维度类字段作为数据点名称，X轴和Y轴可拖入单个度量类字段。
仪表盘：度量和最大值指标支持拖入单个度量类字段，
进度图：度量和目标值指标支持拖入单个度量类字段。
地图：维度支持拖如单个地区类型的维度类字段，度量可拖入多个度量类字段
指标卡：度量支持拖入单个度量。
过滤区：可根据需要，拖入维度和度量类字段设置过滤条件。

在样式设置区按照配置项设置组件样式。

图形区设置：
- 饼图：包括最大扇形数设置、图表配色设置，
- 环形图：包括最大扇形数、图表配色，显示总计开关、总计数据格式设置，
- 垂直柱状图、水平柱状图、包括折线图、面积图：图表配色设置，展示方式设置，
- 垂直堆积图、水平堆积图：包括图表配色设置，展示方式设置，图形切换设置，支持堆积和百分比堆积两种图形。
- 雷达图：包括图表配色设置，显示模式设置，支持切换为面积雷达图和线形雷达图。
- 散点图：包括图表配色设置，展示方式设置，分割区域设置。
- 漏斗图：包括图表配色设置，数据标签位置设置
- 仪表盘：包括图表配色设置，指标自定义名称及单位设置。
- 进度图：包括图形切换设置及其他样式设置，支持切换为环形进度图，条形进度图。
- 地图：包括地图区域选择，数据格式设置，视觉栏显示开关
- 指标卡：包括指标显示模板设置、对齐方式及背景色设置。
- 词云：包括图表配色设置。
圆点设置：包括圆点设置开关，圆点大小设置。折线图、面积图、柱折图支持。
区域颜色设置：仅地图组件支持，包括对地区区域样式的各类设置。
图例设置：包括图例位置设置，图例分类名称自定义设置，分类名称以";"间隔。
X轴设置：包括轴标题，轴标签的文本显示开关及样式设置，固定值和动态值辅助线设置。其中，X轴文本过长导致显示不全时，可以通过调整显示角度或单行文本数来调节。文本步长用来调节X轴标签的稀疏程度。
Y（Y2）轴设置：包括标题及标签文件的显示开关、数据格式、最小值、最大值、步长、固定值和动态值辅助线设置。
标签设置：包括位置设置和标签格式设置，该值固定显示在图形上。
悬浮提示：包括显示格式设置，该值通过鼠标移入或点击图形进行显示。
联动设置：包括设置可联动显示的组件，通过点击图形区域进行联动。设置时，可勾选的组件为配置了相同数据源的组件
穿透设置：同2.3.1.1中垂直表中的穿透设置

特殊说明：垂直柱状图和垂直堆积图的X轴对应上述属性中的Y轴，Y轴对应上述属性中的X轴。

预览区可查看已经配置的数据及样式。

5）制作地图

5.1）区域地图（「省/市/自治区」，「城市」，「区县」）

区域地图在RC2.8.0 支持增强，支持地理角色设置成为「省/市/自治区」，「城市」，「区县」3种

1）选择列，比如说市设置地理角色

2）用户可以设置选择列->更多设置「地理角色」省，市，县来「自动获取」字段中的值「完全匹配」地理角色的值；没有检测

到值的数据显示红色，用户可以手动设置选择值匹配。

选择某个具体的「省/市/自治区」比如说云南，将会默认数据值自动匹配对应的地理位置；

在城市的地理角色中，谨慎使用「全部」的选项

3）设置完成地理角色后列图表将会变为地理标识icon，将此列加入面积区域，并拖拽对应的列到度量区域

显示云南省下所有市的销售数据，请注意悬浮提示tooltip的信息和度量区域配置的列相关。

4）其他相关效果图

5.2）制作GIS地图 (RC 3.0.0)

支持高德的标准地图，区域地图，3D地图，卫星地图，热力地图

配置过程

选择文本列->生成经纬度列->经度列拖拽到经度列区域，维度列拖拽到维度度列区域，度量加入，直接可以拖入对应区域即可

配置项：

属性	说明
「点标记量」：	值区间1-2000为点标记显示（数量超过点标记量值开启海量点）
「形状颜色」：	值区间1-2000为点标记显示（数量超过点标记量值开启海量点）如果形状颜色超过了2000个，形状的颜色功能将会不生效「形状」：默认4种形状，超出后的颜色可以从系统的icon库上传。
「地图坐标系」	默认高德
「中心区域」	以登录人员的位置默认所在区域为中心区域

展示效果（标准地图等）

3D效果

卫星地图

6) 添加数据筛选效果

方法一：设置查询区

报表组件内的数据模型字段均可当筛选条件拖入至查询区。
支持对拖入的查询区的筛选条件进行操作符以及默认值设置。

方法二：设置筛选组件

拖入日期筛选组件
选中筛选组件，点击编辑按钮后，配置组件。
- 日期筛选组件：可配置标题、筛选的字段、快捷选项及自定义选项。
- 数值筛选组件：可配置标题、筛选的字段以及操作符类型。

7）制作布局组件

tab组件：可以通过切换页签在相同区域显示不同可视化图表

选中组件后，点击编辑按钮进入样式设置和页签设置区域，可设置标题样式，添加页签。
页签设置完成后，可在组件区域选择页签区域要放置的其他组件，每个页签仅支持一个组件

组合组件：可以通过组合组件按需摆放组件的位置。

拖入组合组件后，再将其他组件拖入组合组件中进行位置移动即可。

8）使用其他组件

数字时钟组件：拖入组件后点击设置时钟显示格式
滚动消息组件：拖入组件后点击组件，在弹窗中设置需要滚动展示的内容及样式
文字编辑组件：拖入组件后点击组件，在弹窗中设置需要展示的内容及样式。
倒计时组件：拖入组件后，设置截止时间即可。
图片组件：拖入组件后，可点击选择内置或本地的图片素材。

9）表格设置说明专区

默认显示如下：

9.1) 表格支持表头和内容区域换行

「自适应」或者「固定行数」显示处理文本较长时换行的场景

垂直表，交叉表，明细表都支持

9.2）表格的页码隐藏

当行总数小于每页条数，垂直表和交叉表的分页页码将会自动隐藏（200上限）

10）文本编辑支持插入参数和变量

配置：

过滤下拉菜单多选设置点击「查询」按钮后，自动可以在文本编辑器中获取多选的值。

11）指标卡支持多指标

新增配置项改变SVG的颜色并适配3端，PC端，手机和大屏。

11.1）指标配置

1）设置指标间的实线和虚线，

每个指标可以对于单独设置字段的「数值大小」，「文字颜色」等，指标icon可设置渐变。

也可以按住CTRL健批量设置。

11.2）指标卡展示效果

通用设置项说明

1）表格通用设置

设计师在报表「设计器」->组件编辑->数据表处自动自适应

如下，字段名称「长名称字符串测试下」会根据设置的内容自适应。

如果报表或大屏的进度条宽度太小，可以选择表格->「批量设置列宽」-->销售额-->宽度设置宽一点即可。

支持的表格范围：垂直表，明细表，交叉表，明细表

2）图表通用设置

1.2.1）设置起始轴

默认自动根据指标列获取起始轴，用户也可以自定义起始轴的数据值。

1.2.2）设置轴标签

1.2.3）设置悬浮提示

1.3）数据格式设置

在报表或者数据大屏所有的组件都支持场景格式，设置后常见的数据格式，展示如下：

支持的数据格式

如下所示：其中千，万为V3.0.0新增设置:

无格式

天时分

历史定义：按分钟数转的

天

历史定义：按分钟数转的

小时

历史定义：按分钟数转的

分钟

千分位(#)

千分位(#.0)

千分位(#.00)

千分位(#.000)

千分位(#.0000)

数字(#)

数字(#.0)

数字(#.00)

数字(#.000)

数字(#.0000)

%(#)

%(#.0)

%(#.00)

%(#.000)

%(#.0000)

货币(#)

货币(#.0)

货币(#.00)

货币(#.000)

货币(#.0000)

千（#）

千（#.0)

千（#.00)

千（#.000)

千（#.0000)

万(#)

万(#.0)

万(#.00)

万(#.000)

万(#.0000)

亿(#)

亿(#.0)

亿(#.00)

亿(#.000)

亿(#.0000)

yyyy-MM-dd

yyyy年MM月dd日

yyyy/MM/dd

1.4）报表管理通用设置

1.4.1）报表导出PDF

导出PDF和导出EXCEL都可以在设计态导出控制导出功能。

在实施态报表管理列表中支持导出PDF
在用户态也支持直接导出PDF.

1.4.1）报表导出EXCEL( TBD)

报表布局设置

报表设置：可设置页面标题、页面背景色、组件间距、报表页面边距。
组件设置：统一设置组件标题样式，图表配色风格和表格风格，该设置会覆盖已经设置的单个图形组件的配色。
查询区样式设置：可设置页面查询区的背景及文字样式设置
报表缓存：开启后，可对报表的数据进行短期存储，提高再次访问的速度；预缓存方案，设置后，可对报表的查询方案进行存储，提高特定查询条件下的报表访问速度，该设置需要方案与报表的查询条件保存一致。
报表属性：可以对前台用户访问报表时展示界面中的导出按钮、查询区域、显示方案的功能设置显示或隐藏。
导出设置：可以通过添加查询区的字段，将查询后的字段值添加到报表导出的文件名称中。
复用列表：会展示所有已经创建的组件，可直接拖入页面进行使用和二次编辑。

移动端页面配置

点击编辑按钮，进入页面设计态
通过切换页面类型可以配置移动端页面，该功能通常结合复用列表进行使用。可以将已经配置完成的组件拖入移动端页面进行二次编辑和修改。组件配置界面和PC端一致。

报表授权

在【数据报表->报表管理】进行报表授权，且可设置授权组织对象。报表授权为双重授权机制，只有设置了报表组件的数据权限，才可查看报表数据。

使用授权：，用户可查看报表，当报表组件数据授权下，可查看报表组件数据。
管理授权：用户可查看报表、修改报表。管理授权，自动赋予报表组件的数据权限。
大屏设备绑定：针对大屏端，通过特殊账号进行大屏端绑定，登录其特殊账号，即可展示大屏内容。

报表展示效果示例（TBD)

应用报表设计发布后实施态支持编辑

支持版本：V2.8.0

「人事管理」应用设计发布后的报表在实施态可以直接编辑，编辑后「保存」的报表还是属于「人事管理」，「另存为」后「将会属于「报表中心」。

点击「保存」后提示如下：

创建数据大屏

1）选择大屏模板

2）选择「科技蓝模板」

3）拖拽可视化组件并配置数据，组件配置界面和PC端一致。

4）在组件列表中，可以拖入数字时钟、滚动消息、倒计时等组件为大屏配置具有动态效果的组件。

点击编辑按钮，进入页面设计态
通过切换页面类型可以配置大屏端页面，该功能通常结合复用列表进行使用。可以将已经配置完成的组件拖入大屏端页面进行二次编辑和修改。
切换「科技蓝模板」或者「空模板」都可以选择风格进行数据展示。

大屏效果

报表中心

报表中心直接可以展示自定义报表，应用报表，数据大屏

数据大屏的展示是在V3.0.0展示。

3 - 在UDC中使用BI

BI设计器使用指南

进入业务应用中的报表设计模块

登录账号并进入运营平台。
切换到工作台后，从自建应用菜单进入业务应用列表。
找到要应用报表的业务应用，点击设计按钮，进入应用设计态。

在应用设计态页面中，找到BI菜单，点击并进入报表设计模块

配置数据流

创建数据流

进入数据流列表，点击新建，开始数据流配置，如果是编辑已有的数据流，则可通过搜索框输入数据流名称进行查找，找到后，点击编辑按钮即可
进入数据流编辑页面后，可以看到左侧的数据流节点区域，总共3类，其中输入节点和输出节点为必要的节点，输入节点可以拖入多个，而输出节点仅可拖入一个。节点拖入后需要通过连接点进行连接。

实体节点：可以选则本应用及依赖应用下的所有数据表，按照数据处理需要，选择相应字段。

字段设置：可以对已选的数据表字段进行字段定义、重命名、类型调整、控制是否作为输出字段。

字段设置-添加计算字段：可以通过点击按钮进入自定义字段界面，通过对已有字段进行公式、函数计算，按照分析需要生成新的字段。

字段设置-字段选择：点击后，可以通过选择设置，对输出表字段进行选择性显示。

字段设置-重命名：可以修改字段的显示名称。

字段设置-修改字段类型：可以对字段的数据类型进行调整。

字段过滤，可以对某一字段进行过滤条件设置以满足特定的数据分析需要。

表输出，拖入后连接节点，可预览输出的表字段。

修改表名称后，数据流创建完成。

设置数据流更新周期

点击更新设置，按照预定设置开始日期、执行频率、任务执行时间、结束日期。

配置数据流权限

进入数据流列表，点击数据授权输入框

弹出的页面中，选择角色并进行数据授权。

配置指标

定义指标

1、进入指标管理模块，点击指标定义，点击新建按钮。

输入指标名称，选择定义指标所选的数据源、度量计算方式、维度、时间维度、过滤条件后，可以进行保存。保存后，一个指标即定义完成。

配置指标模型

进入指标模型列表页，点击新建
在编辑页面输入指标模型信息，先选择基础指标，再并选择要合并的指标构成指标模型，勾选维度可以显示指标模型分析时用到的维度。

输入更新周期设置，操作可参考数据流更新周期。

4、设置完成后，点击保存即可生成一个指标模型

3.4 配置报表

创建分析报表

进入报表管理模块，点击新建按钮。

拖入要分析的组件类型，选择模型进行数据配置。

数据配置界面中，在数据源区，将字段按照类型拖入组件的维度配置区，过滤区也可以拖入字段，并设置数据的过滤条件；在右侧组件类型区域切换图形组件类型、下方的设置项配置区，设置组件的显示样式。

可以在数据源区按照分析需要，新增计算字段。

设置报表与应用页面间的穿透

点击穿透设置输入框进入穿透设置界面
在设置界面中按照穿透的目标页面进行类型选择，选择直接跳转或条件跳转，并点击穿透页面输入框选择要穿透的应用页面，传递参数一栏，可以设置穿透时传递的参数。

特殊说明:

设置条件跳转时，需并将作为条件判断的选项值手动输入字段值输入框，然后作为选项选择。
应用页面参数如果是作用于应用的选项集、布尔、枚举类型字段，则报表的参数类型或参数值需要为编码而非具体的选项值。
如果是传递固定的值给应用页面参数，则可以使用报表自定义值进行设置。
报表参数列表选项中，@符号表示该参数取自查询区的相应字段值，无@符号则表示该参数值取自组件中已配置的字段值；@符号的字段参数通常适用非配置字段的跳转和返回传参设置。
如果报表的映射参数来自查询区，即带有@符号，则需要注意查询区该字段的操作符设置，需要与UDC页面中报表组件使用的该参数操作符保持一致，否则过滤结果无法生效。

设置与应用页面数据联动参数

配置报表的使用权限

保存报表返回到报表列表中，点击报表的使用授权对报表的使用权限进行授权，这样可以按照用户角色分配报表。

在业务应用中使用报表

点击应用菜单栏中的菜单模块，找到要使用报表的页面。

在页面设计器中，找到报表应用组件，拖入页面。

选中组件后，在右侧输入框1出点击选择要使用的报表，在输入框2处点击配置要做联动分析的参数映射，以和页面中的筛选条件进行数据联动。

选择报表：

配置参数：

特殊说明：该处字段映射所选的操作符需要与当前报表组件对应的页面查询区筛选字段操作符类型保持一致。

点击页面保存按钮后，该页面会在整个应用发布时，发布到前台供前端用户使用。

BIInside+示例

版本号： V2.8.0

加开关控制优先加载报表数据或页面规则的数据。

默认开启，进入页面就会自动加载报表数据;

关闭后，进入应用页面将不会去请求报表数据，优先会加载初始化页面规则或者其他规则而不加载报表数据。

报表设计

API文档

1 - 概览

应用场景

4大业务场景概览

低代码BI分析简介

低代码应用设计主流程

低代码应用设计使用BI分析

自定义报表业务流程图

术语介绍

分析类产品名词

平台通用名词

主要场景示例

场景一：设计态UDC应用报表设计步骤 (修改中）

a) 在设计应用时设置报表穿透到UDC页面

应用设计使用报表

报表穿透到UDC应用页面

b）设置与应用页面数据联动参数（TBD)

场景二：如何做自定义报表

场景三. 报表中心如何展示报表

场景四. 门户栏目使用报表

场景五: 如何快速制作一个优雅的大屏或报表

大屏制作过程

报表制作过程

场景六. BI分析和大屏使用场景

1）快速使用区域地图

2）快速制作GIS地图（TBD)

3） 如何制作多指标卡

4）如何制作排行榜

5）如何制作报表穿透

7）如何全局自定义报表标签

场景九. 数据建模场景

a）快速用行列转换做一个数据流

b）数据如何快速去重

c）如何使用实体数据集一键建模

2 - 关键步骤

数据建模

数据集管理

实体数据集设计 (V8)

a） 关键使用步骤

b） 数据集操作

b.1) 常用操作

b.2）树表实体-层级展开

b.3）增加表达式

b.4）新建日期表达式

c）数据集的2种连接方式

c.1) 直连和抽取

c.2) 抽取和计算后的任务管理

表单数据集设计（V5)

创建数据库表数据集

a）创建数据源

b）创建数据库表数据集

创建Excel数据集

应用场景

功能简介

导入数据

追加数据

数据流管理

输入节点

数据加工节点

a）关联节点

b）联合节点

c）分组和汇总节点

d）过滤节点

e）字段设置节点

f）行列转换

g）去重

输出节点和更新设置

指标管理

指标定义

指标模型

发布指标模型

指标模型授权

任务管理

资源和数据授权

资源授权

数据授权

行级数据授权

创建报表

图表组件设计

3）如何制作多指标卡

a）关键使用步骤

b）数据集操作

支持的图表范围说明（总览）