报表数据源配置
1 功能介绍
报表数据源配置是极速报表的核心配置,采用极速报表框架开发的报表,都有对应的一个或多个报表数据源配置,报表在运行时,会实时加载已启用的数据源配置,解析配置内容,结合报表的查询条件,生成报表数据。通过报表数据源配置可以实时的调整报表相应的逻辑。
2 应用场景
1、直接开发:采用极速报表框架开发具体业务领域报表时,需要新增报表数据源配置。
2、扩展调整:在原报表基础上做相应的调整时,需要通过克隆配置,启用配置,来实现扩展调整。
3 系统路径
供应链云>业务设置>报表配置>报表数据源配置
4 关键字段/按钮说明
4.1 关键字段说明
面板 | 字段名称 | 详细解释 |
基本信息 | 报表实体 | 必录,代表配置是用于哪个报表的。 |
数据隔离组织 | 报表实体的组织类型字段,用于处理按组织隔离业务数据。 | |
字段库 | 必录,代表报表查询时,基于哪个字段库来做配置。 | |
使用状态 | 默认为禁用,同一报表实体只允许启用一个配置。 | |
报表查询最大超时时间/分钟 | 代表AlgoX计算任务最长运行执行多久,超时则会报超时异常,默认为30分钟,建议不修改。 | |
系统预设 | 标识配置是否是系统预设的,系统预设的配置不允许界面删除。 | |
报表字段配置 | 字段库名称 | 从字段库带出来的字段标识,无法修改。 |
字段库名称(字段库) | 从字段库带出来的字段名称,无法修改。 | |
字段库名称(报表显示) | 对字段库名称重命名,用于在报表界面显示。默认同字段库名称。 | |
显示属性 | 指定基础资料相关类型字段显示名称、还是编码。默认为自动处理(显示名称)。 | |
显示引用属性 | 指定基础资料相关类型字段,还需要显示那些携带属性。前提在字段库中要先引用好。 | |
计算类型 | 用于确定字段类型,维度:是汇总依据的来源,数值:是汇总值的来源,参与计算:报表加载数据中,可以额外加载的字段,往往是中间大表的字段,需代码根据需要指定哪些字段需要,默认是不会自动加载的;舍弃:顾名思义,就是多余不要的字段。 | |
默认显示 | 开启后,在报表的汇总依据、汇总值选项中默认会选中。只有维度、数值类型字段可以设置。 | |
显示合计 | 开启后,代表该字段需要在报表下端的浮动汇总行显示合计数量。实际还受插件控制。 | |
数据隔离方式 | 数据规则权限指按用户在数据隔离组织下的基础资料数据规则权限隔离查询数据,业务数据控制指按数据控制策略隔离查询数据。 | |
数据控制策略 | 报表字段库对应字段的的数据控制策略。 | |
实体数据源配置 | 数据块状态 | 代表数据块是否可用,禁用则不加载。 |
数据描述 | 自定义描述,建议不要太长简要有区分度即可。 | |
来源类型 | 目前可选项就只有“实体”,不同的类型加载策略会不一样 | |
实体对象 | 数据来源的实体,目前也就只有单据、基础资料、余额表是有实际数据的。 | |
字段映射 | 定义实体对象和字段库字段是如何来映射的,报表在加载数据过程中会先找到字段库字段,转换到具体的单据进行加载。 | |
数据块过滤设置 | 这一行数据配置特有,且固定的过滤条件。基于实体对象字段来配置的。 | |
关联数据源配置 | 数据块状态 | 代表数据块是否可用,禁用则不加载。 |
数据描述 | 自定义描述,建议不要太长简要有区分度即可。 | |
关联实体配置 | 需选择一个关联实体配置。 | |
数据块过滤设置 | 这一行数据配置特有,且固定的过滤条件。基于字段库字段来配置的。 | |
插件配置 | 插件状态 | 代表插件是否可用,禁用则不加载。 |
插件类 | 需实现 kd.bplat.scmc.report.core.tpl.IReportDataHandle接口。 |
4.2 关键按钮说明
区域 | 按钮名称 | 详细解释 |
列表 | 新增/复制 | 新增数据或复制数据,同一报表可以有多个配置。 |
启用/禁用 | 启用禁用数据,同一报表实体,只能启用一个配置,启用会自动禁用。 | |
克隆配置 | 在需要二开修改配置时使用,点击操作会自动将整个数据源配置,及分录中引用的字段映射配置,关联实体配置都进下克隆一份,与原配置独立出来。编码会自动添加开发标识前缀。若有编码重复,可能导致克隆失败,要先处理好标识。 | |
删除 | 删除配置,系统预设的配置无法界面直接删除。 | |
详情 | 保存 | 略。 |
详情-报表字段配置 | 上移/下移 | 通过上下移,调整字段配置,将影响报表默认显示字段的顺序。但优先级低于报表界面小齿轮配置的顺序。 |
5 注意事项
报表具体能够实现哪些开发场景和扩展场景,这个需要根据具体业务和开发方案来具体评估。可以参考“供应链云>库存单据>报表分析”相关的报表。
5.1 调整配置
1)原厂发布的配置,二开不可直接调整,若需要二开调整,因采用克隆配置后,在调整,启用克隆配置。原厂逻辑与二开需求相差较大的,不建议克隆配置。新增配置可能更合适。
2)报表配置是一个静态的数据配置,与单据、数据库、环境配置等都相关,要做到按需配置。不合理的配置,可能导致报表运行时报错。具体情况需要具体分析(优先找业务报表所在领域负责人分析)。
3)所有配置调整,必须在开发或测试环境测试验证,后才可发布到生产环境。
5.2 超时时间
需要结合实际数据量来看,有些客户数据量确实太大,计算时长可能超过30分钟,可以适当放大。其他情况不建议调整。
5.3 报表字段配置
1)动调整字段库时,程序会重新根据字段库字段加载所有字段,依赖字段库的所有设置都会清空,要重新配置。
2)显示属性,有多个时,可以通过弹出框调整显示属性的顺序。
3)一个正常的报表,维度字段和数值字段,都只是有一个。
5.4 插件配置
建议控制插件的数量,原则上,原厂、行业、二开各一个插件,3个插件足够。避免出现一段逻辑配一个插件的情况。
变更记录
产品版本 | 更新内容 | 更新日期 |
V4.0.020 | 初始版本 | 2022年05月 |
V5.0.023 | 1、新增了显示合计的控制 2、新增了关联数据源配置 3、优化了编辑界面控制逻辑 | 2023年06月 |
V7.0.1 | 增加了数据隔离组织、数据隔离方式、数据控制策略,实现按业务数据关系和平台数据规则权限隔离数据 | 2024年10月 |
报表数据源配置
本文2024-09-22 23:48:09发表“云星瀚知识”栏目。
本文链接:https://wenku.my7c.com/article/kingdee-xinghan-135373.html